Comment installer Audiobookshelf sur Saplo : votre propre bibliothèque d'audiobooks et de podcasts

Tu as tes livres audio sur ton ordinateur, quelques autres sur ton téléphone, et quand tu changes d'appareil, tu cherches où tu as arrêté d'écouter. Audiobookshelf rassemble ta bibliothèque audio personnelle en un seul endroit et te permet de reprendre l'écoute sans avoir à noter manuellement le numéro de chapitre. Dans ce guide, nous allons te montrer comment installer Audiobookshelf sur Saplo, ajouter un premier livre et vérifier la lecture.

Les avantages d'Audiobookshelf

Audiobookshelf est un serveur de livres audio et de podcasts en source ouverte. Il met à disposition un lecteur dans le navigateur, retient la progression de chaque utilisateur séparément et la synchronise entre les appareils. Il prend également en charge le téléchargement d'épisodes de podcasts et l'organisation des livres à l'aide de métadonnées et de couvertures. Les fonctionnalités du projet sont décrites dans la Documentation officielle d'Audiobookshelf.

Tu commences avec tes propres fichiers. L'installation ne fournit pas de catalogue de livres audio payants ni d'abonnement à une librairie. Prépare des enregistrements que tu peux écouter en dehors de l'application du vendeur, par exemple des fichiers MP3 ou M4B.

Exigences et hébergement d'Audiobookshelf sur Saplo

Le plan le moins cher qui réponde aux exigences minimales de la recette est la Box S pour 27 € par an. C'est le point de départ pour lancer l'application. La taille de la collection et le nombre d'auditeurs simultanés influencent les ressources nécessaires à l'utilisation quotidienne.

Avant l'installation, prépare une Box active avec de l'espace libre, le nom de l'application et un livre à tester. Ne déplace une grande bibliothèque qu'après avoir vérifié le premier enregistrement. N'oublie pas que les fichiers audio partagent le disque de la Box avec le système et les autres applications, de sorte que toute la capacité du plan ne sera pas disponible pour les livres.

L'installation depuis le catalogue ne nécessite pas de SSH ni de création de base de données. La recette utilise la propre base de données SQLite de l'application. Tu trouveras une description du service sur la page d'hébergement d'Audiobookshelf sur Saplo.

Installation étape par étape

1. Connecte-toi au Panneau Saplo et ouvre le Catalogue d'applications. Cherche Audiobookshelf.
2. Donne un nom à l'application, indique la Box et choisis une adresse d'application disponible, par exemple un sous-domaine *.saploapp.pl.
3. Valide l'installation. Saplo lancera l'application et configurera l'accès via le Domaine avec un certificat SSL.
4. Attends la fin de l'installation dans le Panneau, puis ouvre l'adresse de l'application via HTTPS. Le temps dépendra, entre autres, du téléchargement de l'image et de la charge du serveur.
5. Lors de la première connexion, suis l'assistant de création du compte administrateur Root. Choisis un nom d'utilisateur et un mot de passe fort et unique. Fais-le immédiatement après l'installation, car le premier compte reçoit les droits d'administration.
6. Enregistre l'adresse du serveur et les informations de connexion dans le gestionnaire de mots de passe. C'est un Compte Audiobookshelf, distinct du Compte dans le Panneau Saplo.

La recette laisse également une instruction AUDIOBOOKSHELF-SETUP.txt dans le Catalogue d'applications. Elle ne contient pas de mot de passe administrateur prêt à l'emploi : tu le définis toi-même dans l'assistant.

Ajouter une bibliothèque et un premier livre

Dans les paramètres d'Audiobookshelf, ajoute une bibliothèque de livres, nomme-la par exemple "Audiobooks" et indique le dossier /audiobooks. C'est le chemin visible à l'intérieur de l'application. La recette Saplo le connecte au dossier audiobooks dans le répertoire de ton installation sur la Box.

Ensuite, utilise la fonction de téléchargement de fichiers dans Audiobookshelf :

1. Choisis la bibliothèque où le livre doit être placé.
2. Télécharge un seul fichier M4B ou un dossier contenant toutes les parties d'un même livre.
3. Attends la fin du transfert et l'apparition de l'élément dans la liste.
4. Ouvre le livre et vérifie le titre et l'ordre des parties.

Télécharge un livre divisé en plusieurs fichiers MP3 sous forme de dossier complet. L'ajout séparé de ces mêmes fichiers peut créer plusieurs livres au lieu d'un seul. Les détails sont décrits dans les instructions de téléchargement de fichiers Audiobookshelf.

Tu peux également transférer une collection plus importante via le gestionnaire de fichiers dans le Panneau Saplo vers le dossier audiobooks de ton application. Garde un dossier séparé pour chaque livre. Si la liste ne change pas après le transfert des fichiers, lance un scan de la bibliothèque dans Audiobookshelf et vérifie le chemin indiqué.

Couvertures, auteurs et ordre des volumes

Après l'importation, examine quelques éléments : le titre n'est-il pas le nom du fichier ? L'auteur a-t-il été correctement identifié ? Les différentes parties de l'enregistrement sont-elles dans le bon ordre ? Le scan automatique lit les métadonnées locales. La correspondance du livre avec une source externe de métadonnées est lancée séparément, donc l'absence de couverture juste après le téléchargement n'indique pas une erreur d'installation. Les règles sont décrites dans la documentation des bibliothèques de livres.

En pratique, il est préférable de commencer par un livre en plusieurs parties. Une fois l'importation réussie, il est plus facile d'appliquer la même structure de dossiers au reste de la collection.

Premières écoutes et comptes des membres du foyer

Lance un livre dans le navigateur, fais défiler jusqu'au passage choisi, puis arrête la lecture. Ouvre la même installation dans un second navigateur ou sur ton téléphone et connecte-toi au même compte. Vérifie que tu peux reprendre à l'endroit sauvegardé. C'est un test simple, qu'il vaut la peine d'effectuer avant de transférer toute ton archive.

Pour chaque personne suivante, crée un compte séparé dans les paramètres des utilisateurs d'Audiobookshelf. Un utilisateur normal suffit pour écouter. Donne-lui accès aux bibliothèques appropriées. Grâce à des comptes séparés, les membres du foyer ne se superposeront pas la progression du même livre. Les rôles et les restrictions d'accès sont décrits dans la documentation sur la gestion des utilisateurs.

Podcasts dans une bibliothèque séparée

Pour les podcasts, crée une bibliothèque séparée du type approprié et indique le dossier /podcasts, préparé par la recette Saplo. Audiobookshelf te permet de rechercher des podcasts et de télécharger leurs épisodes. Commence par un seul programme et le téléchargement manuel d'un épisode sélectionné avant d'activer le téléchargement automatique.

Vérifie régulièrement l'occupation du disque. Une archive de podcast avec de nombreux épisodes peut rapidement devenir volumineuse, surtout si tu télécharges plusieurs séries simultanément.

Sauvegardes de la bibliothèque

La sauvegarde intégrée d'Audiobookshelf comprend la base de données de l'application et les couvertures stockées dans le répertoire des métadonnées. Elle n'inclut pas les fichiers audio des livres audio ou des podcasts eux-mêmes. Par conséquent, conserve les enregistrements originaux en dehors de la Box et gère séparément la copie des données de l'application. La portée des sauvegardes intégrées est décrite dans la documentation sur la gestion du serveur.

Avant une importation ou une mise à jour majeure, assure-toi que tu disposes de sauvegardes à jour et que tu sais comment les retrouver en dehors de l'installation en cours d'exécution. La liste visible des livres ne remplace pas elle-même la copie des fichiers audio.

Questions fréquentes

Combien coûte le démarrage ?

Le plan le moins cher qui réponde aux exigences minimales de la recette est la Box S, à 27 € par an. Lors de la planification de l'espace, pense aussi à tes propres enregistrements et aux autres applications sur la Box.

Ai-je besoin de SSH ?

Pas pour l'installation et la première configuration décrites. Tu lances l'application depuis le Panneau Saplo, tu crées un Compte dans le navigateur et tu ajoutes des livres via le téléchargement intégré ou le gestionnaire de fichiers.

Pourquoi ne vois-je pas le livre téléchargé ?

Vérifie que les fichiers se trouvent dans le dossier attribué à la bonne bibliothèque. Pour les livres audio dans cette installation, c'est /audiobooks. Lance le scan et vérifie que le Compte a accès à la bibliothèque.

Que faire si l'application ne répond pas après l'installation ?

Vérifie le Statut de l'application dans le Panneau Saplo et l'adresse ouverte. Si l'installation signale une erreur, transmets le nom de l'application et le contenu du message au Support Saplo. Ne supprime pas la bibliothèque juste pour réessayer.

Par où commencer ?

Ouvre l'offre Audiobookshelf sur Saplo, lance l'application depuis le Catalogue d'applications et crée immédiatement un Compte administrateur. Ajoute un livre, vérifie l'ordre des chapitres et la sauvegarde de la progression. Ce n'est qu'après que tu pourras transférer le reste de ta bibliothèque.