How xevrion/gyotaku works
gyotaku is an offline screenshot-text search application for Linux and Windows. Users choose screenshot folders, which the CLI indexer scans and watches; OCR extracts text and the core index makes it searchable. The desktop app searches that index and presents matching screenshots with highlighted text, while settings cover folders, appearance, shortcuts, and background indexing. The graph preserves these product stages and the documented platform-specific background behavior. Some internal indexing and UI details are unsampled, so those links are limited to documented relationships.
Main entry points: app.rs Search window · indexer.rs File indexer · lib.rs OCR pipeline · main.rs CLI commands
Components 23
Desktop search
- Search window
crates/app/src/app.rs - Search input
crates/app/src/input.rs - Results grid
crates/app/src/grid.rs - Screenshot display
crates/app/src/images.rs - Onboarding settings
crates/app/src/app/settings.rs - Folder discovery
crates/app/src/setup.rs - Keyboard shortcuts
crates/app/src/keys.rs - Theme
crates/app/src/theme.rs
Screenshot ingestion
- CLI commands
crates/cli/src/main.rs - File indexer
crates/cli/src/indexer.rs - Background watcher
crates/cli/src/watch.rs - OCR pipeline
crates/ocr/src/lib.rs - Text detection
crates/ocr/src/det.rs - Text recognition
crates/ocr/src/rec.rs - OCR models
crates/ocr/src/models.rs
Search engine
- Search index
crates/core/src/index.rs - Configuration
crates/core/src/config.rs - Index status
crates/core/src/status.rs - Trash handling
crates/core/src/trash/freedesktop.rs
Platform integration
- Desktop platform services
crates/app/src/platform/linux.rs - Indexer platform services
crates/cli/src/platform/mod.rs
Other components
- User
- Screenshot folders
Connections 26
- User → Search window: searches in
README.md - User → Onboarding settings: configures
README.md - Search window → Search input: uses
crates/app/src/app.rs - Search window → Results grid: renders
crates/app/src/app.rs - Search window → Screenshot display: renders
crates/app/src/app.rs - Search window → Keyboard shortcuts: uses
crates/app/src/app.rs - Search window → Theme: uses
crates/app/src/app.rs - Onboarding settings → Folder discovery: uses
crates/app/src/app/settings.rs - Onboarding settings → Configuration: saves settings
README.md - Folder discovery → Screenshot folders: suggests folders
crates/app/src/setup.rs - Search window → Search index: searches
- CLI commands → File indexer: runs indexing
crates/cli/src/main.rs - CLI commands → Background watcher: runs watcher
README.md - CLI commands → Search index: searches
crates/cli/src/main.rs - CLI commands → OCR pipeline: runs OCR
crates/cli/src/main.rs - Screenshot folders → File indexer: provides images
README.md - File indexer → OCR pipeline: extracts text
- OCR pipeline → Text detection: detects text regions
crates/ocr/src/lib.rs - OCR pipeline → Text recognition: recognizes text
crates/ocr/src/lib.rs - OCR pipeline → OCR models: loads models
crates/ocr/src/lib.rs - File indexer → Search index: stores extracted text
- Background watcher → File indexer: indexes new files
crates/cli/src/watch.rs - Background watcher → Indexer platform services: uses services
crates/cli/src/watch.rs - Onboarding settings → Desktop platform services: controls background service
crates/app/src/app/settings.rs - Search window → Desktop platform services: uses OS services
crates/app/src/platform/linux.rs - File indexer → Indexer platform services: sets idle priority
crates/cli/src/indexer.rs