Skip to main content
← back to extensions

Audiobookshelf

@jamesakeech/audiobookshelfv2026.07.03.1· 4d agoMODELS
01README

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

02Models1
@jamesakeech/audiobookshelfv2026.07.03.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
03Stats
A
100 / 100
Downloads
0
Archive size
9.4 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
Repository
https://github.com/jimmykeech/swamp-extensions
04Platforms