README_EN.md

May 22, 2026 · View on GitHub

JarkViewer

JarkViewer

GitHub release Download Sourceforge License Platform DeepWiki DeepWiki

中文 | English

JarkViewer is a minimalist and lightning-fast image viewer that supports a vast array of image formats — from JPEG to the latest ones such as AVIF, HEIC, and JPEG XL! It even smoothly displays iOS Live Photos and Android Motion Photos.

Preview

✨ Controls

  1. ⏭ Switch: Click/Wheel on left/right window edges / Left/Right Arrow Keys
  2. 🔍 Zoom: Mouse wheel in window center / Up/Down Arrow Keys
  3. 🔄 Rotate: Click/Wheel on top-left or top-right window corners / Q/E Keys
  4. 🖱️ Panning: Mouse drag / W/A/S/D Keys
  5. ℹ️ EXIF Info: Click mouse wheel / TAB or I Key
  6. 🖥️ Fullscreen: Double-click window / F Key / F11 Key
  7. 📋 Copy Image: Ctrl + C
  8. 🖨 Print: Click on bottom-left window corner / Ctrl + P
  9. 🎞️ Browse Frames: Use top control bar / J: Previous Frame K: Pause/Resume L: Next Frame
  10. ⌨️ Space Key: If viewing a static image, switches to next image. If viewing an animation, toggles pause/play.
  11. ✂️ Split animation: Press Ctrl + S to save each frame of the animation as a separate still image file.

🖨 Print/Edit

The print function allows simple adjustments to image contrast, brightness, inversion, etc., before deciding to Save As another image file or Continue Printing.

You can also select color modes: Color, Gray, Document, Dithering.

  1. Document: Balances overall brightness, highlights text, and avoids the visual impact of local shadows. Suitable for printing images of photographed text documents.
  2. Dithering: Simulates pixel grayscale values using the distribution density of pure black pixels. This mode is suitable for dot-matrix and thermal printers and can also produce good image results.

printerPreview

🗃️ Features

  1. 🍀 Fully static linking compilation, native portable single file
  2. ✅ Automatically remembers last window position/size
  3. ♟️ Chessboard background for image transparent areas
  4. 📖 Supports reading prompt parameter information from open-source AI-generated images. Images output by StableDiffusion WebUI and ComfyUI typically contain embedded prompt parameters or workflow JSON. However. ⚠ if the images are re-encoded through circulation on various online platforms, this information may be removed.

📂 Format Support

  • Static: apng avif avifs blp bmp dib exr gif hdr heic heif ico icon jfif jp2 jpe jpeg jpg jxl jxr livp pbm pfm pgm pic png pnm ppm psd pxm qoi ras sr svg tga tif tiff webp wp2
  • Animated: gif webp png apng jxl avif
  • Live: livp (IOS LivePhoto) jpg/heic/heif (Android MicroVideo/MotionPhoto) ⚠️ Audio not supported yet
  • RAW: 3fr ari arw bay cap cr2 cr3 crw dcr dcs dng drf eip erf fff gpr iiq k25 kdc mdc mef mos mrw nef nrw orf pef ptx r3d raf raw rw2 rwl rwz sr2 srf srw x3f

👋 Quick Start

  1. Download the latest version at Releases, Lanzou Cloud, or Baidu Cloud (extraction code: 6666).

  2. Install by winget

winget install jark006.jarkviewer
  1. Install by scoop
scoop bucket add extras
scoop install extras/jarkviewer

⚠️ Note: If startup reports missing VCOMP140.DLL or similar, please download and install the VC++ runtime: vc_redist.x64.exe. Since v1.35, JarkViewer no longer depends on the VC++ Runtime and can run directly in PE environments. If you still encounter related errors, please make sure you downloaded the correct version of the program.

🖥️ System Compatibility

✅ Supports 64-bit Windows 10 ~ 11. (The project uses MSVC v145 toolset and only guarantees compatibility with Win 10+)

⚠️ Currently tested to run stably on 64-bit Win 8/8.1, but future versions are not guaranteed to remain compatible.

❌ Not compatible with 32-bit Win 7 and earlier systems.

🛠️ For Developers

When cloning the repository source code, only the latest commit is necessary as historical commits contain many space-consuming redundant files.

git clone git@github.com:jark006/JarkViewer.git --depth=50

⭐️ It is recommended to visit the DeepWiki or Zread page of this project, which has more detailed explanations and development-related content, and can help you quickly understand the implementation logic of each module.

This project is developed using Visual Studio 2026, with all third-party libraries statically linked. Developers need to prepare all third-party static library files before compilation. Please download the corresponding version of the third-party static library archive from the link below and extract it to the specified location according to the instructions.

Static Library Download: https://github.com/jark006/JarkViewer/releases/tag/static_lib

With the exception of OpenCV, the static libraries above were copied from libraries installed via vcpkg. The following 2 modifications were made to OpenCV:

  1. In source file opencv-4.13.0\modules\imgcodecs\src\loadsave.cpp lines #68-79, removed the image resolution limit.
  2. In source file opencv-4.13.0\modules\highgui\src\window_w32.cpp line #337, changed IDC_CROSS to IDC_ARROW, i.e., not using a crosshair cursor inside cv::imshow() windows.

If you prefer not to use the above static libraries, you can enable vcpkg support in the project properties and manually install the third-party libraries. (This list may not be updated promptly if new dependencies are added later; developers may need to install additional packages based on compilation error messages.)

vcpkg install x265:x64-windows-static
vcpkg install zlib:x64-windows-static
vcpkg install libyuv:x64-windows-static
vcpkg install exiv2[core,bmff,png,xmp]:x64-windows-static
vcpkg install libavif[core,aom,dav1d]:x64-windows-static
vcpkg install libjxl:x64-windows-static
vcpkg install libheif[core,hevc]:x64-windows-static
vcpkg install libraw[core,dng-lossy,openmp]:x64-windows-static
vcpkg install lunasvg:x64-windows-static
vcpkg install directxtex:x64-windows-static
vcpkg install ffmpeg:x64-windows-static
vcpkg install opencv4[core,contrib,freetype,ipp,jasper,jpeg,jpegxl,nonfree,openexr,opengl,openjpeg,png,tiff,webp,world]:x64-windows-static

📜 License

This project is open-sourced under the GPL-3.0 License. For more details, see the LICENSE file.