Skip to main content

Headphones

@magistr/headphonesv2026.07.16.2· 9d agoMODELS
01README

Headphones music-download automation API for swamp — manage artists, albums, and the wanted queue on a Headphones instance over its JSON API.

Model:

  • @magistr/headphones — artist CRUD (find/add/get/pause/resume/refresh/del), album operations (find/add/get/queue/unqueue), list views (wanted, snatched, upcoming, history), and system actions (force-search, force-process, version/update checks, logs, restart, update).

Includes an optional SSH-backed audit-library method that cross-checks the Headphones database (Status=Downloaded) against the music filesystem to report albums marked downloaded but absent from disk.

02Release Notes

Release 2026.07.16.2 — align model versions with manifests

Maintenance release across the @magistr extensions. For most packages this carries no functional change: the only edit is the model's version: field, brought back in line with its manifest version so the published model type version and the package version no longer drift.

Functional changes in this release are limited to:

  • anime-cron: normalizeTitle now strips a ": subtitle" suffix and a trailing parenthesized year before comparison, fixing dedup false-misses where the torrent title carries a subtitle or year that the AniList romaji does not.

  • arckit: first publish. Standalone ArcKit port — a 12-phase architecture governance state machine with 65 bundled templates, driven by a bundled skill.

Also tracks three extensions (kaiten, observability-agent, music-library) that previously existed only as untracked working-tree directories, recovered from stashes.

03Models1
@magistr/headphonesv2026.07.16.2extensions/models/headphones.ts
fn restart()
Restart Headphones
fn update()
Trigger Headphones application update

Resources

artists(infinite)— Artist listing
artist(infinite)— Single artist detail with albums
album(infinite)— Album detail with tracks
albums(infinite)— Album listing (wanted/upcoming/snatched)
history(infinite)— Download history
search(infinite)— Search results
version(infinite)— Version information
task(infinite)— Task/action result
logs(infinite)— Application logs
audit(infinite)— Library audit: albums marked Downloaded in headphones DB but absent from filesystem
04Previous Versions1
2026.05.25.1

Merge pull request #5 from umag/extensions/jscad-stl-pair

extensions: add 15 more @magistr extensions + auto-discover CI

05Stats
A
100 / 100
Downloads
1
Archive size
12.8 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
06Platforms
07Labels