calibre web

Calibre-Web

Calibre-Web est une application Web qui offre une interface claire et intuitive pour parcourir, lire et télécharger des livres électroniques à l'aide d'une base de données Calibre valide.

Table des matières (cliquez pour agrandir)

1. À propos
2. Caractéristiques
3. Installation
   • Installation via pip (recommandé)
   • Démarrage rapide
   • Exigences
4. Images Docker
5. Dépannage
6. Reconnaissance des contributeurs
7. Contact
8. Contribuer à Calibre-Web

Ce logiciel est un fork de bibliothèque et est sous licence GPL v3.

Caractéristiques

• Interface HTML5 Bootstrap 3 moderne et réactive
• Configuration graphique complète
• Gestion complète des utilisateurs avec des autorisations précises par utilisateur
• Interface d'administration
• Interface utilisateur multilingue prenant en charge plus de 20 langues (langues prises en charge)
• Flux OPDS pour les applications de lecture de livres électroniques
• Options avancées de recherche et de filtrage
• Création de collection de livres (étagères) sur mesure
• Prise en charge de l’édition et de la suppression des métadonnées des livres électroniques
• Téléchargement de métadonnées à partir de diverses sources (extensible via des plugins)
• Conversion de livres électroniques via les binaires Calibre
• Restriction de téléchargement de livres électroniques pour les utilisateurs connectés
• Prise en charge de l'enregistrement des utilisateurs publics
• Envoyez des eBooks aux liseuses électroniques en un seul clic
• Synchronisez les appareils Kobo avec votre bibliothèque Calibre
• Prise en charge de la lecture de livres électroniques dans le navigateur pour plusieurs formats
• Téléchargez de nouveaux livres dans différents formats, y compris des formats audio
• Prise en charge des colonnes personnalisées Calibre
• Masquage du contenu en fonction des catégories et du contenu des colonnes personnalisées par utilisateur
• Capacité de mise à jour automatique
• Connexion "Magic Link" pour un accès facile sur les liseuses
• Prise en charge de LDAP, Google/GitHub OAuth et de l'authentification proxy

Installation

Installation via pip (recommandé)

1. Créez un environnement virtuel : Il est essentiel d'isoler votre installation Calibre-Web pour éviter les conflits de dépendances. Vous pouvez créer un environnement virtuel en exécutant :

    python3 -m venv calibre-web-env
   

2. Activez l'environnement virtuel :

    source calibre-web-env/bin/activate
   

3. Installer Calibre-Web : Utilisez pip pour installer l'application :

    pip install calibreweb
   

4. Installer des fonctionnalités facultatives : Pour des fonctionnalités supplémentaires, vous devrez peut-être installer des fonctionnalités facultatives. Reportez-vous à cette page pour plus de détails sur ce qui peut être installé.
5. Démarrez Calibre-Web : Après l'installation, vous pouvez démarrer l'application avec :

    cps
   

Remarque : les utilisateurs du système d'exploitation Raspberry Pi peuvent rencontrer des problèmes d'installation. Si vous le faites, essayez de mettre à niveau pip et/ou d'installer cargo comme suit :

 ./venv/bin/python3 -m pip install --upgrade pip
sudo apt install cargo

Liens importants

• Pour obtenir des exemples d'installation supplémentaires, vérifiez les éléments suivants :
  • Installation manuelle
  • Installation de Linux Mint
  • Configuration du fournisseur de cloud

Démarrage rapide

1. Accédez à Calibre-Web : ouvrez votre navigateur et accédez à :

    http://localhost:8083
   

   ou pour le catalogue OPDS :

    http://localhost:8083/opds
   

2. Connexion : utilisez les informations d'identification d'administrateur par défaut :
   • Nom d'utilisateur : administrateur
   • Mot de passe : admin123
3. Configuration de la base de données : si vous n'avez pas de base de données Calibre, téléchargez un exemple depuis :

    https://github.com/janeczku/calibre-web/raw/master/library/metadata.db
   

   Retirez-le du dossier Calibre-Web pour éviter de l'écraser lors des mises à jour.
4. Configurer la base de données Caliber : Dans l'interface d'administration, définissez l' Location of Calibre database sur le chemin du dossier contenant votre bibliothèque Caliber (où se trouve metadata.db ) et cliquez sur "Enregistrer".
5. Intégration de Google Drive : Pour héberger votre bibliothèque Calibre sur Google Drive, reportez-vous au guide d'intégration de Google Drive.
6. Configuration administrateur : configurez votre instance via la page d'administration, en vous référant aux guides de configuration de base et de configuration de l'interface utilisateur.

Exigences

• Version Python : assurez-vous d'avoir Python 3.7 ou une version ultérieure.
• Imagemagick : requis pour l'extraction de couverture à partir d'EPUB. Les utilisateurs Windows devront peut-être également installer Ghostscript pour l'extraction de couverture PDF.
• Outils optionnels :
  • Programme de bureau Calibre : recommandé pour la conversion à la volée et l'édition de métadonnées. Définissez le chemin d'accès à l'outil de conversion de Calibre sur la page de configuration.
  • Outil Kepubify : Nécessaire pour la prise en charge des appareils Kobo. Téléchargez l'outil et placez le binaire dans /opt/kepubify sous Linux ou C:Program Fileskepubify sous Windows.

Images Docker

Des images Docker prédéfinies sont disponibles :

Serveur Linux - x64, aarch64

• Docker Hub : serveur linux/calibre-web
• GitHub : serveur linux/docker-calibre-web
• Couche Caliber facultative : linuxserver/docker-mods

Pour inclure le binaire Caliber ebook-convert (x64 uniquement), ajoutez la variable d'environnement :

 DOCKER_MODS=linuxserver/mods:universal-calibre

dans votre fichier d'exécution/composition Docker. Omettez cette variable pour une image légère.

• Configuration des chemins :
  • Définissez le chemin d’accès aux binaires Calibre sur /usr/bin .
  • Définissez le chemin vers Unrar sur /usr/bin/unrar .

Dépannage

• Problèmes courants :

  • Si vous rencontrez des problèmes lors du démarrage de l'application, recherchez les messages d'erreur dans les fichiers journaux situés dans le répertoire logs .
  • Si les livres électroniques ne parviennent pas à se charger, vérifiez que l' Location of Calibre database est correctement défini et que le fichier de la base de données est accessible.

• Erreurs de configuration : assurez-vous que votre base de données Calibre est compatible et correctement formatée. Reportez-vous à la documentation de Calibre pour obtenir des conseils sur la maintenance de la base de données.

• Problèmes de performances :

  • Si l'application est lente, pensez à augmenter les ressources allouées (CPU/RAM) à votre serveur ou à optimiser la base de données Calibre en supprimant les doublons et les entrées inutiles.
  • Videz régulièrement le cache de votre navigateur Web pour améliorer les temps de chargement.

• Problèmes de gestion des utilisateurs : si les utilisateurs ne parviennent pas à se connecter ou à s'inscrire, vérifiez les paramètres d'autorisation utilisateur dans l'interface d'administration. Assurez-vous que l'inscription est activée et que les utilisateurs se voient attribuer les rôles appropriés.

• Ressources d'assistance : pour une aide supplémentaire, pensez à visiter la section FAQ du wiki ou à publier vos questions dans la communauté Discord.

Reconnaissance des contributeurs

Nous tenons à remercier tous les contributeurs et responsables de Calibre-Web pour leur précieuse contribution et leur dévouement au projet. Vos contributions sont grandement appréciées.

Contact

Rejoignez-nous sur Discord

Pour plus d'informations, des procédures et des FAQ, veuillez visiter le Wiki

Contribuer à Calibre-Web

Pour contribuer, veuillez consulter nos directives de contribution. Nous acceptons les problèmes, les demandes de fonctionnalités et les demandes d'extraction de la communauté.

Signaler des bogues

Si vous rencontrez des bugs ou des problèmes, veuillez les signaler dans la section problèmes du référentiel. Assurez-vous d'inclure des informations détaillées sur votre configuration et le problème rencontré.

Demandes de fonctionnalités

Nous apprécions les suggestions de nouvelles fonctionnalités. Veuillez créer un nouveau numéro dans le référentiel pour discuter de vos idées.

Ressources supplémentaires

• Documentation : Une documentation complète est disponible sur le wiki Calibre-Web.
• Contributions de la communauté : explorez les contributions de la communauté pour voir le travail en cours et comment vous pouvez vous impliquer.

---

Merci d'utiliser Calibre-Web ! Nous espérons que vous apprécierez la gestion de votre bibliothèque de livres électroniques avec notre outil.