Skip to content
megamacedPublic

About

A personal physical media cataloguing app for Nextcloud (100% AI-written by Claude Code)

Resources

Stars

6 stars

Watchers

0 watching

Forks

Repository files navigation

Crate

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.

Home — album of the day for each category, plus a Recently added strip

Screenshots

Collection views

Books Comics Films
Books collection sorted by author Comics collection grouped alphabetically Films collection with format filter chips: Blu-ray, 4K UHD, DVD
Games Music Playlists
Games collection with platform filter chips Music collection with format filter chips: Vinyl, CD, Cassette Playlists — mixed-category groups

Detail views & import

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
Vinyl detail — Billy Idol, with tracklist, label, market value of £4.44 Game detail — Control, with full plot, developer, publisher, genres CSV / XLSX import dialog with required + optional columns

Features

  • 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

Requirements

  • Nextcloud 29 – 35

Optional API tokens

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.

Open Library (book metadata) needs no token.

Installation

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-data

Or, for development, clone this repo into custom_apps/crate and run npm ci && npm run build to compile the JS bundle.

Building

composer install
npm ci
npm run build

Tests:

vendor/bin/phpcs --standard=PSR12 lib/
vendor/bin/phpunit --testsuite unit
npm run lint
npm test
bin/l10n check

Translations

Crate uses Weblate for community translations. Thank you to Weblate for providing free hosting through its Libre plan.

Translation status on Weblate

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 install

l10n/ is built, not committed. It holds only translated, non-fuzzy entries, so nothing unreviewed reaches users; release archives include it.

Releases

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.

License

AGPL-3.0-or-later — same as Nextcloud server itself.

About

A personal physical media cataloguing app for Nextcloud (100% AI-written by Claude Code)

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages