Calibre-Web
Caliber-Web é um aplicativo da web que oferece uma interface limpa e intuitiva para navegar, ler e baixar e-books usando um banco de dados válido do Caliber.
Índice (clique para expandir)
- Sobre
- Características
- Instalação
- Instalação via pip (recomendado)
- Início rápido
- Requisitos
- Imagens Docker
- Solução de problemas
- Reconhecimento do Colaborador
- Contato
- Contribuindo para o Calibre-Web
Este software é uma bifurcação da biblioteca e licenciado sob a licença GPL v3.
Características
- Interface Bootstrap 3 HTML5 moderna e responsiva
- Configuração gráfica completa
- Gerenciamento abrangente de usuários com permissões detalhadas por usuário
- Interface administrativa
- Interface de usuário multilíngue com suporte para mais de 20 idiomas (idiomas suportados)
- Feed OPDS para aplicativos leitores de e-books
- Opções avançadas de pesquisa e filtragem
- Criação de coleção de livros personalizada (estantes)
- Suporte para edição e exclusão de metadados de e-books
- Download de metadados de várias fontes (extensível por meio de plug-ins)
- Conversão de e-books por meio de binários do Calibre
- Restrição de download de e-books para usuários logados
- Suporte para registro de usuário público
- Envie e-books para leitores eletrônicos com um único clique
- Sincronize dispositivos Kobo com sua biblioteca Calibre
- Suporte para leitura de e-books no navegador para vários formatos
- Faça upload de novos livros em vários formatos, incluindo formatos de áudio
- Suporte para colunas personalizadas do Calibre
- Ocultação de conteúdo com base em categorias e conteúdo de coluna personalizada por usuário
- Capacidade de autoatualização
- Login "Magic Link" para fácil acesso em eReaders
- Suporte a LDAP, Google/GitHub OAuth e autenticação de proxy
Instalação
Instalação via pip (recomendado)
- Crie um ambiente virtual : É essencial isolar a instalação do Calibre-Web para evitar conflitos de dependência. Você pode criar um ambiente virtual executando:
python3 -m venv calibre-web-env
- Ative o ambiente virtual :
source calibre-web-env/bin/activate
- Instale Calibre-Web : Use pip para instalar o aplicativo:
- Instalar recursos opcionais : Para obter funcionalidades adicionais, pode ser necessário instalar recursos opcionais. Consulte esta página para obter detalhes sobre o que pode ser instalado.
- Inicie o Caliber-Web : Após a instalação, você pode iniciar o aplicativo com:
Nota: Os usuários do Raspberry Pi OS podem encontrar problemas de instalação. Se você fizer isso, tente atualizar o pip e/ou instalar o cargo da seguinte maneira:
./venv/bin/python3 -m pip install --upgrade pip
sudo apt install cargo
Links importantes
- Para exemplos de instalação adicionais, verifique o seguinte:
- Instalação manual
- Instalação do Linux Mint
- Configuração do provedor de nuvem
Início rápido
- Acesse Caliber-Web : Abra seu navegador e navegue até: ou para o catálogo OPDS:
http://localhost:8083/opds
- Faça login : use as credenciais de administrador padrão:
- Nome de usuário: administrador
- Senha: admin123
- Configuração do banco de dados : Se você não possui um banco de dados Calibre, baixe uma amostra em:
https://github.com/janeczku/calibre-web/raw/master/library/metadata.db
Mova-o para fora da pasta Caliber-Web para evitar sobrescrever durante as atualizações. - Configurar o banco de dados Caliber : Na interface administrativa, defina o
Location of Calibre database
para o caminho da pasta que contém sua biblioteca Caliber (onde metadata.db
está localizado) e clique em "Salvar". - Integração com o Google Drive : Para hospedar sua biblioteca do Calibre no Google Drive, consulte o guia de integração do Google Drive.
- Configuração de administrador : configure sua instância por meio da página de administração, consultando os guias Configuração básica e Configuração da interface do usuário.
Requisitos
- Versão do Python : certifique-se de ter o Python 3.7 ou mais recente.
- Imagemagick : Necessário para extração de capa de EPUBs. Os usuários do Windows também podem precisar instalar o Ghostscript para extração de capa de PDF.
- Ferramentas opcionais :
- Programa de desktop Calibre : recomendado para conversão instantânea e edição de metadados. Defina o caminho para a ferramenta de conversão do Calibre na página de configuração.
- Ferramenta Kepubify : necessária para suporte a dispositivos Kobo. Baixe a ferramenta e coloque o binário em
/opt/kepubify
no Linux ou C:Program Fileskepubify
no Windows.
Imagens Docker
Imagens Docker pré-construídas estão disponíveis:
Servidor Linux - x64, aarch64
- Docker Hub : linuxserver/calibre-web
- GitHub : linuxserver/docker-calibre-web
- Camada Calibre opcional : linuxserver/docker-mods
Para incluir o binário Caliber ebook-convert
(somente x64), adicione a variável de ambiente:
DOCKER_MODS=linuxserver/mods:universal-calibre
em seu arquivo de execução/composição do Docker. Omita esta variável para uma imagem leve.
- Configuração de caminhos :
- Defina o caminho para os binários do Calibre como
/usr/bin
. - Defina o caminho para Unrar como
/usr/bin/unrar
.
Solução de problemas
Problemas comuns :
- Se você tiver problemas ao iniciar o aplicativo, verifique se há mensagens de erro nos arquivos de log localizados no diretório
logs
. - Se os e-books não carregarem, verifique se o
Location of Calibre database
está definido corretamente e se o arquivo do banco de dados está acessível.
Erros de configuração : certifique-se de que seu banco de dados Calibre seja compatível e formatado corretamente. Consulte a documentação do Calibre para orientação sobre como manter o banco de dados.
Problemas de desempenho :
- Se a aplicação estiver lenta, considere aumentar os recursos alocados (CPU/RAM) para o seu servidor ou otimizar o banco de dados do Calibre removendo duplicatas e entradas desnecessárias.
- Limpe regularmente o cache do seu navegador para melhorar o tempo de carregamento.
Problemas de gerenciamento de usuários : se os usuários não conseguirem fazer login ou registrar-se, verifique as configurações de permissão do usuário na interface administrativa. Certifique-se de que o registro esteja habilitado e que os usuários estejam recebendo funções apropriadas.
Recursos de suporte : Para obter ajuda adicional, considere visitar a seção de perguntas frequentes do wiki ou postar suas perguntas na comunidade Discord.
Reconhecimento do Colaborador
Gostaríamos de agradecer a todos os contribuidores e mantenedores do Caliber-Web por suas valiosas contribuições e dedicação ao projeto. Suas contribuições são muito apreciadas.
Contato
Junte-se a nós no Discord
Para obter mais informações, instruções e perguntas frequentes, visite o Wiki
Contribuindo para o Calibre-Web
Para contribuir, verifique nossas Diretrizes de Contribuição. Aceitamos problemas, solicitações de recursos e solicitações da comunidade.
Relatando erros
Se você encontrar bugs ou problemas, relate-os na seção de problemas do repositório. Certifique-se de incluir informações detalhadas sobre sua configuração e o problema encontrado.
Solicitações de recursos
Aceitamos sugestões para novos recursos. Crie um novo problema no repositório para discutir suas ideias.
Recursos Adicionais
- Documentação : Documentação abrangente está disponível no wiki Caliber-Web.
- Contribuições da comunidade : explore as contribuições da comunidade para ver o trabalho em andamento e como você pode se envolver.
Obrigado por usar o Calibre-Web! Esperamos que você goste de gerenciar sua biblioteca de e-books com nossa ferramenta.