Files
wiki/Catalogue-Self-Hosted/apps/app-lazylibrarian.md
T
2026-06-09 18:40:21 +02:00

7.5 KiB


title: LazyLibrarian created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, automation, books, ebook, audiobook, arr, python] confidence: high contested: false sources: [https://selfh.st/apps/?tag=Automation, https://gitlab.com/LazyLibrarian/LazyLibrarian]

📚 LazyLibrarian

*Le compagnon arr pour vos livres et audiobooks — suit vos auteurs préférés, détecte les nouvelles parutions (ebooks et audiobooks), les cherche sur les indexeurs NZB/torrent et les envoie automatiquement à qBittorrent, SABnzbd ou Calibre.

📋 Informations Générales

Champ Valeur
Site web lazylibrarian.gitlab.io
GitLab LazyLibrarian/LazyLibrarian
License GPL-3.0
Langage Python (82 %), HTML, JavaScript
Étoiles GitHub 280 (repo archive)
Dernière MAJ 2026-06-05
Catégorie cat-automation

📝 Description

LazyLibrarian s'inscrit dans la philosophie de la famille *arr (Sonarr, Radarr, Lidarr, Readarr) : automatiser la gestion d'une médiathèque. Ici, le média, ce sont les livres numériques (ebooks EPUB/MOBI/PDF) et les audiobooks (M4B/MP3). LazyLibrarian peut fonctionner avec ou sans Calibre : il importe une bibliothèque Calibre existante, mais se suffit à lui-même pour le suivi d'auteurs et le téléchargement.

Le principe : vous ajoutez un auteur à votre « follow list », LazyLibrarian interroge HardCover, OpenLibrary, LibraryThing, GoodReads (si vous avez une clé API) et optionnellement GoogleBooks pour récupérer la bibliographie complète, classe les ouvrages en Wanted/Have/Ignored, et pour chaque livre Wanted, cherche en continu la release disponible sur vos indexeurs (Torznab, Newznab, RSS) — que ce soit en torrent, NZB, ou magnet.

Quand un fichier arrive, LazyLibrarian peut l'envoyer vers sabnzbd, nzbget, qbittorrent, deluge, transmission, utorrent, rtorrent ou synology_downloadstation. Les métadonnées sont sauvegardées au format metadata.opf (compatible Calibre) à côté du fichier, et un système d'AutoAdd permet d'envoyer automatiquement les nouveaux fichiers vers Calibre.

Le projet a connu une histoire mouvementée : après l'abandon du repo GitHub originel (dernier commit 2019), le développement a redémarré sur GitLab sous la houlette de phil borman (philborman), avec des releases régulières. L'image LinuxServer.io reste l'option de déploiement la plus populaire, incluant ghostscript pour la génération de couvertures de magazines.

🚀 Installation

Option 1 : Docker Compose (recommandé)

# docker-compose.yml
services:
  lazylibrarian:
    image: lscr.io/linuxserver/lazylibrarian:latest
    container_name: lazylibrarian
    restart: unless-stopped
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Paris
      - DOCKER_MODS=linuxserver/mods:calibre       # optionnel, ajoute calibredb (x86_64 uniquement)
    volumes:
      - ./config:/config                # base de données et config
      - ./books:/books                  # bibliothèque ebooks/audiobooks
      - ./downloads:/downloads          # incoming des clients
    ports:
      - "5299:5299"

Premier lancement : http://localhost:5299, l'assistant vous demande de configurer le fuseau, l'emplacement de la bibliothèque, puis les clients torrent/NZB et les indexeurs.

Option 2 : Image officielle (variante)

services:
  lazylibrarian:
    image: ghcr.io/lazylibrarian/lazylibrarian:latest
    container_name: lazylibrarian
    restart: unless-stopped
    volumes:
      - ./config:/config
      - ./books:/books
    ports:
      - "5299:5299"

Option 3 : Installation manuelle (bare-metal)

git clone https://gitlab.com/LazyLibrarian/LazyLibrarian.git
cd LazyLibrarian
python -m pip install .
python LazyLibrarian.py -d   # daemon mode

L'UI est alors accessible sur http://localhost:5299/. Nécessite Python 3.7+ (3.10+ recommandé pour les dernières releases).

⚙️ Configuration

  1. Métadonnées : configurer l'ordre de priorité des sources (HardCover puis OpenLibrary, le plus stable depuis la fermeture de l'API Goodreads).
  2. AutoAdd / Calibre : si vous utilisez app-calibre-web ou app-calibre-web-automated, configurer un dossier de watch pour intégration automatique.
  3. Indexeurs : pointer vers app-prowlarr ou app-jackett (Torznab) pour centraliser la config.
  4. Clients de téléchargement : qBittorrent et SABnzbd sont les couples les plus utilisés.
  5. Send-to-Kindle : activer l'option SendTo avec votre adresse @kindle.com pour recevoir automatiquement les nouveaux ebooks.
  6. Magazines : LazyLibrarian peut aussi suivre des magazines (numériques), avec génération de couverture via ghostscript.
  7. Recherche : fréquence par défaut 30 min, ajuster selon votre indexeur.

🔄 Alternatives

Open Source

  • app-readarr — Successeur moderne (mais controversé, voir status), interface plus soignée
  • app-calibre-web-automated — CWA, qui inclut un module de téléchargement
  • app-komga — Plutôt orienté comics/mangas (CBZ/CBR)
  • Bookworm — Frontend moderne pour Calibre (en développement)
  • CouchDB + Calibre2Opds — Solutions historiques, plus minimalistes

Propriétaires

  • Amazon Kindle Library — Auto-sync des livres Kindle achetés
  • Audible (Amazon) — Sync des audiobooks achetés
  • Scribd / Everand — Abonnement livres/audiobooks
  • Goodreads — Tracking de lectures, mais sans téléchargement

🔐 Sécurité

  • 🔐 Pas d'auth native robuste : obligatoirement derrière reverse proxy (app-caddy, app-traefik) avec SSO (app-authelia, app-authentik)
  • 🔑 HTTPS obligatoire si exposition Internet
  • 🛡️ Les clés API des indexeurs et clients sont stockées en clair dans la base SQLite : chiffrer ./config au repos
  • 🐛 Limiter la fréquence des requêtes vers les sources de métadonnées (Goodreads a fermé son API, les autres ont des rate limits) : risque de blocage IP
  • 🔄 Auto-update : la fonction d'auto-update interne est pratique mais peut casser après une MAJ de l'image Docker — préférer pull manuel
  • 📜 Logs : contiennent les requêtes de recherche de livres, purger régulièrement
  • 🚨 Droits des ebooks : la légalité du téléchargement varie selon les juridictions et la source de la release (DRM-free vs piratage)

📚 Ressources

Pages Liées