vtamp 0.4.1

Changes since v0.4.0. The Library exports to a portable archive of playable
media and restores from it, and the spectrum gains four styles.

Added

• vtamp library export writes a portable Library tarball: local audio and
  YouTube downloads with current tags and covers embedded, and video with sound.
  Media files sit at the archive root with readable artist/title names and their
  source modification times, and play directly after normal extraction; radio
  registrations and source metadata are kept in the manifest.
• library import, --dry-run, and library archive-status validate and merge
  archives while keeping existing tracks, Queue and playback intact. Interrupted
  publication is recovered on startup. Export, restore, and dry-run report
  stages, item counts, and byte progress on stderr, and library archive-status
  includes restore progress.
• Spectrum styles radial, fire, ridge, and sparks, after waterfall
  in the V cycle. Radial draws petals around a ring of braille dots, bass on
  the left and treble on the right, and sudden rises across the spectrum swell
  a glowing core and send waves outward; fire feeds flames on half-block
  pixels from the band levels; ridge stacks recent frames as lines in which
  nearer lines hide farther ones, and freezes while paused like the waterfall;
  sparks throws braille sparks from the bars when a band jumps. All four use
  the active theme's colors and stop animating once the audio stops.

Changed

• Deleting a managed YouTube download (d in Library or vtamp library delete)
  also removes its queued copies and play-next reservations and stops it if it
  is playing, instead of refusing tracks in Queue or playback.

Fixed

• Live radio with the spectrum shown no longer keeps the TUI redrawing 20 times
  a second; the panel's unavailable notice now lets the animation timer sleep.

Upgrade notes

• Protocol is 10; database version remains 6, so upgrading from v0.4.0
  needs no database migration. Protocol 10 adds the archive restoration
  commands. Clients and servers must use the same protocol.
• Before upgrading v0.4.0, stop its server with the matching installed binary:
  vtamp server stop. Then run brew update && brew upgrade vtamp (or replace
  the binary) and start vtamp again. The saved session is restored paused.
  Installing or rebuilding does not replace a running server.
• An older client reports invalid settings while ui.json names one of the new
  spectrum styles; saving a theme with t in that client repairs the file.
• Prebuilt downloads cover Apple Silicon macOS and ARM64 Linux with glibc 2.39+
  (tested on Ubuntu 24.04). Intel Macs and other Linux architectures build from source.

Install

Apple Silicon macOS:

brew install rath/tap/vtamp

For existing v0.4.0 installs, stop the old server before upgrading:

vtamp server stop
brew update && brew upgrade vtamp
vtamp

ARM64 Linux (Ubuntu 24.04 or newer, glibc 2.39+):

curl -LO https://github.com/rath/vtamp/releases/download/v0.4.1/vtamp-aarch64-unknown-linux-gnu.tar.gz
curl -LO https://github.com/rath/vtamp/releases/download/v0.4.1/SHA256SUMS
sha256sum --check --ignore-missing SHA256SUMS
tar -xzf vtamp-aarch64-unknown-linux-gnu.tar.gz
install -D -m 755 vtamp-aarch64-unknown-linux-gnu/vtamp ~/.local/bin/vtamp

Or build from source with Rust 1.90+, a C compiler, and cmake:

git clone --branch v0.4.1 https://github.com/rath/vtamp.git
cd vtamp
cargo install --locked --path .

Assets

File	Contents
vtamp-aarch64-apple-darwin.tar.gz	Ad-hoc signed Apple Silicon macOS binary, LICENSE, README, and changelog
vtamp-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux headless server, LICENSE, README, and changelog
SHA256SUMS	SHA-256 checksums of both archives

On macOS, verify the downloaded archive with shasum -a 256 -c --ignore-missing SHA256SUMS. Homebrew verifies its download automatically.

Full changelog: v0.4.0...v0.4.1