How mrtytanic/hakoto works
Hakoto is a local-first desktop catalog for physical music collections. Users manage albums and wishlist entries, organize owned albums into crates or virtual shelves, and review collection statistics; profile and display preferences personalize the workspace. Collection data and artwork remain local, with CSV portability and backup/restore. The React interface invokes a Tauri/Rust backend, which provides domain operations and local persistence. README capability descriptions support several unsampled branches; their specific frontend-to-backend wiring is not established by the excerpts, so those links are dashed and uncited.
Main entry points: App.tsx App shell · lib.rs Tauri commands · storage.rs Local storage · database.rs Album operations
Components 27
Desktop workspace
- App shell
src/App.tsx
Collection organization
- Album collection
src/pages/Collection.tsx - Album editing
src/components/albumdetails/AlbumDetails.tsx - Artwork handling
src/artwork.ts - Custom crates
src/pages/Crates.tsx - Virtual shelves
src/pages/Shelves.tsx - Shelf layout
src/components/ShelfGrid.tsx - Shelf arrangement
src/shelfArrangement.ts - Drag placement
src/useShelfDrag.ts - Favorites and wishlist
src/pages/Favorites.tsx
Insights and preferences
- Collection statistics
src/pages/Statistics.tsx - Profile settings
src/pages/Settings.tsx - Display preferences
src/settings.ts
Data portability
- CSV transfer
src/components/CollectionCsv.tsx - Backup and restore
src/components/CollectionBackup.tsx
Native services
- Tauri commands
src-tauri/src/lib.rs - Album operations
src-tauri/src/database.rs - Crate operations
src-tauri/src/crates.rs - Shelf operations
src-tauri/src/shelves.rs - Profile operations
src-tauri/src/profile.rs - Artwork storage
src-tauri/src/artwork.rs - Local storage
src-tauri/src/storage.rs - Metadata logic
src-tauri/src/metadata.rs - Undo operations
src-tauri/src/undo.rs - CSV service
src-tauri/src/collection_csv.rs - Backup service
src-tauri/src/backup.rs
Other components
- Collector
Connections 37
- Collector → App shell: uses
- App shell → Album collection: routes to
src/App.tsx - App shell → Custom crates: routes to
src/App.tsx - App shell → Virtual shelves: routes to
src/App.tsx - App shell → Favorites and wishlist: routes to
src/App.tsx - App shell → Collection statistics: routes to
src/App.tsx - App shell → Profile settings: routes to
src/App.tsx - App shell → Display preferences: applies
src/App.tsx - Album collection → Album editing: opens
src/pages/Collection.tsx - Album editing → Artwork handling: encodes
src/components/albumdetails/AlbumDetails.tsx - Virtual shelves → Shelf layout: renders
src/pages/Shelves.tsx - Shelf layout → Shelf arrangement: uses
src/components/ShelfGrid.tsx - Shelf layout → Drag placement: supports placement
- Drag placement → Shelf arrangement: uses
src/useShelfDrag.ts - Album collection → Tauri commands: invokes
src/pages/Collection.tsx - App shell → Tauri commands: invokes
src/App.tsx - Tauri commands → Album operations: dispatches
src-tauri/src/lib.rs - Tauri commands → Crate operations: dispatches
src-tauri/src/lib.rs - Tauri commands → Shelf operations: dispatches
src-tauri/src/lib.rs - Tauri commands → Profile operations: dispatches
src-tauri/src/lib.rs - Tauri commands → CSV service: dispatches
src-tauri/src/lib.rs - Tauri commands → Backup service: dispatches
src-tauri/src/lib.rs - Album operations → Local storage: persists in
src-tauri/src/database.rs - Crate operations → Local storage: persists in
src-tauri/src/storage.rs - Shelf operations → Local storage: persists in
src-tauri/src/shelves.rs - Profile operations → Local storage: persists in
src-tauri/src/profile.rs - Artwork storage → Local storage: uses
src-tauri/src/artwork.rs - Album operations → Metadata logic: uses
src-tauri/src/database.rs - Crate operations → Metadata logic: uses
src-tauri/src/crates.rs - Album operations → Undo operations: supports undo
src-tauri/src/database.rs - App shell → CSV transfer: offers transfer
- App shell → Backup and restore: offers backup
- CSV transfer → CSV service: transfers data
- Backup and restore → Backup service: backs up
- App shell → Favorites and wishlist: supports favorites
src/App.tsx - App shell → Collection statistics: shows insights
src/App.tsx - App shell → Profile settings: personalizes
src/App.tsx