Depuis des années, je laisse Gmail aller chercher le courrier de mes autres adresses et je réponds directement avec elles depuis la même interface. C'est pratique, et c'est terminé : Google a c...
Issued : le serveur auto-hébergé pour lire vos comics et BD depuis le navigateur
J'ai longtemps cru que pour profiter d'une collection de BD numériques, il fallait d'abord passer des heures à tout ranger. Mon dossier, lui, ressemble plutôt à un grenier : des albums classés par éditeur, d'autres par série, et une bonne pile de fichiers posés là « en attendant ». Si vous vous reconnaissez, Issued va vous plaire. Ce petit serveur open source se branche sur votre dossier tel qu'il est, sans déplacer un seul fichier, et vous le présente sous la forme d'une vraie bibliothèque à lire depuis un navigateur ou une application de lecture. Je vous explique comment il fonctionne, comment l'installer et surtout comment éviter la fausse bonne idée qui consiste à l'ouvrir sur Internet.
Issued, c'est quoi exactement ?
Issued est un serveur de bibliothèque de comics écrit en Python (avec le framework FastAPI) et distribué sous licence MIT. Son principe tient en une phrase : il scanne votre dossier, construit sa propre base de données à côté, et vous donne deux portes d'entrée vers vos albums.
- un lecteur web, accessible depuis n'importe quel navigateur, y compris sur mobile ;
- un catalogue OPDS, le format standard que comprennent la plupart des applications de lecture de comics et d'ebooks.
Il ne touche jamais à vos fichiers. Le dossier est même monté en lecture seule dans l'exemple Docker officiel, ce que je vous conseille de garder. Issued ne réorganise rien, ne renomme rien : il se contente de lire et de présenter. Le projet a aussi son site, useissued.com.
Votre rangement reste le vôtre
C'est ce qui m'a convaincu. Komga ou Kavita aiment qu'on respecte une certaine arborescence. Issued, lui, part de vos dossiers existants et en déduit la structure de sa bibliothèque. Un dossier « Dupuis » qui contient un dossier « Spirou » qui contient les albums ? Il le présentera exactement comme ça.
Il y a quand même une règle à connaître, une seule.
Pour Issued, un dossier qui contient directement des fichiers de BD est une série. Évitez donc de mélanger dans un même dossier des albums et des sous-dossiers : rangez les fichiers « orphelins » dans leur propre sous-dossier pour que l'affichage reste cohérent.
Dans mon cas, ça s'est réglé en créant un dossier « Divers » pour les one-shots qui traînaient à la racine des dossiers d'éditeurs. Dix minutes de ménage, pas plus.
Les formats pris en charge
Issued lit les formats d'archives de comics courants, plus le PDF. Il sait aussi reconnaître le vrai format d'un fichier à partir de son contenu : un .cbz qui est en réalité compressé en 7-Zip, ce qui arrive plus souvent qu'on ne le croit, s'ouvrira sans broncher.
| Format | Type d'archive | Logiciel supplémentaire |
|---|---|---|
| CBZ | ZIP contenant des images | Aucun |
| CBR | RAR contenant des images | unrar (déjà inclus dans l'image Docker) |
| CB7 | 7-Zip contenant des images | Aucun |
| Document PDF | Aucun | |
| Pour tous les formats : extraction des pages, vignette tirée de la première page, métadonnées ComicInfo.xml ou PDF, suivi de lecture. | ||
Les métadonnées méritent un mot. Si vos archives contiennent un fichier ComicInfo.xml (le standard utilisé par ComicRack et la plupart des outils de catalogage), Issued le lit. Et vous pouvez corriger ces informations directement depuis le lecteur web : titre, numéro, auteurs, etc.
Le lecteur web au quotidien
Une fois le serveur lancé, le lecteur web répond à l'adresse http://ADRESSE-DU-SERVEUR:8181/reader/. L'interface est simple et pensée pour reprendre une lecture rapidement.
- Récents
- Les derniers albums ajoutés à votre dossier, pratiques pour voir ce qui vient d'arriver.
- Continuer la lecture
- Les albums commencés mais pas terminés, pour reprendre là où vous vous étiez arrêté.
- Continuer la série
- Dans un dossier de série, ce bouton rouvre le dernier numéro entamé ou démarre le premier non lu. En fin d'album, le lecteur propose la couverture du suivant.
- Marquer comme lu
- Album par album depuis la grille ou le tableau, ou toute une série d'un coup.
- Thèmes clair et sombre
- Issued suit le réglage de votre système, ou vous basculez à la main.
Le suivi des séries en cours
Si vous lisez des séries encore en cours de parution, ouvrez le dossier de la série et cliquez sur le bouton « Ongoing ». La page du même nom, dans le menu du haut, regroupe toutes les séries suivies. Pour chacune, vous voyez le dernier numéro ajouté, le nombre de numéros présents et ceux qui semblent manquer. Pour repérer un trou dans une collection, c'est très efficace.
Lire sur smartphone et tablette grâce à l'OPDS
Le lecteur web fonctionne sur mobile, mais une application dédiée reste plus confortable pour lire hors connexion ou profiter d'un mode de lecture case par case. Il suffit d'ajouter un catalogue OPDS dans l'application, avec l'adresse http://ADRESSE-DU-SERVEUR:8181/opds/. La recherche dans la bibliothèque est détectée automatiquement par les clients compatibles.
| Application | Système | Ce que j'en retiens |
|---|---|---|
| Panels | iOS, iPadOS | Celle que le développeur recommande en premier |
| Chunky Reader | iOS, iPadOS | Très agréable sur iPad |
| KyBook | iOS | Lecteur ebooks et comics très complet |
| Moon+ Reader | Android | Très personnalisable |
N'importe quelle autre application compatible OPDS devrait faire l'affaire. Attention à un détail qui piège souvent : dans l'application, indiquez l'adresse IP locale de la machine qui fait tourner Issued (du type 192.168.1.100), pas « localhost ».
Installer Issued avec Docker
Comme souvent, Docker est la voie la plus simple, et c'est celle que je recommande sur un NAS ou un petit serveur maison. L'image embarque déjà unrar, donc vos CBR fonctionnent sans rien installer de plus. Voici la commande d'origine :
docker run -d --name issued \
--restart unless-stopped \
-p 8181:8181 \
-v /chemin/vers/vos/comics:/comics:ro \
-v issued_data:/app/data \
ghcr.io/metalogico/issued:latest
Remplacez /chemin/vers/vos/comics par le chemin réel de votre dossier. Le suffixe :ro monte ce dossier en lecture seule : Issued ne peut rien y écrire, et c'est très bien comme ça. Le volume issued_data conserve la base de données, la configuration et les vignettes.
Si vous préférez Docker Compose, plus lisible quand on revient dessus six mois plus tard, créez un fichier docker-compose.yml :
services:
issued:
image: ghcr.io/metalogico/issued:latest
restart: unless-stopped
ports:
- "8181:8181"
volumes:
- ./data:/app/data
- /chemin/vers/vos/comics:/comics:ro
Puis lancez-le avec docker compose up -d. L'image existe aussi sur Docker Hub sous le nom metalogico/issued.
Bon point pour les NAS : si le dossier de BD n'est pas encore monté au démarrage (disques en cours de réveil, partage réseau en retard), Issued attend et ne touche pas à sa base. Le lecteur web et le catalogue OPDS ne démarrent qu'une fois la bibliothèque visible.
Sans Docker : les exécutables
Pas de Docker sur la machine ? Le développeur publie des exécutables pour macOS, Linux et Windows sur la page des versions GitHub. La mise en route se fait en trois commandes :
./issued init --library /chemin/vers/vos/comicspour déclarer le dossier ;./issued scanpour indexer les albums et créer les vignettes ;./issued servepour démarrer le serveur.
Sur macOS et Linux, pensez à rendre le fichier exécutable avec chmod +x. Sous Windows, placez issued.exe dans un dossier où vous avez le droit d'écrire (le Bureau par exemple), car il enregistre sa configuration, sa base et ses vignettes juste à côté. Évitez donc C:\Program Files. Pour lire les CBR en dehors de Docker, il faudra installer unrar, disponible chez RARLAB pour Windows ou via le gestionnaire de paquets sous macOS et Linux.
Les réglages utiles du fichier config.ini
Toute la configuration tient dans un fichier config.ini, placé dans le dossier de données (/app/data avec Docker). Voici les sections que j'ai trouvées les plus utiles.
- [library]
- Le chemin du dossier et le nom de la bibliothèque tel qu'il s'affichera dans les applications.
- [server]
- L'adresse d'écoute et le port, à changer si le 8181 est déjà pris par un autre service.
- [thumbnails]
- La taille et la qualité des vignettes, avec le choix entre JPEG et WebP (plus léger).
- [monitoring]
- La surveillance automatique du dossier. Désactivez-la si vous voulez laisser vos disques se mettre en veille : un bouton dans le lecteur web permet alors de relancer le scan à la main, et il affiche combien d'albums ont été ajoutés, modifiés ou supprimés.
- [reader]
- Un identifiant et un mot de passe pour protéger le lecteur web. Lisez bien la section suivante avant de compter dessus.
Côté ligne de commande, retenez aussi issued scan --force pour tout réindexer, issued thumbnails pour générer les vignettes manquantes et issued stats pour vérifier le nombre d'albums indexés. L'option --prune sert à vider la base quand vous avez réellement supprimé vos fichiers. Sans elle, Issued refuse d'effacer la bibliothèque si le dossier a l'air vide, ce qui évite une mauvaise surprise après un démontage accidentel.
Sécurité : le piège du catalogue OPDS
Voici le point le plus important de l'article. Le mot de passe défini dans config.ini protège uniquement le lecteur web. Le catalogue OPDS, lui, reste accessible sans authentification. Et c'est justement par ce catalogue qu'on télécharge les archives complètes.
N'ouvrez jamais le port 8181 de votre box vers Internet pour lire vos BD à l'extérieur. N'importe qui tombant sur l'adresse pourrait parcourir et télécharger toute votre bibliothèque via /opds/, même si le lecteur web est protégé par mot de passe.
Pour accéder à vos BD hors de chez vous, trois solutions propres existent :
- un VPN vers votre réseau local, comme WireGuard ou Tailscale, qui est très simple à mettre en place : votre téléphone se comporte alors comme s'il était à la maison ;
- un reverse proxy (nginx, Caddy, Traefik) qui ajoute sa propre authentification devant Issued, sur les deux chemins /reader/ et /opds/ ;
- ou tout simplement rester sur le réseau local et synchroniser quelques albums dans l'application avant de partir.
Si vous passez par un reverse proxy, la documentation donne un exemple nginx. Ne réécrivez pas les préfixes /reader et /opds, transmettez les en-têtes Host et X-Forwarded-Proto, et si le proxy tourne dans un autre conteneur, ajoutez la variable FORWARDED_ALLOW_IPS au conteneur Issued. Sans ça, les liens OPDS risquent de pointer vers une mauvaise adresse.
Grosses bibliothèques et performances
Le développeur indique faire tourner Issued avec environ 4 500 albums et estime qu'il devrait tenir jusqu'à 10 000, voire 20 000 fichiers. Deux choix techniques expliquent cette sobriété. Les vignettes ne sont générées qu'une seule fois, et sur un seul fil d'exécution, pour ne pas saturer un serveur qui fait souvent tourner d'autres conteneurs en parallèle. Et la surveillance du dossier peut être coupée, comme vu plus haut, pour ne pas réveiller les disques en permanence.
Le premier scan d'une grosse collection prend donc un peu de temps. Laissez-le travailler, les suivants ne traiteront que les nouveautés.
Un petit rappel au passage : Issued sert à lire une collection que vous possédez. Les albums achetés sans DRM, les BD numérisées depuis vos propres exemplaires ou les comics distribués légalement en CBZ par leurs auteurs y trouvent parfaitement leur place.
Issued, Komga ou Kavita : lequel choisir ?
Issued n'est pas seul sur ce créneau. Komga et Kavita sont deux références plus complètes, mais aussi plus lourdes. Voici comment je les situe.
| Critère | Issued | Komga | Kavita |
|---|---|---|---|
| Public visé | Lecteur solo qui veut garder ses dossiers | Collections de comics et mangas | Comics, mangas et livres |
| Plusieurs comptes | Non (un identifiant pour le lecteur web) | Oui | Oui, avec gestion des rôles |
| Ebooks (EPUB) | Non | Oui | Oui |
| Catalogue OPDS | Oui | Oui | Oui |
| Mise en route | Très rapide | Rapide | Rapide |
| Licence | MIT | MIT | GPL-3.0 |
En clair : si vous êtes seul à lire, avec un dossier de comics que vous ne voulez pas réorganiser, Issued fait exactement le travail sans fioritures. Dès qu'il faut plusieurs profils pour la famille, ou mélanger BD, mangas et romans, Komga ou Kavita prennent l'avantage.
Questions fréquentes
- Issued est-il gratuit ?
- Oui, totalement. Il est open source et distribué sous licence MIT.
- Faut-il réorganiser ma collection avant de l'installer ?
- Non. Seule règle : ne pas mélanger albums et sous-dossiers dans un même dossier, car un dossier contenant des BD est considéré comme une série.
- Puis-je lire mes BD depuis un smartphone ?
- Oui, soit via le lecteur web dans le navigateur, soit en ajoutant le catalogue OPDS dans une application comme Panels, Chunky Reader ou Moon+ Reader.
- Le mot de passe protège-t-il toute ma bibliothèque ?
- Non, uniquement le lecteur web. Le catalogue OPDS reste ouvert, d'où l'importance de passer par un VPN ou un reverse proxy authentifié pour un accès distant.
- Issued fonctionne-t-il sur un NAS ?
- Oui, c'est même son terrain de jeu idéal via Docker, tant que le NAS peut faire tourner des conteneurs.
- Peut-on lire des mangas ?
- S'ils sont au format CBZ, CBR, CB7 ou PDF, oui. Mais Issued n'a pas d'outils spécifiques aux mangas, contrairement à Komga ou Kavita.
Mon avis sur Issued
Issued fait peu de choses, et il les fait bien. Il respecte mon bazar, il démarre en une commande, il retrouve où j'en étais dans une série et il me signale les numéros manquants. Pour quelqu'un qui veut simplement lire ses BD depuis le canapé ou en déplacement, sans se lancer dans la configuration d'une usine à gaz, c'est exactement ce qu'il faut. Je garde seulement en tête sa limite principale : un catalogue OPDS sans authentification, qui impose un VPN ou un reverse proxy dès qu'on sort de chez soi.
Et si vous vous demandez pourquoi l'interface est entièrement violette, la réponse est dans le README : la fille du développeur s'appelle Violet. Je trouve ça plutôt touchant.
Comment cet article a-t-il été réalisé ? Le texte a été rédigé par mes soins, puis relu avec l'aide d'une intelligence artificielle afin de corriger d'éventuelles erreurs d'orthographe ou de grammaire. L'illustration de présentation a également été créée à l'aide de l'IA.
Articles qui pourraient vous intéresser
Plex ou Jellyfin en 2026 : pourquoi je passe au serveur multimédia open source
Regarder ses propres films, séries ou photos depuis son canapé comme on le ferait sur Netflix, c'est le principe d'un serveur multimédia. Pendant longtemps, Plex a été la réponse par défaut....
NAS domestique : 5 modèles pour sauvegarder photos et fichiers sans dépendre du cloud
Des années de photos de famille, des documents administratifs, des vidéos de vacances, des dossiers clients pour ceux qui travaillent à leur compte : tout ça finit par peser lourd. Le disque du...
Ni Synology ni DIY intégral : les boîtiers NAS prêts à l'emploi qui valent le coup en 2026
Vous voulez un NAS costaud sans payer le prix fort d'un Synology, mais l'idée de choisir une carte mère, une alimentation et un boîtier compatibles vous fatigue d'avance ? Je vous comprends. Ent...
Syncthing 2.1 : synchroniser ses dossiers entre PC, Mac, Linux et serveur sans passer par le cloud
Garder les mêmes fichiers à jour sur un PC fixe, un portable et un serveur, tout le monde l'a fait un jour avec Dropbox, OneDrive ou Google Drive. Ça marche, mais vos documents passent par les s...
Ancien routeur : 7 façons de lui offrir une seconde vie, à la maison comme au bureau
Un changement d'opérateur, une montée en débit, un passage à la fibre… et voilà un routeur de plus qui finit au fond d'un tiroir. C'est dommage, parce qu'un appareil qui ne suffit plus comme...
SlopTotal, le détecteur de texte IA open source : fiable ou pas ?
Un projet qui se présente comme le « VirusTotal du texte IA », forcément, ça a attiré mon attention. SlopTotal promet de dire si un texte a été rédigé par une intelligence artificielle en...
Port M.2 libre : 6 cartes d'extension à installer à la place d'un SSD
Quand j'ouvre un PC ou un mini-PC, je tombe souvent sur un emplacement M.2 vide. Par réflexe, on se dit qu'il attend un SSD. Pourtant, un slot M.2, c'est d'abord une liaison PCIe (d'une à quatre ...
GEAK OS : le nouveau système NAS gratuit venu de Chine vaut-il le détour ?
La liste des systèmes pour NAS DIY s'allonge encore. Après fnOS et FygoOS, c'est au tour de GEAK OS de se faire une place. Ce ...
WireGuard maison : comment créer son propre VPN pour accéder à son réseau à distance
On me demande régulièrement comment « créer un VPN », comme si la question avait une seule réponse. En réalité, ça recouvre deux projets qui n'ont pas grand-chose en commun. Le premier con...
