- GET and HEAD /albums/{id}/cover serve a JPEG made from the picture embedded in
the album's files, or else a cover, folder, front, album or albumart image
(jpg, jpeg, png) in the album's folder. ?size=small (300 px) or large (1000 px).
The token can be in the query, so an <img> element can use it.
- Built the first time it is asked for, scaled, and kept in storage.data_dir
(SONDA_DATA_DIR, default "data"); an album with no cover is remembered for a day.
A new or changed file of the album, or a full rescan, clears the record.
- Nothing is sent anywhere. Pictures are untrusted: files are opened inside the
library only (links are not followed), over 20 MB or 16 million pixels are
ignored, and what is served is always a JPEG made here. Stored files are 0600.
- images table (migration 0013, SQLite and PostgreSQL).
- Spec, contract test, README and example config updated.
Closes #37
41 lines
1.6 KiB
TOML
41 lines
1.6 KiB
TOML
# Copy to sonda.toml and adjust. sonda.toml is git-ignored.
|
|
# Precedence: defaults < this file < environment variables
|
|
# (SONDA_ENV, SONDA_LISTEN, SONDA_DB_DRIVER, SONDA_DB_PATH, SONDA_DB_DSN,
|
|
# SONDA_JWT_SECRET).
|
|
|
|
[server]
|
|
listen = "127.0.0.1:8080" # localhost by default
|
|
|
|
# Libraries (name + directory) are managed through the API: POST /api/v1/libraries.
|
|
[library]
|
|
scan_workers = 4 # parallel tag readers during a scan
|
|
|
|
[database]
|
|
driver = "sqlite" # "sqlite" or "postgres"
|
|
path = "sonda.db" # sqlite only
|
|
dsn = "" # postgres only, e.g. "postgres://user:pass@localhost:5432/sonda?sslmode=disable"
|
|
|
|
[log]
|
|
env = "production" # "dev" or "production"
|
|
|
|
[auth]
|
|
jwt_secret = "" # required, 32+ chars: openssl rand -hex 32
|
|
access_ttl_minutes = 15 # lifetime of an access token
|
|
refresh_ttl_hours = 720 # lifetime of a refresh token (30 days)
|
|
|
|
[listening]
|
|
min_listen_seconds = 20 # a play counts as a listen after this long, or when it completes
|
|
|
|
[taste]
|
|
half_life_days = 90 # an old listen weighs half as much after this many days
|
|
|
|
[storage]
|
|
data_dir = "data" # files Sonda makes (covers); built from your music, no backup needed
|
|
|
|
[scoring] # weights of the parts of a Discover score (only their proportions matter)
|
|
weight_affinity = 0.40 # similar to the artists I like
|
|
weight_genre = 0.25 # tags close to the tags I like
|
|
weight_preference = 0.25 # what my listening says about the artist
|
|
weight_discovery = 0.10 # bonus for what I have not played yet
|
|
|
|
# Last.fm and MusicBrainz are set up through the API, not here: PUT /api/v1/providers/{name}.
|