Audiobookshelf: come creare il proprio server di audiolibri e podcast

Iniziare ad ascoltare un libro sul computer, riprendere dallo stesso punto sul telefono, scaricarlo prima di un viaggio e non perdere i progressi dopo aver cambiato dispositivo: per fare tutto questo non è necessario dipendere dall’ennesimo servizio a pagamento. Audiobookshelf trasforma la propria raccolta di file audio in una libreria online ordinata, con copertine, capitoli, applicazioni e profili separati per tutta la famiglia.

Non è un negozio né una fonte di libri gratuiti. L’utente aggiunge personalmente file audio ottenuti legalmente e privi di una protezione DRM incompatibile. In compenso, i libri, la cronologia di ascolto e le impostazioni rimangono sul suo server.

Che cos’è Audiobookshelf

Audiobookshelf è un server gratuito, open source e self-hosted per audiolibri e podcast. Analizza le cartelle contenenti i file multimediali, organizza la libreria per autori e serie, recupera metadati e copertine e permette poi di ascoltare la raccolta tramite browser o applicazione mobile.

In sostanza, è un servizio di streaming personale il cui catalogo viene creato dall’utente. Il server conserva la libreria e i progressi, mentre telefono, tablet o computer fungono da client. È quindi possibile interrompere un libro su un dispositivo e riprenderlo su un altro dalla posizione salvata.

Audiobookshelf può essere eseguito a casa su un NAS o un mini computer. Un VPS è più comodo quando occorre accedere da qualsiasi rete senza lasciare acceso un computer domestico, configurare l’inoltro delle porte o dipendere dalla connessione Internet di casa.

Che cosa può fare Audiobookshelf

Sincronizzare i progressi tra dispositivi

Per ogni utente vengono salvati separatamente posizione, cronologia e segnalibri. Sono disponibili un’interfaccia web, una Progressive Web App e client mobili ufficiali per Android e iOS. È inoltre possibile scaricare in anticipo un libro sul telefono e ascoltarlo senza connessione Internet.

Creare account separati

Su un unico server si possono creare più utenti senza mescolare i rispettivi progressi. L’amministratore definisce l’accesso alle librerie e i permessi e, se necessario, limita i contenuti tramite tag. Ogni persona mantiene il proprio elenco di libri iniziati, la cronologia e i segnalibri.

Mettere ordine nella libreria

Il servizio recupera titoli, descrizioni, autori e copertine da fonti esterne, raggruppa i libri per autori e serie e consente di correggere i capitoli e l’ordine delle tracce. Più file MP3 possono essere uniti in un unico M4B, mentre copertina e metadati possono essere incorporati nel file. Prima di modificare gli originali è preferibile creare una copia della libreria.

Scaricare automaticamente i podcast

Un podcast può essere aggiunto tramite il nome, un link RSS o un file OPML; in seguito è possibile programmare il download dei nuovi episodi. Il servizio non trasmette direttamente la puntata: il file viene prima salvato sul server. In questo modo si possono archiviare episodi che potrebbero scomparire, ma serve spazio su disco.

Conservare la versione elettronica accanto all’audiolibro

Nella cartella del libro è possibile inserire un file EPUB, PDF, CBR, CBZ, AZW3 o MOBI, così da aprire audio e testo dalla stessa scheda. Il lettore integrato è essenziale e non sostituisce Calibre-Web o Kavita.

A chi è adatto Audiobookshelf

Il servizio è particolarmente utile in diversi scenari:

• si possiede già una raccolta di audiolibri in MP3, M4B, M4A o altri formati comuni;
• si ascolta da più dispositivi e si desidera la sincronizzazione;
• più membri della famiglia utilizzano la libreria;
• occorre conservare un archivio personale di podcast;
• si desidera controllare personalmente file, account utente e backup;
• una normale cartella nel cloud è diventata scomoda per l’assenza di copertine, capitoli e cronologia di ascolto.

Se si ascoltano soltanto uno o due libri su un unico telefono, un server dedicato potrebbe essere superfluo. Audiobookshelf esprime tutto il suo potenziale quando la raccolta cresce o richiede un accesso remoto continuo.

Quale server serve per Audiobookshelf

Il progetto non indica un requisito minimo ufficiale valido per tutti: il carico dipende dalle dimensioni della libreria, dal numero di utenti, dalla scansione dei file e dall’eventuale necessità di transcodificare l’audio. Per una piccola raccolta personale si può usare come riferimento la seguente configurazione iniziale:

Scenario	CPU	RAM	Disco
1–2 utenti, piccola libreria	1 vCPU	1 GB	da 30–40 GB
Famiglia e più connessioni simultanee	2 vCPU	2 GB	da 60–100 GB
Grande libreria, scansioni frequenti ed elaborazione dei file	2–4 vCPU	4 GB	in base alle dimensioni della raccolta

Si tratta di un riferimento pratico, non di un minimo ufficiale. La risorsa principale è il disco. Un libro di dieci ore a 64–128 Kbit/s occupa circa 0,3–0,6 GB; cento libri richiederanno quindi circa 30–60 GB, senza considerare podcast e copie. È ragionevole iniziare con un VPS piccolo che possa essere ampliato in seguito.

Come installare Audiobookshelf tramite Docker Compose

Docker è il metodo di installazione consigliato dagli sviluppatori. Supponiamo che Docker e il plugin Compose siano già installati su Ubuntu o Debian.

Create la directory del progetto e le cartelle per i dati:

mkdir -p /opt/audiobookshelf/{config,metadata,audiobooks,podcasts}
cd /opt/audiobookshelf

Create il file compose.yml:

services:
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    container_name: audiobookshelf
    ports:
      - "13378:80"
    volumes:
      - ./config:/config
      - ./metadata:/metadata
      - ./audiobooks:/audiobooks
      - ./podcasts:/podcasts
    environment:
      - TZ=UTC
    restart: unless-stopped

Avviate il container:

docker compose up -d

Dopo l’avvio, il pannello sarà temporaneamente disponibile all’indirizzo:

http://SERVER_IP:13378

Al primo accesso create l’amministratore root, quindi aggiungete una libreria di tipo Books e indicate la directory /audiobooks. Per i podcast, create una libreria separata con il percorso /podcasts.

Come organizzare correttamente gli audiolibri nelle cartelle

In Audiobookshelf, di norma un libro corrisponde a una cartella. La struttura più chiara è la seguente:

/audiobooks/
  Autore/
    Serie/
      01 - Titolo del libro/
        01 - Capitolo.mp3
        02 - Capitolo.mp3
        cover.jpg

Per un libro indipendente si può omettere il livello della serie. Anche un singolo file M4B può essere conservato nella propria cartella del libro.

La struttura è importante: se più libri dello stesso autore vengono inseriti in una cartella comune, lo scanner potrebbe unirli in un’unica scheda. È meglio ordinare i file prima della prima scansione completa. Lo spostamento di un libro tra librerie viene interpretato come la creazione di un nuovo oggetto, quindi metadati e progressi non vengono trasferiti automaticamente.

Come rendere accessibile la libreria da Internet in modo sicuro

Non è consigliabile lasciare permanentemente il pannello esposto sulla porta HTTP aperta 13378. Per l’accesso remoto è preferibile configurare un dominio, un certificato HTTPS e un reverse proxy basato su Nginx, Caddy o Traefik.

Audiobookshelf utilizza WebSocket, quindi il relativo supporto deve essere abilitato nel proxy. Dopo aver configurato HTTPS, la porta del container può essere associata soltanto all’interfaccia locale:

ports:
  - "127.0.0.1:13378:80"

Utilizzate password uniche, create un account separato per ogni ascoltatore, mantenete aggiornato il container e non assegnate privilegi di amministratore non necessari.

Che cosa bisogna sapere sui backup

I backup integrati di Audiobookshelf salvano il database e una parte dei metadati, comprese le copertine della directory metadata. Gli audiolibri, i podcast e le copertine conservate accanto ai file multimediali non vengono inclusi in questo backup.

Una strategia di backup affidabile è quindi composta da due parti:

1. il backup automatico integrato del database e dei metadati;
2. una copia separata delle directory audiobooks e podcasts su un altro disco o in uno spazio di archiviazione remoto.

La directory /config contiene il database SQLite. Gli sviluppatori consigliano di conservarla su un disco locale dello stesso server, anziché montarla tramite rete: lo spazio di archiviazione di rete può ridurre le prestazioni e causare il danneggiamento del database.

Audiobookshelf su un VPS di tropic.host

Per una libreria personale, la massima potenza di calcolo conta meno della disponibilità continua, di uno spazio su disco sufficiente e di una connessione stabile. Su un VPS Audiobookshelf funziona 24 ore su 24 ed è accessibile da telefono, computer o tablet indipendentemente dallo stato della rete domestica.

Per una piccola raccolta si può iniziare con un server di base tropic.host, installare Docker, collegare un dominio e HTTPS e poi aumentare le risorse man mano che la libreria cresce. Nella scelta del piano, valutate prima di tutto il volume dei file audio e prevedete spazio per nuovi libri e podcast.

Limiti che è meglio conoscere in anticipo

Audiobookshelf non fornisce un catalogo di libri e non rimuove la protezione DRM. Funziona con file che l’utente ha aggiunto personalmente e che ha il diritto di conservare.

Le applicazioni mobili sono sviluppate attivamente e mantengono ufficialmente lo stato di beta; l’interfaccia web o la PWA restano quindi valide soluzioni alternative. Il supporto agli e-book è basilare e, per importare in modo ordinato una grande raccolta, è necessario rispettare la struttura delle cartelle e talvolta correggere manualmente i metadati.

Per gli audiolibri, il servizio offre ciò che manca a una normale cartella nel cloud: capitoli, serie, avanzamento, download offline, profili e gestione dei podcast.

In breve

Audiobookshelf trasforma i file audio in una mediateca personale per più dispositivi e utenti. L’installazione tramite Docker Compose è semplice, ma per un funzionamento affidabile servono una struttura ordinata delle cartelle, HTTPS e copie separate dei file multimediali.

FAQ

Audiobookshelf è gratuito?

Sì. Il server e i client ufficiali sono distribuiti come software open source. Si pagano soltanto l’hardware, il VPS, il dominio o lo spazio di archiviazione aggiuntivo, se utilizzati.

Audiobookshelf fornisce audiolibri gratuiti?

No. È un server e un lettore per la propria raccolta. I file audio devono essere ottenuti legalmente e aggiunti personalmente alla libreria.

È possibile ascoltare i libri senza Internet?

Sì. L’applicazione mobile consente di scaricare in anticipo un libro sul dispositivo. Dopo il download, per l’ascolto non è necessaria una connessione al server.

Quanta RAM serve ad Audiobookshelf?

Per una piccola libreria e uno o due utenti, 1 GB di RAM è un punto di partenza ragionevole. Per più ascoltatori, scansioni estese o elaborazione dei file, è meglio scegliere 2–4 GB.

È obbligatorio installare Audiobookshelf su un VPS?

No. Può essere eseguito su un server domestico, un NAS o un computer compatibile. Un VPS è più comodo quando serve un accesso continuo da reti diverse senza configurare il router di casa né dipendere dalla connessione domestica.