A native Android browser and shuffle picker for a Discogs collection. Discogs custom collection folders are treated as physical record locations/shelves.
Download · Website · Changelog · Release guide · Report a problem
- Select one or more Discogs collection folders
- Browse by artist or album title
- Search artist, album, label, or genre
- Shuffle within the selected folder
- Move an album between existing Discogs collection folders
- Select and move multiple physical album instances with confirmation and progress
- Kiosk-friendly 60-second idle mosaic with a continuously scrolling wall of album covers
- Compact, non-scrolling album detail screen
- One-time personal-token setup, encrypted with Android Keystore
- Cogsworth launcher icon with in-app creator attribution
Open this directory in a current Android Studio installation, let Gradle sync, and run the app configuration on an Android 8.0+ device or emulator. The project targets Android API 37.
On first launch, enter the Discogs username and a personal access token created under Discogs Settings → Developers. The app reads collection data and performs authenticated write operations only when moving albums between folders. Custom folders are shown; Discogs' generated “All” folder is intentionally omitted.
The app currently keeps fetched releases in memory for fast local sort/search/shuffle. A future offline-first release should add a Room cache and periodic WorkManager sync. For distribution to other account owners, replace personal-token setup with Discogs OAuth 1.0a.
Cogsworth uses semantic versioning. The current public release is 0.1.1. Patch releases increment automatically for compatible changes; major and minor version changes are chosen by the project owner.
This project contains code generated with assistance from OpenAI Codex. AI-generated contributions may contain errors or unexpected behavior and should be independently reviewed, tested, and validated before production use.