ChaptarrNG è un progetto open source dedicato alla gestione delle biblioteche digitali, con funzionalità per organizzare ebook e audiolibri, automatizzare le importazioni e integrare diversi servizi utilizzati negli ambienti self-hosted. Il software è sviluppato e mantenuto da Snapetech come fork di Chaptarr, un gestore di librerie digitali derivato dal progetto Readarr.
L’obiettivo principale è offrire uno strumento capace di semplificare la gestione di una raccolta di libri digitali su un server personale, mantenendo una particolare attenzione all’integrazione con SeerrNG, applicazione utilizzata per gestire le richieste di contenuti. ChaptarrNG può comunque funzionare autonomamente, senza richiedere l’installazione di SeerrNG.
Il progetto è particolarmente interessante per chi utilizza un NAS, un homelab o un server domestico per organizzare i propri contenuti digitali. Attraverso un’interfaccia dedicata, permette di gestire le librerie, recuperare informazioni bibliografiche, organizzare le serie e controllare il modo in cui i file vengono importati e rinominati.
Il software è distribuito con licenza GPL-3.0 e utilizza .NET 10 LTS per il backend. Gli sviluppatori sottolineano che ChaptarrNG è ancora in fase beta e che lo sviluppo è attivo: alcune modifiche potrebbero quindi introdurre cambiamenti incompatibili con le configurazioni precedenti. È consigliabile effettuare backup regolari prima di utilizzarlo con una biblioteca importante.
Gestione di ebook e audiolibri con automazione e metadati
Una delle caratteristiche più interessanti di ChaptarrNG è la possibilità di gestire separatamente ebook e audiolibri, mantenendo una struttura flessibile per le cartelle e le raccolte. L’utente può scegliere directory principali distinte oppure organizzare i libri elettronici insieme agli audiolibri, adattando la configurazione alle proprie esigenze.
Il programma utilizza informazioni provenienti dai file, dai tag e dai dati delle edizioni per migliorare l’identificazione dei titoli. Sono disponibili strumenti per organizzare automaticamente le serie, personalizzare i nomi dei file e configurare profili di metadati, con preferenze relative alle lingue, alle edizioni e alle denominazioni utilizzate per le raccolte.
Per gli audiolibri sono previste funzionalità specifiche che vanno oltre la semplice archiviazione. ChaptarrNG gestisce file M4B, audiolibri suddivisi in più file e registrazioni MP3 con capitoli. Include inoltre la possibilità di convertire file MP3 in M4B, conservando i capitoli esistenti oppure aggiungendoli quando mancano, con indicazioni sullo stato dell’operazione e la possibilità di annullare la conversione.
Il software offre anche strumenti per automatizzare la gestione delle importazioni. Le liste possono essere controllate prima della sincronizzazione, mentre lo storico delle operazioni aiuta a verificare i risultati e a individuare eventuali problemi. Sono previste verifiche sulle destinazioni dei file per ridurre il rischio di sovrascrivere contenuti già presenti.
L’integrazione con altri servizi amplia ulteriormente le possibilità di utilizzo. ChaptarrNG può collegarsi ad AudioBookShelf, Calibre Content Server e Grimmory per specifiche operazioni di sincronizzazione, importazione e gestione dei metadati. Può inoltre aggiornare le librerie di Emby e Jellyfin dopo l’importazione di nuovi contenuti.
Un’altra funzionalità è il supporto per RanobeDB, pensato per la ricerca di metadati relativi alle light novel. La disponibilità di questa integrazione permette di gestire anche raccolte specializzate, tenendo conto delle condizioni d’uso e delle limitazioni del servizio esterno.
Installazione Docker e integrazione con SeerrNG
ChaptarrNG è progettato principalmente per l’esecuzione tramite Docker, che rappresenta attualmente il metodo di installazione supportato dal progetto. Il repository mette a disposizione immagini container dedicate e una configurazione per Docker Compose, facilitando la distribuzione su server Linux e sistemi NAS compatibili.
L’installazione prevede la configurazione di percorsi persistenti per i dati dell’applicazione, gli ebook, gli audiolibri e i download. La porta predefinita dell’interfaccia web è la 8789. È importante configurare correttamente i permessi delle directory affinché il container possa leggere, scrivere e organizzare i file senza incontrare errori. Basta digitare da terminale:
sudo docker run -d
--name chaptarrng
-p 127.0.0.1:8789:8789
-e PUID=1000
-e PGID=1000
-v /path/to/config:/config
-v /path/to/audiobooks:/audiobooks
-v /path/to/ebooks:/ebooks
-v /path/to/downloads:/downloads
--restart unless-stopped
ghcr.io/snapetech-org/chaptarrng:latestPer chi utilizza SeerrNG, il vantaggio principale consiste nella possibilità di collegare le richieste di ebook e audiolibri al backend bibliotecario. ChaptarrNG espone API compatibili con le esigenze di integrazione del progetto, consentendo di distinguere i formati richiesti e seguire le importazioni che richiedono tempo per completare l’elaborazione dei metadati.
Il software comprende anche un indicizzatore e un client di download opzionali per gli ebook. Questi strumenti possono interrogare le fonti configurate dall’utente e supportare download tramite API oppure collegamenti assistiti dal browser, quando disponibili. La funzionalità è limitata agli ebook e non sostituisce un sistema generale per il download di qualsiasi contenuto.
Sul fronte dell’amministrazione, sono presenti ulteriori strumenti per l’automazione e il monitoraggio. Il supporto MQTT permette di pubblicare eventi e informazioni sullo stato della libreria, con possibilità di integrazione con Home Assistant. Un endpoint dedicato a Prometheus consente invece di raccogliere metriche per controllare il funzionamento del servizio.
Gli utenti più esperti possono configurare anche PostgreSQL al posto del database SQLite predefinito, scegliendo una soluzione più adatta alle proprie necessità operative. È disponibile inoltre un modello dedicato per Unraid, utile a chi gestisce un server domestico attraverso questa piattaforma.
ChaptarrNG rappresenta quindi una soluzione da valutare per chi desidera centralizzare la gestione di ebook e audiolibri, soprattutto in presenza di una biblioteca digitale articolata e di altri servizi multimediali. Considerando lo stato beta, è opportuno verificare le funzionalità effettivamente presenti nella versione scelta e mantenere copie di sicurezza della configurazione e dei file prima di avviare importazioni su larga scala. Abbiamo testato ChaptarrNG su Linux Mint 22.3 Zena.