Skip to content

README.md

Latest commit

Β 

History

History
121 lines (89 loc) Β· 3.83 KB

README.md

File metadata and controls

121 lines (89 loc) Β· 3.83 KB
RePic Logo

RePic

Re:define how you see pictures.

Download Platform License

Website Β· Story Β· 繁體中文

What is RePic?

RePic is a desktop image viewer and manager that rethinks how images are stored and organized.

Instead of downloading every image to your hard drive, RePic introduces Virtual Albums β€” collections of web images that take zero disk space. When you need real files, pin them to disk as .repic shortcut files (under 1 KB each).

The core idea

Traditional:  Save image β†’ 5 MB on disk β†’ one copy per device
RePic:        Drag image β†’ 0 KB (virtual) or <1 KB (.repic) β†’ URL stays in the cloud

Features

Virtual Albums β€” 0 KB

Drag images from any website into RePic. No downloads, no disk usage β€” just URLs stored in memory. Browse, crop, and annotate them as if they were local files.

.repic Files β€” Pin to Disk

Want real files? Pin an album to create .repic shortcut files visible in File Explorer. Each file is a tiny JSON with the image URL β€” shareable, backupable, double-click to open.

{
  "v": 2,
  "type": "virtual-image",
  "url": "https://example.com/photo.jpg",
  "crop": { "x": 120, "y": 80, "width": 640, "height": 480 }
}

Local β†’ Cloud Virtualization

Upload a local image to the cloud, then convert it to a .repic file. 5 MB photo becomes a 0.5 KB shortcut β€” 99.99% space savings with the same visual result.

Everything Else

  • Blazing fast browsing β€” Virtual scrolling + thumbnail preloading
  • Non-destructive editing β€” Crop, annotate, mosaic without touching originals
  • Drag to share β€” Drag images straight to Discord, LINE, or any app
  • Clipboard paste β€” Ctrl+V to import screenshots instantly
  • Hotlink bypass β€” Automatic proxy for protected images (Instagram, etc.)
  • Dark & light themes β€” iOS-inspired UI
  • i18n β€” English / Traditional Chinese

Getting Started

Download

Grab the latest installer from Releases.

Requirements: Windows 10 or later.

Development

# Install dependencies
npm install

# Run in development mode
npm run electron:dev

# Build for Windows
npm run electron:build

Output: release/ folder with NSIS installer.

Tech Stack

Layer Technology
Runtime Electron 31
Frontend React 19 + Vite 7
Styling TailwindCSS v4
Image processing Sharp
Cropping react-image-crop
Virtual scrolling react-window

Roadmap

  • Virtual albums (0 KB web image collections)
  • .repic file format v2 (read, write, batch export)
  • Non-destructive crop & annotations
  • Cloud upload (urusai.cc)
  • Album import/export (JSON backup)
  • Sidebar position toggle
  • Thumbnail cache (IndexedDB)
  • Offline image cache
  • Pin album to disk (auto-create .repic folder)
  • Unpin album (read back to virtual)
  • Local image β†’ cloud β†’ .repic virtualization
  • Batch virtualize / materialize
  • File Explorer shell extension (Windows)

Contributing

Found a bug or have an idea? Open an issue β€” every report is read.

License

MIT