Skip to main content

Headphones

@magistr/headphonesv2026.05.25.1· 5d 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

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

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

03Models1
@magistr/headphonesv2026.05.25.1headphones.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
04Stats
A
100 / 100
Downloads
1
Archive size
12.6 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
05Platforms
06Labels