Skip to main content

Audiobookshelf

@jamesakeech/audiobookshelfv2026.10.15.1· 1mo agoBEHAVIORS
01README

Monitor a self-hosted Audiobookshelf server — libraries, audiobooks/podcasts, listening progress, listening sessions, and aggregate listening statistics — via the Audiobookshelf REST API.

02Release Notes

Clarify and shorten the README. Runtime code and model versions are unchanged.

03Behaviors1
@jamesakeech/audiobookshelfv2026.07.13.1audiobookshelf.ts

Global Arguments

ArgumentTypeDescription
baseUrlstringAudiobookshelf server base URL, e.g. https://abs.example.com (no trailing slash)
apiKeystringAudiobookshelf API key (Settings → Users → API Keys). Source from a vault.
fn libraries()
List every library on the server
fn items()
List every item (audiobook/podcast) across every library on the server
fn progress()
List media progress (in-progress and finished items) for the API key's user
fn sessions(limit: number)
List recent listening sessions for the API key's user, most recent first
ArgumentTypeDescription
limitnumberMaximum number of recent sessions to fetch
fn stats()
Capture aggregate listening statistics (total time, daily breakdown, top items) for the API key's user

Resources

library(infinite)— A library on the server (one record per library)
item(infinite)— A library item — an audiobook or podcast (one record per item)
progress(infinite)— A media progress record for the API key's user (one per item/episode)
session(infinite)— A listening session for the API key's user (one per session)
stats(infinite)— Aggregate listening statistics for the API key's user
04Previous Versions3
2026.07.13.1
2026.07.11.1
2026.07.03.1
05Stats
A
93 / 100
Downloads
32
Archive size
9.5 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
  • License1/2partial

    no SPDX license declared

  • Verified public repository2/2earned
06Platforms