corpus

Log | Files | Refs | README | LICENSE

commit 61538d62c27818f50242e854d72135ae67cf5e6c
parent ef7cdb9855a2a2a3c79c489485eb53d309a20e28
Author: mtmn <miro@haravara.org>
Date:   Sun, 19 Apr 2026 14:52:07 +0200

chore: update readme

Diffstat:
MREADME.md | 24+++++++++++++++++++-----
1 file changed, 19 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md @@ -3,7 +3,7 @@ A self-hosted [ListenBrainz](https://listenbrainz.org) and [Last.fm](https://las It includes storing scrobbles, metadata enrichment, and an interactive [PureScript](https://purescript.org) frontend for exploration of your listening habits. -[Example instance](https://scrobbler.mtmn.name) +You can see it for yourself - [scrobbler.mtmn.name](https://scrobbler.mtmn.name) ## Documentation @@ -31,16 +31,20 @@ just nix run ```bash # Install dependencies +npm install npx spago install # Build the project -npx spago build +npm run build # Run tests npx spago test -# Bundle the client for the browser -npx spago bundle --module Client --outfile client.js --platform browser +# Build an optimized release +npm run release + +# Run the application +npx spago run ``` @@ -61,4 +65,14 @@ npx spago bundle --module Client --outfile client.js --platform browser | `AWS_S3_ADDRESSING_STYLE` | — | Set to `path` for path-style S3 URLs | | `METRICS_ENABLED` | `false` | Set to `true` to expose Prometheus metrics at `/metrics` | -Per-user settings (`listenbrainzUser`, `lastfmUser`, `initialSync`, `coverCacheEnabled`, `backupEnabled`, `backupIntervalHours`, etc.) are configured in `users.json` (or `users.dhall`), not via environment variables. +### Per-user configuration + +| Field | Default | Description | +| :--- | :--- | :--- | +| `listenbrainzUser` | — | ListenBrainz username to sync scrobbles from | +| `lastfmUser` | — | Last.fm username to sync scrobbles from | +| `databaseFile` | `corpus.db` | Path to the user's DuckDB database file | +| `initialSync` | `false` | Perform a full historical sync on first run | +| `coverCacheEnabled` | `true` | Enable cover art caching to S3 | +| `backupEnabled` | `false` | Enable database backups to S3 | +| `backupIntervalHours` | `1` | Backup frequency |