Native Android companion for Crate, a personal physical media cataloguing app for Nextcloud.
100 % AI-written. Every line of source, every test, every CI workflow, this README, and almost every commit message in this repository was written by Claude Code under direction from a human reviewer. No code in this repository was hand-typed.
Screenshots above were captured on the previous copper-themed build (v1.2 and earlier). The current build (v1.4.0+) uses Nextcloud's brand blue throughout to sit alongside the official Nextcloud client suite.
Released — v1.4.0. Signed APKs are published on the Releases page.
There's a manual Check for updates button under Settings → About that polls GitHub for newer releases on demand and posts a notification linking to the release page if one is available. The app does not check for updates on launch — F-Droid policy forbids unsolicited third-party network calls at startup, and the app behaves the same way regardless of where you installed it from.
- Home feed — Item of the Day, Recently Added, Most Valuable, and per-category recent items
- Collection browsing — card or list view, with category tabs (Music, Films, Books, Games, Comics) and format-filter chips that surface per-format counts ("LP (12)", "CD (4)") and a total
- Add & edit items — full form with category-specific formats, year, barcode, label, original purchase price + currency, and artwork
- Barcode scanning — scan barcodes with the camera (ZXing, no Google Play Services)
- External metadata search — Discogs (music), TMDB (films), Open Library (books), RAWG (games), ComicVine (comics)
- Artwork — pick artwork from your device or pull it from external search results
- User photo slots — two extra photos per item alongside the artwork (receipts, sleevenotes, disc shots). EXIF/GPS metadata is stripped client-side before upload
- Original price tracking — record what you originally paid and see gain/loss against the current market value on each item
- Playlists — create, edit, and delete playlists; add/remove items
- Search — search your own collection or external sources
- Sharing — share collections with other Nextcloud users; view collections shared with you
- Offline support — full offline cache with Room; background delta sync via WorkManager
- Owned / Wanted — track items you own vs. items on your wishlist
- Nextcloud-blue Material 3 — themed in Nextcloud's brand colours so the app sits visually alongside the official Nextcloud client suite
- Android 10 (API 29) or newer
- A Nextcloud instance running the Crate server app
Download the latest signed APK from the Releases page and install it. You will need to allow "install from unknown sources" for your browser the first time.
Subsequent updates install in place over the existing app. Use Settings → About → Check for updates when you want to see if a newer version is published.
F-Droid submission is in progress; once it lands you'll be able to install and update via F-Droid as well.
- Kotlin 2.x + Jetpack Compose + Material 3 (Nextcloud-blue palette)
- Hilt for dependency injection
- Retrofit 2 + OkHttp 5 + kotlinx.serialization
- Room for offline cache, with versioned migrations + instrumented
MigrationTestHelpercoverage - Coil 3 for image loading
- ZXing for barcode scanning (F-Droid friendly — no Google Play Services dependency)
- WorkManager for background delta sync
- DataStore Preferences for app-side settings
./gradlew assembleDebug
Debug APK is written to app/build/outputs/apk/debug/.
For signed release builds, see docs/SIGNING.md. The F-Droid recipe mirror lives at docs/fdroid/com.megamaced.crate.yml.
AGPL-3.0-or-later — same as the Crate server app and Nextcloud itself.