Sobre o projeto

O Calibre-Web Automated (CWA) é um projeto de biblioteca digital auto-hospedada baseado no Calibre-Web. Seu objetivo declarado é combinar a interface web moderna e leve do Calibre-Web com o conjunto mais amplo de recursos do Calibre, além de automação adicional. O README explica que o Calibre em contêiner depende de uma interface KasmVNC que é desconfortável em dispositivos móveis e relativamente pesada em recursos, enquanto o Calibre-Web padrão carece de alguns recursos essenciais, levando muitos usuários a executar os dois serviços em paralelo. O CWA mantém todos os recursos do Calibre-Web padrão, incluindo interface responsiva Bootstrap HTML5, permissões por usuário, feeds OPDS para aplicativos de leitura, edição de metadados e download de fontes extensíveis, restrições de download, registro público, envio para e-reader com um clique, sincronização com dispositivos Kobo, leitura de múltiplos formatos no navegador, ocultação de conteúdo por categoria e coluna personalizada, login por Magic Link, busca e filtragem avançadas e interface multilíngue. As adições específicas do CWA descritas no README incluem: - Serviço de Ingestão Automática com suporte a 27 formatos de ebook, com regras configuráveis de ignorar e conversão automática. - Serviço de Conversão Automática, ativado por padrão, com destino a EPUB, MOBI, AZW3, KEPUB ou PDF, com 28 tipos de arquivo de entrada suportados. - Aplicação automática de alterações de capa e metadados feitas pela interface web, de modo que as edições sejam gravadas nos arquivos dos livros, e não apenas na interface. - Serviço de backup automatizado que armazena os originais em /config/processed_books por padrão. - Detecção inteligente de duplicatas usando correspondência híbrida de SQL e fuzzy, com verificações pós-ingestão, varreduras incrementais agendadas, mesclagem com um clique, operações em lote e resolução automática opcional. - Magic Shelves: estantes dinâmicas baseadas em regras com lógica AND/OR, modelos pré-construídos, contagens em cache e suporte à sincronização Kobo. - Envio automático para e-reader após a ingestão, com atraso configurável, seleção de formato e múltiplos destinatários. - Busca automática de metadados na ingestão com hierarquia de provedores e fallback. - Estatísticas e análises aprofundadas com exportação CSV, filtragem por usuário e intervalos de datas. - Modal aprimorado de envio para e-reader com suporte a múltiplos dispositivos e endereços ad-hoc. - Corretor Automático de EPUB baseado no kindle-epub-fix de innocenat, abordando codificação UTF-8, problemas de hiperlinks NCX, tags de idioma inválidas, tags de imagem perdidas, XML malformado e CSS/fontes quebrados; ativado por padrão com backups por execução e processamento em massa da biblioteca. - Ferramenta de conversão multiformato com retenção opcional dos originais. - Provedores adicionais de metadados, incluindo isbndb.com via ibdb.dev, Hardcover, Kobo e LitRes. - Sincronização KOReader (KOSync) com checksums MD5 parciais automáticos, progresso unificado entre KOReader, status de leitura do CWA e Kobo, HTTP Basic Auth e um plugin para download. - Autenticação aprimorada OAuth 2.0/OIDC com descoberta automática, substituição manual de endpoints, mapeamento de campos JWT, funções de administrador baseadas em grupos e teste de conexão. - Busca automática de ID do Hardcover como tarefa em segundo plano. - Detecção Automática de Biblioteca: cria uma nova biblioteca Calibre se nenhuma existir, ou encontra e monta recursivamente uma existente, escolhendo a maior se várias forem encontradas. Uma biblioteca por instância é suportada. - Notificação interna de atualização comparando a versão instalada com a versão mais recente do GitHub, exibida uma vez por dia aos administradores. - Botão de atualização manual da biblioteca para ingerir livros deixados na pasta de ingestão. - Compressão automática dos arquivos de backup pouco antes da meia-noite de cada dia. - Edição e exclusão em lote na página de Lista de Livros. As notas de implantação abordam compartilhamentos de rede: NETWORK_SHARE_MODE=true desativa o WAL do SQLite em metadata.db e app.db, ignora o chown recursivo e muda os watchers para polling. CWA_WATCH_MODE=poll pode forçar o polling. O Docker Desktop é detectado automaticamente e usa polling. Atrás de múltiplos proxies, TRUSTED_PROXY_COUNT pode ser definido porque o Werkzeug ProxyFix confia em um proxy por padrão, o que afeta a proteção de sessão. A instalação é feita via Docker Compose, com um comando curl de instalação rápida para o modelo de compose, orientações para usuários que migram do Calibre-Web padrão e tarefas pós-instalação, incluindo o login padrão de administrador. O README também lista um roadmap: um frontend baseado em Svelte, um novo leitor web, sincronização de progresso entre dispositivos, busca em texto completo, suporte a plugins do Calibre, divisão de bibliotecas e integrações de notificação. Projetos afiliados incluem o Shelfmark para download de livros e o aplicativo Calibre-Web Companion baseado em Flutter.