Repository navigation
Piper v0.2.0
Changelog
Minor Changes
- Add a Last.fm-compatible scrobbling API at
/2.0/. It supportstrack.scrobble,track.updateNowPlaying,auth.getToken,auth.getSession, andauth.getMobileSession, using piper API keys as Last.fm API and session keys. Responses are XML by default and JSON withformat=json; accepted scrobbles are stored under a separatelastfm-compatsource so they do not move the Last.fm poller's import cursor, hydrated with MusicBrainz metadata, and published to the user's PDS. (#99)
Install v0.2.0
The Docker image supports Linux AMD64 and ARM64.
docker pull ghcr.io/teal-fm/piper:0.2.0For a new installation, download this version's configuration:
curl -fsSLo compose.release.yml https://raw.githubusercontent.com/teal-fm/piper/v0.2.0/compose.release.yml
curl -fsSLo .env.template https://raw.githubusercontent.com/teal-fm/piper/v0.2.0/.env.template
cp -n .env.template .envConfigure credentials and the public callback URL in .env using the setup guide. For Docker, set SERVER_HOST=0.0.0.0, SERVER_PORT=8080, and DB_PATH=/db/piper.db. Apple Music users must also mount their private key at APPLE_MUSIC_PRIVATE_KEY_PATH inside the container.
Start this exact version:
PIPER_IMAGE=ghcr.io/teal-fm/piper:0.2.0 docker compose -f compose.release.yml up -dFor upgrades, keep your existing .env and volume. Back up the database before upgrading. Use the same Compose project name or directory as your existing deployment so it reuses the volume. Rolling back an image does not roll back database migrations.
To build this version from source, install Git, Node.js 24, npm, Go as specified in go.mod, and a C compiler for SQLite:
git clone --branch v0.2.0 --depth 1 https://github.com/teal-fm/piper.git piper-0.2.0
cd piper-0.2.0
npm ci
npm run build:css
CGO_ENABLED=1 go build -ldflags="-X github.com/teal-fm/piper/models.buildChannel=release" -o piper ./cmdConfigure .env as described in the setup guide, then run ./piper.