04_Audiobookshelf

audiobookshelf

Self-hosted audiobook and podcast server

Image	ghcr.io/advplyr/audiobookshelf:latest
Version	2.35.0
Etat	Up 9 hours (healthy)
Compose project	audiobookshelf
Reseau	audiobookshelf_audiobookshelf_network
URL	https://audiobookshelf.juxjux.ovh
Source	https://github.com/advplyr/audiobookshelf

Ports

Hote	Container	IP
13378	80/tcp	127.0.0.1

Volumes

Source (hote)	Destination	Type	Mode
/home/debian/audiobookshelf/config	/config	bind	rw
/home/debian/audiobookshelf/metadata	/metadata	bind	rw
/home/debian/audiobookshelf/podcasts	/podcasts	bind	rw
/home/debian/audiobookshelf/audiobooks	/audiobooks	bind	rwrw, :shared

---

Integration Claude Code — MCP

Statut MCP	MCP actif
Outils (prefix)	mcp__audiobookshelf__
Configuration	Script Python : C:\Users\eliob\.claude\mcp_audiobookshelf.py | Auth : JWT Bearer via POST /login

Outils disponibles

• get_libraries
• get_library
• get_library_items
• get_library_personalized
• get_item
• get_item_progress
• get_podcast_episodes
• download_podcast_episodes
• get_listening_sessions
• get_listening_stats
• get_me
• search_library

Ce que nous pouvons faire ensemble

• Parcourir la bibliothèque d'audiobooks et de podcasts
• Suivre la progression d'écoute d'un livre ou épisode
• Rechercher un titre, auteur ou podcast
• Consulter les statistiques d'écoute (temps total, sessions)
• Télécharger des épisodes de podcast

---

Scan quotidien automatique — 2026-06-24

Un cron tourne chaque nuit à 04h00 UTC pour scanner toutes les bibliothèques Audiobookshelf et détecter les nouveaux contenus ou les renommages de dossiers.

Script

/home/debian/abs_scan.sh — log : /var/log/abs_scan.log

0 4 * * * bash /home/debian/abs_scan.sh

Fonctionnement

Authentification via POST /login pour obtenir un token JWT frais Récupération de toutes les bibliothèques via GET /api/libraries Déclenchement d'un scan pour chaque bibliothèque via POST /api/libraries/{id}/scan

Bibliothèques scannées : 36 (audiobooks + podcasts). Durée estimée : quelques minutes.

Exemple de log :

2026-06-24 04:00 SCAN OK 36/36 libs

---

REX — 2026-06-24 : audiobook illisible après renommage de dossier

Contexte

Audiobookshelf ne pouvait plus lire Les routes de la soie (Peter Frankopan). Erreur dans les logs :

Error: ENOENT: no such file or directory, stat '/audiobooks/Histoire/2 - Moyen Age/Peter Frankopan - Les routes de la soie/27_CH_08_LA_ROUTE_DU_CIEL.mp3'

Cause

Le dossier avait été renommé sur kDrive/NAS de Peter Frankopan - Les routes de la soie en Peter Frankopan-les routes de la soie (tiret sans espaces, minuscule). Audiobookshelf conservait l'ancien chemin dans sa base.

Solution

Le scan quotidien abs_scan.sh détecte ce type de désynchronisation et met à jour les chemins. Pour forcer immédiatement : lancer un scan manuel depuis l'interface Audiobookshelf ou exécuter bash /home/debian/abs_scan.sh.