GNEDBY

A CLI tool for managing your CD/LP collection. Easily add album information using Apple Music links, view lists and summary reports with various filters, and support synchronization using Supabase.

Features

• Add music albums using Apple Music album IDs
• Automatic album metadata fetching (artist, album title, genre, release date, country, artwork)
• CD/LP format support (--format lp flag)
• List view and summary reports with various filters
• Local persistent storage using SQLite
• Token storage with encryption
• Synchronization with Supabase (check/push/pull)
• Automatic synchronization when adding new albums (optional)
• Removal of albums from your collection

Installation

cargo install gnedby

Usage

Adding Albums

gnedby add <album_id> [--format lp]

Deleting Albums

gnedby delete <id>

Viewing Albums

gnedby show [--year <YYYY>] [--artist <name>] [--genre <genre>] [--format <CD|LP>] [--country <country>] [--order-by id|album|artist|year]

Generating Reports

gnedby report [--year] [--artist] [--genre] [--format] [--country]

Synchronization

gnedby sync check
gnedby sync pull
gnedby sync push

Configuration

gnedby sync config show
gnedby sync config set storage_url <supabase_url>
gnedby sync config set token <supabase_token>
gnedby sync config set auto_sync true|false
gnedby sync config reset

Sync Setup

Use Supabase Storage for safe synchronization across multiple devices.

1. Create a bucket in Supabase Storage:

   • Log in to Supabase dashboard
   • Go to Storage and create a new bucket named gnedby-sync
   • Configure appropriate bucket policies (for service_role access)

2. Configure sync settings:

gnedby sync config set storage_url https://your-project-id.supabase.co/storage/v1/object/gnedby-sync

gnedby sync config set token eyJhbGc...your-token

gnedby sync push

3. On other devices, configure the same settings and use gnedby sync pull to get your data.

4. Enable automatic synchronization (optional):

gnedby sync config set auto_sync true

With automatic synchronization enabled, any newly added or deleted albums will be automatically pushed to your Supabase storage. This ensures your collection is always backed up without manual intervention.

Security Features

• Tokens are stored with XOR encryption using a machine-specific key
• Database backups are created automatically before sync operations
• Integrity checking with SHA-256 hashes

Tech Stack

• Rust
• clap (CLI parsing)
• rusqlite (database)
• reqwest (HTTP requests)
• base64 and SHA-256 (token encryption)
• Supabase Storage (synchronization)

License

MIT License