Como instalar o Audiobookshelf na Saplo: a tua biblioteca de audiobooks e podcasts

Tens livros áudio no teu computador, mais alguns no telemóvel e, depois de mudares de dispositivo, procuras o ponto em que ficou a escuta. O Audiobookshelf reúne a tua biblioteca de áudio num só lugar e permite retomar a escuta sem teres de guardar manualmente o número do capítulo. Neste guia, mostramos como instalar o Audiobookshelf no Saplo, adicionar o primeiro livro e testar a reprodução.

O que oferece o seu próprio Audiobookshelf

O Audiobookshelf é um servidor de código aberto de audiobooks e podcasts. Disponibiliza um leitor no navegador, memoriza o progresso separadamente para cada utilizador e sincroniza-o entre dispositivos. Também permite transferir episódios de podcasts e organizar livros através de metadados e capas. As funcionalidades do projeto estão descritas na documentação oficial do Audiobookshelf.

Começas com os teus próprios ficheiros. A instalação não inclui um catálogo de audiobooks pagos nem uma assinatura de uma loja de livros. Prepara as gravações que podes reproduzir fora da aplicação do vendedor, por exemplo, ficheiros MP3 ou M4B.

Requisitos e hosting do Audiobookshelf na Saplo

O plano mais barato que cumpre os requisitos mínimos da receita é Box S a 27 € por ano. Este é o ponto de partida para colocar a aplicação em funcionamento. O tamanho da coleção e o número de ouvintes simultâneos influenciam os recursos necessários durante a utilização diária.

Antes da instalação, prepara um Box ativo com espaço livre, o nome da aplicação e um livro áudio para testar. Move a biblioteca grande só depois de verificares a primeira gravação. Leva em conta que os ficheiros de áudio partilham o disco do Box com o sistema e as restantes aplicações, por isso, nem toda a capacidade do plano ficará disponível para livros.

A instalação a partir do Catálogo de aplicações não exige SSH nem a criação manual de uma base de dados. A receita utiliza a base de dados SQLite própria da aplicação. Podes encontrar a descrição do serviço na página de hosting do Audiobookshelf na Saplo.

Instalação passo a passo

1. Inicia sessão no Painel Saplo e abre o Catálogo de aplicações. Procura Audiobookshelf.
2. Dá um nome à aplicação, seleciona Box e escolhe um endereço para a aplicação, por exemplo, um subdomínio *.saploapp.pl.
3. Confirma a instalação. Saplo inicia a aplicação e configura o acesso através de um Domínio com certificado SSL.
4. Aguarda a conclusão da instalação no Painel e depois abre o endereço da aplicação através de HTTPS. O tempo depende, entre outros fatores, da descarga da imagem e da carga do servidor.
5. Na primeira entrada, segue o assistente para criar a Conta de administrador Root. Escolhe um nome de utilizador e uma palavra-passe forte e única. Faz isso imediatamente após a instalação, pois a primeira Conta recebe permissões de administrador.
6. Guarda o endereço do servidor e os dados de início de sessão no gestor de palavras-passe. Esta é a Conta do Audiobookshelf, distinta da Conta no Painel Saplo.

O guia deixa também as instruções AUDIOBOOKSHELF-SETUP.txt no Catálogo de aplicações. Não inclui uma palavra-passe de administrador predefinida: defines tu no assistente.

Adição de uma biblioteca e do primeiro livro

Nas definições do Audiobookshelf, adiciona uma biblioteca de livros, dá-lhe um nome, por exemplo, «Audiobooki», e indica a pasta /audiobooks. Este é o caminho visível dentro da aplicação. A receita do Saplo liga-a à pasta audiobooks no diretório da tua instalação no Box.

De seguida, utiliza a funcionalidade de carregamento de ficheiros no Audiobookshelf:

1. Escolhe a biblioteca onde o livro deve ser colocado.
2. Carrega um único ficheiro M4B ou uma pasta com todas as partes de um único livro.
3. Aguarda que o carregamento termine e que o item apareça na lista.
4. Abre o livro e verifica o título e a ordem das partes.

Carrega um livro dividido em vários ficheiros MP3 como uma pasta completa. Adicionar os mesmos ficheiros individualmente pode criar vários livros em vez de um. Os detalhes estão descritos na instrução de carregamento de ficheiros do Audiobookshelf.

Uma coleção maior também pode ser transferida através do gestor de ficheiros no painel do Saplo para a pasta audiobooks da tua aplicação. Mantém uma pasta separada para cada livro. Se, depois de transferires os ficheiros, a lista não mudar, inicia a análise da biblioteca no Audiobookshelf e verifica o caminho indicado.

Capas, autores e ordem dos volumes

Após a importação, confere alguns itens: se o título não é o nome do ficheiro, se o autor foi reconhecido corretamente e se as partes seguintes da gravação estão na ordem certa. A verificação automática lê os metadados locais. A correspondência entre o livro e uma fonte externa de metadados é feita separadamente, por isso a ausência de uma capa logo após o carregamento não indica um erro de instalação. As regras estão descritas na documentação das bibliotecas de livros do Audiobookshelf.

Na prática, começa por um livro em vários volumes. Depois de uma importação bem-sucedida, é mais fácil aplicar a mesma estrutura de pastas ao resto da coleção.

Primeira audição e contas dos membros da família

Abre o audiolivro no navegador, desloca-te até ao fragmento selecionado e, em seguida, pausa a reprodução. Abre a mesma instalação noutro navegador ou no telemóvel e inicia sessão na mesma conta. Verifica se consegues continuar a partir do ponto guardado. É um teste simples que vale a pena fazer antes de mover todo o arquivo.

Para cada pessoa adicional, cria uma conta separada nas definições de utilizadores do Audiobookshelf. Para escutar, basta uma conta de utilizador normal. Dá-lhe acesso às bibliotecas relevantes. Com contas separadas, os membros da família não substituem o progresso uns dos outros no mesmo audiolivro. As funções e as restrições de acesso estão explicadas na documentação de gestão de utilizadores.

Podcasts numa biblioteca separada

Para podcasts, cria uma biblioteca separada do tipo adequado e indica a pasta /podcasts, preparada segundo a receita da Saplo. Audiobookshelf permite pesquisar podcasts e descarregar os seus episódios. Começa por um programa e pela descarga manual do episódio escolhido, antes de ativas a descarga automática.

Verifica regularmente o espaço ocupado no disco. O arquivo de um podcast com muitos episódios pode crescer rapidamente, sobretudo quando descargas várias séries ao mesmo tempo.

Cópias de segurança da biblioteca

A cópia de segurança integrada do Audiobookshelf inclui a base de dados da aplicação e as capas guardadas no diretório de metadados. Não inclui os ficheiros de audiolivros nem de podcasts. Por isso, mantém as gravações originais fora do Box e faz também, em separado, uma cópia de segurança dos dados da aplicação. O âmbito das cópias de segurança integradas está descrito na documentação de gestão do servidor.

Antes de uma importação de grande dimensão ou de uma atualização, verifica se tens cópias de segurança atualizadas e se consegues encontrá-las fora da instalação em funcionamento. A lista de livros visível não substitui, por si só, uma cópia de segurança dos ficheiros de áudio.

Perguntas frequentes

Quanto custa começar?

O plano mais barato que cumpre os requisitos mínimos é Box S por 27 € por ano. Ao planeares o espaço, conta também com as tuas próprias gravações e outras aplicações no Box.

Preciso de SSH?

Não para a instalação descrita e para a primeira configuração. Executas a aplicação no painel do Saplo, crias a conta no navegador e adicionas livros através do upload integrado ou do gestor de ficheiros.

Porque não vejo o livro carregado?

Verifica se os ficheiros foram para a pasta atribuída à biblioteca correta. Para os audiolivros nesta instalação, é /audiobooks. Executa a análise e verifica se a conta tem acesso à biblioteca.

O que fazer quando a aplicação não responde após a instalação?

Verifica o Estado da aplicação no painel do Saplo e o endereço que estás a abrir. Se a instalação apresentar um erro, envia ao Suporte do Saplo o nome da aplicação e o conteúdo da mensagem. Não elimines a biblioteca apenas para tentares novamente.

Por onde começar?

Abre a oferta da Audiobookshelf no Saplo, executa a aplicação a partir do catálogo de aplicações e cria imediatamente uma conta de administrador. Adiciona um livro, verifica a ordem dos capítulos e se o progresso está a ser guardado. Só depois transfere o restante da biblioteca.