meganekko

A fast, cross-platform image viewer with batch rename capabilities.

Features

• View images in multiple formats (JPEG, PNG, WebP, GIF including animated GIFs)
• Navigate through image directories with keyboard shortcuts or mouse
• Batch rename files with live preview
• Recursive directory scanning
• Read-only mode for safe viewing
• Sidebar with image list navigation
• Never upscales images beyond 100% of original size

Requirements

• Rust stable toolchain (for building)
• Platform-specific dependencies:
  • Linux: Wayland/X11, libxkbcommon, Vulkan
  • macOS: Native frameworks (automatically linked)
  • Windows: Native frameworks (automatically linked)

Building

With Cargo

# Development build
cargo build

# Optimized release build
cargo build --release

With Nix

# Build
nix build

# Enter development shell
nix develop

Running

# View images in current directory
cargo run

# View images in a specific directory
cargo run -- /path/to/images

# View specific image files
cargo run -- image1.jpg image2.png

# Disable recursive directory scanning
cargo run -- --no-recursive /path/to/images

# Read-only mode (disable rename)
cargo run -- --readonly /path/to/images

After building a release version:

./target/release/meganekko /path/to/images

Usage

Keyboard Shortcuts

• h / k / Left Arrow - Previous image
• l / j / Right Arrow - Next image
• r - Rename current image
• o - Open directory dialog
• Escape - Cancel rename (when renaming) or quit application

Renaming

1. Press r or click "Rename" to start renaming the current file
2. Type the new filename
3. Press Enter or click "Confirm" to rename
4. Press Escape or click "Cancel" to abort