How raviwarrier/audiobookshelf-quick-bookmarks works
Audiobookshelf Quick Bookmarks is a stateless FastAPI trigger service: a mobile or webhook caller sends a bookmark request with the user’s Audiobookshelf token; the service can discover the user’s active unfinished item and playback position, create the bookmark in Audiobookshelf, and return confirmation. The README also documents optional shared-key protection and explicit item/time inputs. Sampled backend code supports the main request flow; the frontend is an empty React shell, so it is not part of this workflow.
Main entry points: main.py Bookmark endpoint
Components 10
Trigger API
- Bookmark endpoint
main.py - Health / info
main.py
Bookmark Workflow
- Progress lookup
main.py - Active-item selection
main.py - Bookmark request
main.py - Bookmark confirmation
main.py
Request Security
- Service-key check
main.py - User-token extraction
main.py
Other components
- Mobile / webhook
- Audiobookshelf
Connections 12
- Mobile / webhook → Bookmark endpoint: POST request
- Bookmark endpoint → Service-key check: checks key
- Bookmark endpoint → User-token extraction: resolves token
- Bookmark endpoint → Progress lookup: looks up progress
- Progress lookup → Audiobookshelf: GET progress
- Audiobookshelf → Active-item selection: returns progress
- Bookmark endpoint → Active-item selection: selects item
- Bookmark endpoint → Bookmark request: submits bookmark
- Bookmark request → Audiobookshelf: POST bookmark
- Audiobookshelf → Bookmark confirmation: returns result
- Bookmark endpoint → Bookmark confirmation: formats response
- Mobile / webhook → Health / info: GET status