Skip to content

Releases

Piper v0.2.1

Choose a tag to compare

@github-actions github-actions released this 12 Nov 02:39
edf0963

Changelog

Patch Changes

  • Fill missing Apple Music ISRC and duration from the catalog even when a recent play already has a share URL. (#100)

  • Request a fresh Apple Music token when linking an account so users can recover after changing their Apple ID password. Fix unlinking from the Apple Music link page. (#101)

Install v0.2.1

The Docker image supports Linux AMD64 and ARM64.

docker pull ghcr.io/teal-fm/piper:0.2.1

For a new installation, download this version's configuration:

curl -fsSLo compose.release.yml https://raw.githubusercontent.com/teal-fm/piper/v0.2.1/compose.release.yml
curl -fsSLo .env.template https://raw.githubusercontent.com/teal-fm/piper/v0.2.1/.env.template
cp -n .env.template .env

Configure 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.1 docker compose -f compose.release.yml up -d

For 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.1 --depth 1 https://github.com/teal-fm/piper.git piper-0.2.1
cd piper-0.2.1
npm ci
npm run build:css
CGO_ENABLED=1 go build -ldflags="-X github.com/teal-fm/piper/models.buildChannel=release" -o piper ./cmd

Configure .env as described in the setup guide, then run ./piper.

Piper v0.2.0

Choose a tag to compare

@github-actions github-actions released this 11 Nov 03:57
86c007c

Changelog

Minor Changes

  • Add a Last.fm-compatible scrobbling API at /2.0/. It supports track.scrobble, track.updateNowPlaying, auth.getToken, auth.getSession, and auth.getMobileSession, using piper API keys as Last.fm API and session keys. Responses are XML by default and JSON with format=json; accepted scrobbles are stored under a separate lastfm-compat source 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.0

For 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 .env

Configure 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 -d

For 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 ./cmd

Configure .env as described in the setup guide, then run ./piper.

Piper v0.1.1

Choose a tag to compare

@github-actions github-actions released this 22 Oct 13:26
d59be84

Changelog

Patch Changes

  • Raise the minimum Go version to 1.26.10 and update the Docker and Nix toolchains to include upstream security fixes. (#94)

Install v0.1.1

The Docker image supports Linux AMD64 and ARM64.

docker pull ghcr.io/teal-fm/piper:0.1.1

For a new installation, download this version's configuration:

curl -fsSLo compose.release.yml https://raw.githubusercontent.com/teal-fm/piper/v0.1.1/compose.release.yml
curl -fsSLo .env.template https://raw.githubusercontent.com/teal-fm/piper/v0.1.1/.env.template
cp -n .env.template .env

Configure 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.1.1 docker compose -f compose.release.yml up -d

For 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.1.1 --depth 1 https://github.com/teal-fm/piper.git piper-0.1.1
cd piper-0.1.1
npm ci
npm run build:css
CGO_ENABLED=1 go build -ldflags="-X github.com/teal-fm/piper/models.buildChannel=release" -o piper ./cmd

Configure .env as described in the setup guide, then run ./piper.

Piper v0.1.0

Choose a tag to compare

@github-actions github-actions released this 14 Sep 19:13
8dd3f7d

Changelog

Minor Changes

  • ed691d4: Expand the NixOS module with service enable flags and a separate Last.fm polling interval, improve secret validation and data-directory setup, and update the Nix package build.
  • 5a75e72: add listenbrainz support

Patch Changes

  • 7773191: Add Changesets release PRs, versioned Docker images for AMD64 and ARM64, and GitHub releases with changelogs and installation instructions. The latest Docker tag now follows stable releases; use main to track development builds.
  • e007420: Include the seven-character Git commit in the submission agent for source builds and main Docker images.

Install v0.1.0

The Docker image supports Linux AMD64 and ARM64.

docker pull ghcr.io/teal-fm/piper:0.1.0

For a new installation, download this version's configuration:

curl -fsSLo compose.release.yml https://raw.githubusercontent.com/teal-fm/piper/v0.1.0/compose.release.yml
curl -fsSLo .env.template https://raw.githubusercontent.com/teal-fm/piper/v0.1.0/.env.template
cp -n .env.template .env

Configure 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.1.0 docker compose -f compose.release.yml up -d

For 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.1.0 --depth 1 https://github.com/teal-fm/piper.git piper-0.1.0
cd piper-0.1.0
npm ci
npm run build:css
CGO_ENABLED=1 go build -ldflags="-X github.com/teal-fm/piper/models.buildChannel=release" -o piper ./cmd

Configure .env as described in the setup guide, then run ./piper.