Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 

Repository files navigation

Image Viewer

A fast, minimal image viewer for Linux, distributed as an AppImage.

Installation

Just download the Image Viewer-1.0.0.AppImage Change it's Properties to make it executable

Features

  • Supports JPEG, PNG, GIF, WebP, BMP, SVG, TIFF, ICO, AVIF
  • Smooth zoom with scroll wheel or keyboard shortcuts
  • Click and drag to pan
  • Folder navigation — browse all images in the same folder
  • Drag and drop to open images
  • Full-screen mode
  • Dark theme

Keyboard Shortcuts

Key Action
/ Previous / Next image
Ctrl++ / Ctrl+- Zoom in / out
Ctrl+0 Fit to window
Ctrl+1 Actual size (100%)
F11 Toggle fullscreen
Ctrl+O Open image file
Ctrl+Shift+O Open folder
Esc Exit fullscreen

Double-click the image to toggle between actual size and fit-to-window.

Build Requirements

  • Node.js 18+ and npm
  • Linux x64 (for AppImage output)

How to Build

# 1. Enter the image-viewer directory
cd image-viewer

# 2. Install dependencies
npm install

# 3. Build the AppImage
npm run build

The AppImage will be placed in image-viewer/dist/Image Viewer-1.0.0.AppImage.

Run Without Building

cd image-viewer
npm install
npm start

Usage

# Run the AppImage directly (no install needed)
chmod +x "Image Viewer-1.0.0.AppImage"
./"Image Viewer-1.0.0.AppImage"

# Open a specific file
./"Image Viewer-1.0.0.AppImage" /path/to/photo.jpg

# (Optional) Integrate into your desktop environment
./"Image Viewer-1.0.0.AppImage" --appimage-install

Supported Formats

Format Extension
JPEG .jpg, .jpeg
PNG .png
GIF .gif
WebP .webp
BMP .bmp
SVG .svg
TIFF .tiff, .tif
ICO .ico
AVIF .avif

Releases

Packages

Contributors