04_Audiobookshelf
audiobookshelf
Self-hosted audiobook and podcast server
| Image | ghcr.io/advplyr/audiobookshelf:latest |
|---|---|
| Version | 2.35.0 |
| Etat | Up (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 | rw, :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_librariesget_libraryget_library_itemsget_library_personalizedget_itemget_item_progressget_podcast_episodesdownload_podcast_episodesget_listening_sessionsget_listening_statsget_mesearch_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.shFonctionnement
- Authentification via
POST /loginpour 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 libsREX — 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.