A personal physical media cataloguing app for Nextcloud. Track your music, films, books, games and comics — what you own, what you want, and what they're worth — on a server you control.
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.
| Books | Comics | Films |
|---|---|---|
![]() |
![]() |
![]() |
| Games | Music | Playlists |
|---|---|---|
![]() |
![]() |
![]() |
Rich, category-aware detail with auto-fetched metadata, tracklists, market values, and per-item actions (re-enrich, refresh market rate, share, edit, add to playlist). Bulk-add an existing collection by uploading a CSV or XLSX.
| Music detail | Game detail | Import |
|---|---|---|
![]() |
![]() |
![]() |
- Five categories — Music, Films, Books, Games, Comics — each with category-appropriate fields, search providers, and detail views
- Add by barcode for music (Discogs) and books (Open Library), or by external search for films (TMDB), games (RAWG) and comics (ComicVine)
- Auto-enrichment pulls full metadata, artwork, tracklists, artist bios and pressing notes. Film titles and overviews come in your Nextcloud language when TMDB has a translation, otherwise in English. Book searches prefer an edition in your language, then an English one
- Market values for music (Discogs price suggestions) and games / comics (PriceCharting), with multi-currency support
- Wishlist alongside your owned collection
- Star ratings from one to five, to sort and group your collection by
- Playlists — mixed-category groups of items
- Sharing with other users on the same Nextcloud instance
- CSV / XLSX import and export, including importing a Discogs collection export as it is
- A native Android companion app
- Nextcloud 29 – 35
You provide your own — they live encrypted in your Nextcloud credential store and never leave your server. Crate works without them but enrichment is more limited.
- Discogs — music metadata + market values (free PAT)
- TMDB — film metadata (free API token)
- RAWG — game metadata (free API key)
- ComicVine — comic metadata (free API key)
- PriceCharting — game / comic market values
Open Library (book metadata) needs no token.
The easiest way to install is from the Nextcloud App Store: in Nextcloud go to Apps → Multimedia → Crate → Download and enable.
To install (or upgrade) manually from a release archive instead, run the following from your custom_apps directory:
# 1. Back up the existing install (in case rollback needed; skip on first install)
mv crate crate.bak.$(date +%s)
# 2. Download & extract the release
CRATE_VERSION=$(curl -sSL https://api.github.com/repos/megamaced/crate/releases/latest \
| grep -m1 '"tag_name"' | cut -d'"' -f4 | tr -d v)
curl -sSL -o crate-${CRATE_VERSION}.tar.gz \
https://github.com/megamaced/crate/releases/download/v${CRATE_VERSION}/crate-${CRATE_VERSION}.tar.gz
tar -xzf crate-${CRATE_VERSION}.tar.gz
rm crate-${CRATE_VERSION}.tar.gz
# 3. Fix ownership (Nextcloud usually runs as www-data; check with `ls -l` first)
chown -R www-data:www-data crate
# 4. From the Nextcloud root, run upgrade so any migrations apply
su -c "php /var/www/html/occ app:disable crate" -s /bin/bash www-data
su -c "php /var/www/html/occ app:enable crate" -s /bin/bash www-data
su -c "php /var/www/html/occ upgrade" -s /bin/bash www-dataOr, for development, clone this repo into custom_apps/crate and run npm ci && npm run build to compile the JS bundle.
composer install
npm ci
npm run buildTests:
vendor/bin/phpcs --standard=PSR12 lib/
vendor/bin/phpunit --testsuite unit
npm run lint
npm test
bin/l10n checkCrate uses Weblate for community translations. Thank you to Weblate for providing free hosting through its Libre plan.
Help translate the web app or the Android app in your browser.
The source strings are the t() and n() calls in src/ and lib/, gathered into translationfiles/templates/crate.pot. Each language is a gettext file, translationfiles/<language>/crate.po.
bin/l10n (needs podman or docker) runs Nextcloud's translationtool in a pinned container:
bin/l10n pot # regenerate the template after adding or changing strings
bin/l10n check # what CI checks: template current, fixtures, valid translations
bin/l10n build # write l10n/<language>.js|json for a local installl10n/ is built, not committed. It holds only translated, non-fuzzy entries, so nothing unreviewed reaches users; release archives include it.
Tagged v* pushes produce a release archive (crate-<version>.tar.gz) ready to drop into a Nextcloud custom_apps/ directory. Built and attached automatically by GitHub Actions.
AGPL-3.0-or-later — same as Nextcloud server itself.









