Slideshow Rated

A Tauri desktop application that displays local images in a weighted random slideshow with a 1-5 star voting system. Higher-rated images appear more frequently.

Features

• Scans directories for images: data/, pics/, pictures/, images/, photos/
• Weighted random selection - higher votes = more likely to appear
• SQLite database stored in working directory (slideshow.db)
• Portable - run from different directories for separate image collections
• Dark theme UI with minimal distractions

Keyboard Controls

Key	Action
Space / ← / →	Next image immediately
1-5	Vote current image (1-5 stars)
↓ / -	Decrease delay (min 1s)
↑ / = / +	Increase delay (max 30s)
D	Delete current image (file and database entry)
?	Toggle help overlay
Esc / Q	Close app

Requirements

• Bun (or Node.js with npm)
• Rust
• Tauri v2 prerequisites (see Tauri docs)

Installation

bun install

Usage

Development

bun run dev

Production Build

bun run build

The built application will be in src-tauri/target/release/.

How It Works

1. On startup, the app scans for images in supported directories
2. Images are stored in a local SQLite database with their vote counts
3. The slideshow uses weighted random selection:
   • Unvoted images: weight 1
   • Voted images: weight = 1 + vote (so vote 5 = weight 6)
4. Votes persist across sessions in slideshow.db

Project Structure

slideshow-rated/
├── src/                  # Frontend (TypeScript + HTML + CSS)
│   ├── index.html
│   ├── main.ts
│   └── style.css
├── src-tauri/            # Rust backend
│   ├── src/
│   │   ├── main.rs       # Entry point
│   │   ├── db.rs         # SQLite operations
│   │   ├── scanner.rs    # Image discovery
│   │   └── commands.rs   # Tauri IPC commands
│   └── Cargo.toml
└── package.json

Supported Image Formats

• JPEG (.jpg, .jpeg)
• PNG (.png)
• GIF (.gif)
• WebP (.webp)
• BMP (.bmp)

License

MIT