# Project pack: Audiobookshelf @ 743d915

Facts about **Audiobookshelf** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> Audiobookshelf turns a folder of audiobooks and podcasts into a beautiful library you can listen to anywhere. It remembers where each person stopped, on every device, and fetches covers and book details for you. Everyone in the family gets their own login and progress. It runs on your own computer or server, with free phone apps.

## Setup path (checked 2026-11-03)
- **Not verified.** Not verified. Check the official install page for a native, desktop or hosted option first; fall back to Docker only if there is none. Upstream install docs are not readable as text from the audit environment, so neither a no-Docker path nor a Docker requirement was confirmed.
- Verdict source: https://raw.githubusercontent.com/advplyr/audiobookshelf/HEAD/readme.md
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/advplyr/audiobookshelf
- Pinned commit: `743d9152208507a1dbf7c95c94290071338f44bd`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/advplyr/audiobookshelf/archive/743d9152208507a1dbf7c95c94290071338f44bd.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://www.audiobookshelf.org/docs
- Live demo: https://audiobooks.dev (username: demo / password: demo). Community-hosted web demo with an ordinary user account. Shared with everyone.
- Licence: **GPL-3.0-only**. Free to use and change. If you share your changed version with other people (give them the code or app), you must share your source code under the same licence. Running it for yourself and your household has no extra obligations.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/advplyr/audiobookshelf bespoke-audiobookshelf
  cd bespoke-audiobookshelf
  git checkout --detach 743d9152208507a1dbf7c95c94290071338f44bd
  # Prepare development requirements and local configuration first.
  # Setup notes: needs a dev.js (example in .devcontainer/dev.js); server and client on :3333
  npm ci && (cd client && npm ci && npm run generate) && npm run dev
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  Save the docker-compose.yml from this repo, put your audiobooks in ./audiobooks and podcasts in ./podcasts, then run: docker compose up -d # then open http://localhost:13378 and create the root (admin) user
  ```
- Tools these commands use: Docker, or for development Node.js 24 + FFmpeg
- Develop: `npm ci && (cd client && npm ci && npm run generate) && npm run dev   # needs a dev.js (example in .devcontainer/dev.js); server and client on :3333`
- Test: `npm test`
- Check/lint: `npm run lint`
- Stack: javascript, vue, css (Node.js 24, Express, Sequelize, Nuxt 2, Vue 2, Tailwind CSS 4). Difficulty for a non-developer with an AI: **moderate**. A Node.js server with a Nuxt 2 web client and a single SQLite database. Most family needs are settings. Upstream is rewriting the web client in React and is not taking pull requests for the current Vue client, so client changes stay in your own copy.
Personal data: **yes**. Stored in: SQLite database in /config; covers, cache and backups in /metadata; your audio files stay in your own media folders. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/audiobookshelf/743d915/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/audiobookshelf/743d915/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/audiobookshelf/743d915/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/audiobookshelf/743d915/r3/SKILL.md)