Audiobookshelf: como criar seu próprio servidor de audiolivros e podcasts

Começar a ouvir um livro no computador, continuar do mesmo ponto no celular, baixá-lo antes de uma viagem e não perder o progresso ao trocar de dispositivo — para tudo isso, não é necessário depender de mais um serviço pago. O Audiobookshelf transforma sua própria coleção de arquivos de áudio em uma biblioteca on-line organizada, com capas, capítulos, aplicativos e perfis separados para toda a família.

Ele não é uma loja nem uma fonte de livros gratuitos. O próprio usuário adiciona arquivos de áudio obtidos legalmente e sem uma proteção DRM incompatível. Em compensação, os livros, o histórico de reprodução e as configurações permanecem em seu próprio servidor.

O que é o Audiobookshelf

O Audiobookshelf é um servidor gratuito, de código aberto e auto-hospedado para audiolivros e podcasts. Ele verifica as pastas com arquivos de mídia, organiza a biblioteca por autores e séries, busca metadados e capas e, em seguida, permite ouvir a coleção pelo navegador ou por um aplicativo móvel.

Na prática, é um serviço pessoal de streaming cujo catálogo é montado por você. O servidor armazena a biblioteca e o progresso, enquanto o celular, o tablet ou o computador funcionam como clientes. Assim, é possível interromper um livro em um dispositivo e continuar em outro a partir da posição salva.

O Audiobookshelf pode ser executado em casa, em um NAS ou minicomputador. Um VPS é mais conveniente quando você precisa acessar a biblioteca de qualquer rede sem deixar um computador doméstico ligado, configurar o redirecionamento de portas ou depender da conexão de Internet de casa.

O que o Audiobookshelf pode fazer

Sincronizar o progresso entre dispositivos

A posição, o histórico e os marcadores são salvos separadamente para cada usuário. Estão disponíveis uma interface Web, um Progressive Web App e clientes móveis oficiais para Android e iOS. Também é possível baixar um livro previamente para o celular e ouvi-lo sem Internet.

Criar contas separadas

É possível criar vários usuários em um único servidor sem misturar o progresso de cada um. O administrador define o acesso às bibliotecas e as permissões e, quando necessário, restringe o conteúdo por meio de etiquetas. Cada pessoa mantém sua própria lista de livros iniciados, seu histórico e seus marcadores.

Organizar a biblioteca

O serviço obtém títulos, descrições, autores e capas de fontes externas, agrupa os livros por autores e séries e permite corrigir os capítulos e a ordem das faixas. Vários arquivos MP3 podem ser unidos em um único M4B, enquanto a capa e os metadados podem ser incorporados ao arquivo. Antes de alterar os arquivos originais, é melhor fazer uma cópia da biblioteca.

Baixar podcasts automaticamente

Um podcast pode ser adicionado pelo nome, por um link RSS ou por um arquivo OPML. Depois disso, é possível programar o download de novos episódios. O serviço não transmite o episódio diretamente: primeiro, o arquivo é salvo no servidor. Isso permite arquivar episódios que podem desaparecer, mas exige espaço em disco.

Manter a versão digital junto do audiolivro

É possível colocar um arquivo EPUB, PDF, CBR, CBZ, AZW3 ou MOBI na pasta do livro para abrir o áudio e o texto a partir da mesma ficha. O leitor integrado é básico e não substitui o Calibre-Web nem o Kavita.

Para quem o Audiobookshelf é indicado

O serviço é especialmente útil em vários cenários:

• você já tem uma coleção de audiolivros em MP3, M4B, M4A ou outros formatos comuns;
• você ouve em vários dispositivos e deseja sincronização;
• vários membros da família usam a biblioteca;
• você precisa preservar seu próprio arquivo de podcasts;
• você quer controlar por conta própria os arquivos, as contas de usuário e os backups;
• uma pasta comum na nuvem já se tornou inconveniente por não ter capas, capítulos e histórico de reprodução.

Se você ouve apenas um ou dois livros em um único celular, talvez um servidor separado seja desnecessário. O Audiobookshelf mostra todo o seu potencial quando a coleção cresce ou precisa de acesso remoto permanente.

Qual servidor é necessário para o Audiobookshelf

O projeto não possui um requisito mínimo oficial universal: a carga depende do tamanho da biblioteca, do número de usuários, da verificação dos arquivos e da necessidade de transcodificar o áudio. Para uma pequena coleção pessoal, a configuração inicial abaixo pode servir de referência:

Cenário	CPU	RAM	Disco
1–2 usuários, biblioteca pequena	1 vCPU	1 GB	a partir de 30–40 GB
Família e várias conexões simultâneas	2 vCPU	2 GB	a partir de 60–100 GB
Biblioteca grande, verificações frequentes e processamento de arquivos	2–4 vCPU	4 GB	de acordo com o tamanho da coleção

Essa é uma referência prática, não um requisito mínimo oficial. O principal recurso é o disco. Um livro de dez horas a 64–128 Kbit/s ocupa aproximadamente 0,3–0,6 GB; portanto, cem livros exigirão cerca de 30–60 GB, sem contar podcasts e cópias de segurança. É sensato começar com um VPS pequeno que possa ser ampliado depois.

Como instalar o Audiobookshelf com Docker Compose

O Docker é o método de instalação recomendado pelos desenvolvedores. Vamos considerar que o Docker e o plugin Compose já estejam instalados no Ubuntu ou Debian.

Crie o diretório do projeto e as pastas de dados:

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

Crie o arquivo 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

Inicie o contêiner:

docker compose up -d

Após a inicialização, o painel ficará temporariamente disponível no endereço:

http://SERVER_IP:13378

No primeiro acesso, crie o administrador raiz, depois adicione uma biblioteca do tipo Books e informe o diretório /audiobooks. Para os podcasts, crie uma biblioteca separada com o caminho /podcasts.

Como organizar corretamente os audiolivros em pastas

No Audiobookshelf, um livro normalmente corresponde a uma pasta. A estrutura mais clara é esta:

/audiobooks/
  Autor/
    Série/
      01 - Título do livro/
        01 - Capítulo.mp3
        02 - Capítulo.mp3
        cover.jpg

Para um livro avulso, o nível da série pode ser omitido. Um único arquivo M4B também pode ficar em sua própria pasta de livro.

A estrutura é importante: se vários livros do mesmo autor forem colocados em uma única pasta geral, o scanner poderá reuni-los em uma só ficha. É melhor organizar os arquivos antes da primeira verificação completa. Mover um livro entre bibliotecas é interpretado como a criação de um novo objeto; por isso, seus metadados e seu progresso não são transferidos automaticamente.

Como disponibilizar a biblioteca na Internet com segurança

Não é recomendável deixar o painel permanentemente exposto na porta HTTP aberta 13378. Para acesso remoto, é melhor configurar um domínio, um certificado HTTPS e um proxy reverso baseado em Nginx, Caddy ou Traefik.

O Audiobookshelf usa WebSocket, portanto o suporte a ele deve ser habilitado no proxy. Depois de configurar o HTTPS, a porta do contêiner pode ser vinculada apenas à interface local:

ports:
  - "127.0.0.1:13378:80"

Use senhas exclusivas, crie uma conta separada para cada ouvinte, mantenha o contêiner atualizado e não conceda permissões de administrador sem necessidade.

O que é preciso saber sobre backups

Os backups integrados do Audiobookshelf salvam o banco de dados e parte dos metadados, incluindo as capas do diretório metadata. Os próprios audiolivros, os podcasts e as capas armazenadas junto aos arquivos de mídia não entram nesse backup.

Por isso, uma estratégia de backup confiável é composta por duas partes:

1. backup automático integrado do banco de dados e dos metadados;
2. uma cópia separada dos diretórios audiobooks e podcasts em outro disco ou em um armazenamento remoto.

O diretório /config contém o banco de dados SQLite. Os desenvolvedores recomendam mantê-lo em um disco local do mesmo servidor, em vez de montá-lo pela rede: o armazenamento em rede pode reduzir o desempenho e causar danos ao banco de dados.

Audiobookshelf em um VPS da tropic.host

Para uma biblioteca pessoal, a potência máxima de processamento é menos importante do que a disponibilidade contínua, o espaço suficiente em disco e uma conexão estável. Em um VPS, o Audiobookshelf funciona 24 horas por dia e permanece acessível pelo celular, computador ou tablet, independentemente do estado da rede doméstica.

Para uma coleção pequena, você pode começar com um servidor básico da tropic.host, instalar o Docker, conectar um domínio e o HTTPS e, depois, ampliar os recursos à medida que a biblioteca crescer. Ao escolher o plano, estime primeiro o volume dos arquivos de áudio e reserve espaço para novos livros e podcasts.

Limitações que é melhor conhecer com antecedência

O Audiobookshelf não fornece um catálogo de livros nem remove a proteção DRM. Ele trabalha com arquivos que o próprio usuário adicionou e tem o direito de armazenar.

Os aplicativos móveis estão em desenvolvimento ativo e oficialmente continuam com status beta; por isso, a interface Web ou o PWA seguem sendo alternativas úteis. O suporte a livros digitais é básico, e a importação organizada de uma grande coleção exige respeitar a estrutura de pastas e, às vezes, corrigir os metadados manualmente.

Para audiolivros, o serviço oferece aquilo que falta em uma pasta comum na nuvem: capítulos, séries, progresso, download off-line, perfis e suporte a podcasts.

Resumo

O Audiobookshelf transforma arquivos de áudio em uma biblioteca de mídia pessoal para diferentes dispositivos e usuários. A instalação com Docker Compose é simples, mas o funcionamento confiável exige uma estrutura de pastas organizada, HTTPS e backups separados dos arquivos de mídia.

FAQ

O Audiobookshelf é gratuito?

Sim. O servidor e os clientes oficiais são distribuídos como software de código aberto. Você só precisa pagar pelo hardware, VPS, domínio ou armazenamento adicional, caso sejam utilizados.

O Audiobookshelf fornece audiolivros gratuitos?

Não. Ele é um servidor e reprodutor para sua própria coleção. Os arquivos de áudio devem ser obtidos legalmente e adicionados à biblioteca pelo próprio usuário.

É possível ouvir livros sem Internet?

Sim. O aplicativo móvel permite baixar previamente um livro para o dispositivo. Depois do download, a conexão com o servidor não é necessária para a reprodução em si.

De quanta memória RAM o Audiobookshelf precisa?

Para uma biblioteca pequena e um ou dois usuários, 1 GB de RAM é um ponto de partida razoável. Para vários ouvintes, verificações extensas ou processamento de arquivos, é melhor escolher 2–4 GB.

É obrigatório instalar o Audiobookshelf em um VPS?

Não. Ele pode ser executado em um servidor doméstico, NAS ou computador compatível. Um VPS é mais conveniente quando você precisa de acesso 24 horas por dia a partir de diferentes redes, sem configurar o roteador doméstico nem depender da conexão de casa.