Tauri SD Image Viewer

English🌐 | 日本語🇯🇵

A desktop image viewer application built with Tauri v2, specialized for viewing and managing images with Stable Diffusion metadata.

Download

See Releases page for downloads.

Screenshots

Single Image View

View images with detailed metadata including Stable Diffusion parameters.

Grid View

Browse images in a thumbnail grid with a rating system.

🚧 SD tag filtering is Work in Progress 🚧

Features

• Image Viewing: PNG format supported
• Stable Diffusion Metadata: Extract and display SD parameters from generated images
• Rating System: Rate images with star ratings (writes to XMP metadata, not EXIF)
• Keyboard Navigation: Use ←→ keys to navigate images, 1~5 to rate
• Thumbnail Grid: Browse images in a grid layout
• SD Tag Filtering: Filter images by Stable Diffusion tags 🚧 Work in Progress 🚧
• Cross-Platform: Works on macOS and Windows

Technology Stack

• Application Build: Tauri v2, Bun
• Frontend: Svelte 5 (SvelteKit), TypeScript, Tailwind CSS 4, DaisyUI
• Backend: Tauri v2 (Rust)

Development

Prerequisites

• Bun - JavaScript runtime and package manager
• Rust - Required for Tauri backend
• Build Tools for Visual Studio - Windows only, required for XMP libraries

Getting Started

1. Clone the repository:

git clone https://github.com/tenpaMk2/tauri-sd-image-viewer2.git
cd tauri-sd-image-viewer2

2. Install dependencies:

bun install

3. Start development server:

bun run tauri:dev

Build Commands

• bun run tauri:dev - Start development server (frontend + Tauri app)
• bun run tauri:build - Build production Tauri app
• bun run dev - Start frontend-only development server
• bun run build - Build frontend only
• bun run check - Run TypeScript type checking
• bun run format - Format code with Prettier

Recommended Development Flow

1. Start development: bun run tauri:dev
2. Make changes to the code
3. Run type checking: bun run check
4. Format code before commit: bun run format

Image Format Support

Format	Features
PNG	Full support: SD metadata, XMP rating writing
JPEG	🚧 Work in Progress 🚧
WebP	🚧 Work in Progress 🚧

License

MIT License - see LICENSE file for details.

Contributing

Issues and pull requests are welcome on GitHub.

TODO

• Add custom icons for SD tags
• SD tag filtering
• Auto-reload in Grid view
• Prioritized thumbnail & metadata loading in Grid view
• Start thumbnail creation from Viewer
• Check and discard unnecessary thumbnails when directory is updated
• JPEG and WebP support
• Start auto navigation with l (Last)