Skip to content

v0.5.0 — Client plugins and new spectrum styles

Choose a tag to compare

@rath rath released this 06 Oct 00:01

Client plugins let local programs extend vtamp with document panels and actions.
This release also adds four spectrum styles and logarithmic frequency labels.

Added

  • Optional client plugins: register local programs, open their document/list
    panels with :, and run the same API from plugin run --json. The host owns
    themes, scrolling, timed highlights, cancellation, and bounded process I/O.
  • A minimal Hello Panel Python example and plugin authoring walkthrough, with
    offline text/actions and a supported-video guide for the transcript example.
  • A separately built Pastel Transcript example, adapted with credit from
    pastel-sketchbook's d4d0be3, keeps provider-specific fetch/parse/caption logic
    outside the default application.
  • Four spectrum styles: squares, smooth, trail, and stereo, following the existing
    ten in the V cycle. Each has its own renderer and uses the current theme.
    Trail retains the six latest frame tops while paused; stereo labels L/R and
    falls back to combined bars on older servers or in small panes.
  • Optional stereo channel data alongside the unchanged combined spectrum in
    protocol 11. Existing clients and servers remain compatible; restart the server
    with the new binary to enable the channel data, and reattach for new styles.
  • Logarithmic frequency labels on horizontal spectrum graphs, positioned against
    their rendered bands and omitted when crowded; radial retains LOW / HIGH.
  • Adapted from Pastel Sketchbook's spectrum contribution,
    preserving combined-channel analysis and correcting trail layering, fading,
    channel orientation, partial blocks, and narrow-pane band coverage.

Upgrade notes

  • Protocol remains 11, database version remains 7, and the new client
    plugin API is 1. Reattach with the new binary to use plugins and spectrum
    styles; no playback-server restart is needed for plugins. Restart the server
    when convenient to enable stereo spectrum channel data.
  • Release archives and Homebrew include the Hello Panel Python example and a
    prebuilt Pastel Transcript plugin. Plugins remain opt-in; see the
    plugin guide for registration and authoring instructions.
  • Prebuilt downloads cover Apple Silicon macOS and ARM64 Linux tested on
    Ubuntu 24.04 (glibc 2.39+). Linux remains a headless server without device
    playback, relay, media keys, radio, or terminal video.

Install

brew install rath/tap/vtamp
# Existing installations:
brew update && brew upgrade vtamp

Or download the archive for your platform below. Verify it against SHA256SUMS
with shasum -a 256 -c --ignore-missing SHA256SUMS on macOS or
sha256sum --check --ignore-missing SHA256SUMS on Linux.

Both archives include the host binary, documentation, themes, Hello Panel,
and a prebuilt Pastel Transcript plugin. Examples are opt-in and are not
registered automatically. Python 3 is required only for Hello Panel.
See the packaged-example guide.

Full changelog: v0.4.3...v0.5.0