Sukusho (スクショ)

A powerful screenshot manager for Windows with AI-powered semantic search. Lives in your system tray, inspired by Screenie for macOS.

• System Tray Integration - Runs quietly in your system tray, always ready when you need it
• Global Hotkey - Toggle the window with a customizable keyboard shortcut (default: Ctrl+Shift+S)
• GPU-Accelerated UI - Built with GPUI (Zed's UI framework) for smooth, responsive performance
• Thumbnail Gallery - Beautiful grid view with adjustable thumbnail sizes and infinite scroll
• Drag & Drop - Drag screenshots directly into other applications
• Multi-Select - Select multiple items with checkboxes, Ctrl+Click, or Shift+Click
• Native Context Menu - Right-click for Windows shell context menu (Open, Copy, Delete, etc.)
• Clipboard Support - Copy selected files with Ctrl+C

• Auto-Organizer - Automatically organize screenshots into date-based folders
• Customizable Format - Choose your own date format (YYYY-MM-DD, YYYY/MM/DD, etc.)
• Manual Organization - Organize existing screenshots with progress tracking

• Auto-Convert - Automatically convert PNG screenshots to WebP or JPEG to save space
• Quality Control - Adjustable compression quality (1-100)
• Batch Convert - Convert multiple existing files at once

• Semantic Search - Find screenshots by describing what's in them (e.g., "cat", "sunset", "code")
• 100% Local Processing - All AI runs on your machine, no internet connection needed after model download
• Fast & Private - Uses prewarmed models for instant results, your screenshots never leave your PC
• Vector Database - Powered by LanceDB for efficient similarity search
• Auto-Indexing - New screenshots are automatically indexed for search

# Clone the repository
git clone https://github.com/ssut/sukusho.git
cd sukusho

# Build release version
cargo build --release

# Run
./target/release/sukusho.exe

• Windows 10/11
• Rust 1.75+ (uses edition 2024)

• Click checkbox - Toggle selection (multi-select)
• Click item - Select single item
• Ctrl+Click - Add/remove from selection
• Shift+Click - Range selection

Select one or more screenshots and drag them directly into:

• File Explorer
• Email clients
• Chat applications (Slack, Discord, etc.)
• Image editors
• Any application that accepts files

Access settings by clicking the gear icon (⚙) in the header.

• Screenshot Directory - Folder to watch for new screenshots
• Thumbnail Size - Adjust grid thumbnail size (80-300px)
• Grid Columns - Adjust number of columns in gallery view

• Enable Auto-Organize - Automatically organize new screenshots into date-based folders
• Date Format - Choose your preferred folder naming format (YYYY-MM-DD, YYYY/MM/DD, etc.)
• Organize Existing - Manually organize all existing screenshots with progress tracking

• Auto-convert Screenshots - Automatically convert new PNG files
• Conversion Format - Choose WebP or JPEG
• Quality - Image quality (1-100)
• Batch Convert - Convert all existing PNG files at once

• Enable Image Indexing - Turn on AI-powered semantic search
• Download Models - First-time setup downloads ~150MB of AI models (one-time)
• CPU Mode - Choose between Normal (balanced) or Fast (max performance)
• Manual Indexing - Index all existing screenshots or just new ones
• Search - Use the search bar at the top to find screenshots by describing their content

Privacy Note: All AI processing happens locally on your machine. No screenshots or data are sent to external servers. After initial model download, no internet connection is required.

• Enable Global Hotkey - Toggle hotkey functionality
• Current Hotkey - View/record new hotkey combination

Settings are stored in:

%APPDATA%\sukusho\settings.json

Default screenshot directory:

%USERPROFILE%\Pictures\Screenshots

Run with console output for debugging:

sukusho.exe --console

Logs are written to sukusho_debug.log in the current directory.

• GPUI - GPU-accelerated UI framework from Zed
• gpui-component - UI component library
• tray-icon - System tray support
• global-hotkey - Global keyboard shortcuts
• notify - File system watching
• image - Image processing

# Debug build
cargo build

# Release build (optimized)
cargo build --release

# Run tests
cargo test

MIT License - see LICENSE for details.

• Inspired by Screenie for macOS
• Built with GPUI by the Zed team
• UI components from gpui-component