Skip to content
wesleydanieellPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Acervo

Gerenciador local de bibliotecas digitais para Linux, desenvolvido com Tauri 2, Rust, React e TypeScript.

O Acervo organiza arquivos físicos e listas de obras. Não pretende substituir leitores de EPUB/PDF: a leitura pode continuar nos aplicativos de sua preferência.

Recursos atuais

  • Seleção da raiz da biblioteca pelo explorador nativo, com indexação de PDF, EPUB, MOBI, AZW3 e DJVU.
  • Biblioteca: árvore de pastas, redimensionamento da lateral, arrastar/soltar arquivos com prévia de conflitos, filtros, sugestões de busca e agrupamentos. Apenas arquivos reais aparecem na raiz.
  • Miniaturas de capas EPUB extraídas do arquivo e primeiras páginas de PDF (usa Poppler/pdftoppm no Linux), com cache e carregamento gradual.
  • Catálogo: central separada para obras cadastradas, disponíveis, faltantes e arquivos sem ficha.
  • Leitura do banco legado 99 - Catálogo/Catalogo_Conhecimento.db, mantendo o SQLite original em modo somente leitura para consultas.
  • Importação de listas JSON e CSV (com prévia antes de salvar), validação, escrita atômica, backup anterior e proteção contra duplicatas exatas. Exportação JSON por cópia e CSV por diálogo nativo, sem sobrescrever arquivo existente. Consulte CSV do Catálogo.
  • Geração de prompts de IA com a estrutura de pastas existente para produzir listas JSON compatíveis.
  • Aparência Liquid Glass e Material 3, paletas manuais e sincronização das cores com o Noctalia (mediante a configuração do template em integrations/noctalia).

Versão alpha: a organização de arquivos pode mover documentos e atualizar referências legadas quando você confirmar uma movimentação. Mantenha backup. A pesquisa em fontes JSON e os downloads temporários com confirmação estão em alpha. Pausa e retomada manual já existem (HTTP Range quando a fonte oferece ETag forte); validação profunda dos arquivos baixados ainda está em desenvolvimento.

Instalação no CachyOS / Linux

Requisitos: Node.js/npm, Rust/Cargo, dependências do Tauri 2 e Poppler para prévias PDF.

npm ci
./scripts/install-desktop.sh

O instalador compila em modo de produção, instala o executável em ~/.local/opt/acervo e registra um atalho em ~/.local/share/applications/acervo.desktop, sem precisar de sudo. A instalação anterior fica em acervo.previous.

Se você já compilou a versão release, execute ./scripts/install-desktop.sh --skip-build. O app aparece no menu de aplicativos do Niri/Noctalia como Acervo.

AppImage para Linux

O workflow Build AppImage compila o Acervo em um ambiente Linux compatível (Ubuntu 22.04). Ele é acionado a cada atualização da main, por tags v* e manualmente pela aba Actions do GitHub.

Depois da execução, abra Actions → Build AppImage → execução → Artifacts e baixe Acervo-Linux-x86_64-AppImage. Extraia o ZIP do artefato e execute o .AppImage após torná-lo executável (chmod +x Acervo*.AppImage). O arquivo tem validade de 30 dias nos artefatos da ação.

O ícone original, editável, fica em branding/acervo-icon.svg; o comando npm run tauri -- icon branding/acervo-icon.png reproduz os formatos de empacotamento a partir do PNG exportado do SVG.

Desenvolvimento e testes

npm ci
npm run build
cargo test --manifest-path src-tauri/Cargo.toml --lib
npm run tauri dev

Os caminhos do acervo são escolhidos pelo usuário; o projeto não copia livros para dentro do repositório. Dados pessoais e arquivos de catálogo não são versionados no Git.

Contribuições e versionamento

  • main: versão integrada e verificada por CI.
  • feat/*, fix/*, chore/*: entregas isoladas em branches.
  • Pull requests revisados e integrados na ordem das dependências, preservando o histórico de commits.
  • Pré-lançamentos 0.1.0-alpha.N não garantem estabilidade completa.

Consulte VERSIONING.md e CHANGELOG.md.

Próximos passos

  1. Ampliar tipos de provedores/extensões mantendo o isolamento e a pesquisa agregada.
  2. Pausar downloads de forma explícita, verificar integridade de arquivos e associá-los ao catálogo.
  3. Importação/exportação de CSV com prévia de diferenças e edição das fichas do catálogo.
  4. Mais operações seguras para arquivos em massa, incluindo desfazer quando possível.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages