A fast, borderless image and video viewer for Windows. Open media instantly, navigate large folders without waiting, and read long image sequences in a continuous strip or a dense multi-column grid. It is not a photo manager, editor, or cataloger — it does one thing and tries to do it well.
floating.webm
masonry.webm
longstrip.webm
transition.webm
- Borderless floating window with a custom title bar, auto-hiding controls, and smooth fullscreen transitions.
- Multi-monitor aware: maximization, DPI scaling, and window dragging all do the right thing across displays.
- Two fullscreen multi-item layouts: Long Strip (continuous vertical scroll) and Masonry (dense grid).
- Fast folder navigation with natural sort, single-instance reuse, and drag-and-drop support.
- Animated GIF, animated WebP, and video playback in the same window — no switching apps.
- Hardware-accelerated video decoding on Windows (D3D12 / D3D11 / CUDA) with automatic fallback to software if a hardware decoder wedges.
- Dedicated Stash window to collect, filter, preview, and organize marked files across folders.
- Full Undo / Redo (
Ctrl+Z,Ctrl+Y) for file deletions, renames, and stash operations with confirmation dialogs. - Tabbed, searchable Settings window with live preset management and reset-to-defaults.
- Dual release builds: AVX2 (default, every Windows 11 machine) and SSE4.2 (
-legacy, for older CPUs). - Persistent metadata cache so the second time you open a folder is noticeably faster than the first.
| Format | Extensions |
|---|---|
| JPEG | .jpg, .jpeg |
| PNG | .png |
| WebP | .webp |
| GIF | .gif |
| BMP | .bmp |
| PSD | .psd |
| ICO | .ico |
| TIFF | .tiff, .tif |
| Format | Extensions |
|---|---|
| MP4 | .mp4 |
| MKV | .mkv |
| WebM | .webm |
| AVI | .avi |
| QuickTime | .mov |
| WMV | .wmv |
| FLV | .flv |
| M4V | .m4v |
| 3GP | .3gp |
| OGV | .ogv |
Grab the latest installer or portable executable from the Releases page.
| Version | CPU Target | Supported Processors | Files |
|---|---|---|---|
| Standard | AVX2 (x86-64-v3) |
Intel 4th Gen+ (2013+), AMD Ryzen+ (all Win 11 PCs) | *-setup.exe (bundled)*-setup-no-gstreamer.exerust-image-viewer.exe (portable) |
| Legacy | SSE4.2 (x86-64-v2) |
Older CPUs lacking AVX2 (Intel 1st–3rd Gen, AMD FX) | *-setup-legacy.exe (bundled)*-setup-no-gstreamer-legacy.exerust-image-viewer-legacy.exe (portable) |
Bundled installers include GStreamer for out-of-the-box video playback. Use -no-gstreamer or portable .exe if GStreamer is already installed.
This project is built by a solo developer without an expensive code-signing certificate, so Windows may show a "Windows protected your PC" warning on first run. That is a standard Mark-of-the-Web notice for unsigned downloads, not an indication of malware.
To unblock:
- Right-click the downloaded file → Properties.
- On the General tab, find the Security section at the bottom.
- Check Unblock, then click Apply and OK.
- Run the installer normally.
Image viewing works out of the box. Video playback requires GStreamer:
- Download GStreamer from https://gstreamer.freedesktop.org/download/.
- Install the 64-bit MSVC runtime package.
- The bundled installer handles this for you automatically.
D3D12 and CUDA decode paths are opportunistic — if the runtime or GPU drivers are unavailable the app falls back to D3D11 or software decode without any configuration.
Requirements: Windows 10/11, Rust 1.99+, Visual Studio Build Tools (MSVC / C++), and GStreamer MSVC runtime + development packages.
git clone https://github.com/cosmokud/rust-image-viewer.git
cd rust-image-viewer
cargo build --releaseSet PKG_CONFIG_PATH if GStreamer is not auto-detected:
$env:PKG_CONFIG_PATH = "C:\gstreamer\1.0\msvc_x86_64\lib\pkgconfig"The binary lands at target/release/rust-image-viewer.exe.
rust-image-viewer.exe path\to\file.jpg
rust-image-viewer.exe path\to\video.mp4Opening one file builds the media list for its entire folder and enables previous/next navigation across all supported files in that folder. Launching without a path opens a window ready for drag-and-drop.
- Floating — single-item preview, resizable and borderless.
- Solo fullscreen — one item, full screen.
- Long Strip — continuous vertical scroll through the whole folder, great for reading manga or image sequences.
- Masonry — multi-column grid for browsing dense folders.
- Stash — standalone gallery window for reviewing, filtering, and organizing marked files across folders.
Switch between Long Strip and Masonry with the mode buttons in the bottom-right corner while fullscreen.
- Left-click drag pans the current view.
- Right-click on a side zone or black bar navigates previous/next.
- Middle-click starts freehand autoscroll.
- Space marks the hovered item; Ctrl+Left-click toggles the mark.
- In Long Strip or Masonry, right-click on an item opens it in solo fullscreen.
- Ctrl+Z / Ctrl+Y confirms undo and redo for deletes, renames, and stash changes.
Keybindings are context-aware across floating, solo fullscreen, Long Strip, and Masonry modes, with customizable bindings in config.ini. See Shortcuts for the full default binding table.
Settings are stored in %APPDATA%\rust-image-viewer\config.ini on Windows. See Configuration for all options, defaults, and tuning parameters.
Toggle with show_fps = true in config.ini to monitor render FPS, queue depths, latencies, and cache hit rates. See Diagnostics Overlay for metric definitions.
Solutions for common issues regarding video playback (GStreamer), config resets, cache clearance, crash logs, and build errors. See Troubleshooting.
See ARCHITECTURE.md for the full design overview.
MIT. See LICENSE.
Dependencies carry their own licences. THIRD-PARTY.md lists every dependency grouped by licence with copyright holders; full licence texts are in LICENSES/.