bndct-devops/tome

O que é?

Recursos principais

• 01Registra sessões de leitura do KOReader pelo plugin TomeSync e sincroniza as posições nos dois sentidos.
• 02Estatísticas de leitura com sequências de dias lendo, mapas de calor por horário, ritmo e estimativas de conclusão.
• 03Leitor integrado para EPUB, CBZ/CBR e PDF, com modos de páginas duplas e RTL.
• 04Feed OPDS para baixar livros em aplicativos de e-reader.
• 05Busca de metadados no Hardcover, Google Books e OpenLibrary, com visualização de diferenças.
• 06Login único opcional com OIDC e controle de acesso baseado em funções.

Casos de uso

• Manter uma biblioteca de e-books para a casa em um NAS ou servidor doméstico com dispositivos KOReader.
• Acompanhar hábitos e progresso de leitura no e-reader e no navegador.
• Gerenciar uma coleção de mangás ou quadrinhos com um leitor no navegador.
• Disponibilizar um catálogo OPDS para e-readers com tela de tinta eletrônica na rede local.

Início rápido

1. 1

   Inicie o Tome com o Docker (o contêiner é executado na porta 8080)

   docker run -d --name tome --restart unless-stopped -p 8080:8080 -v ./data:/data -v ./books:/books -v ./bindery:/bindery ghcr.io/bndct-devops/tome:latest
2. 2

   Acesse http://localhost:8080 e siga o assistente de configuração para criar sua conta de administrador

Antes de usar

• !É necessário ter o Docker e um contêiner do Tome em execução; TOME_SECRET_KEY deve estar definida.
• !Para usar todos os recursos de sincronização do KOReader, é necessário ter o KOReader v2024.07 ou superior e o plugin personalizado TomeSync.
• !Alguns recursos dependem da configuração dos serviços Hardcover, Google Books ou OIDC.
• !Licenciado sob a AGPL-3.0, uma licença copyleft com obrigações para uso em rede.

Em coleções

Tópicos

Perguntas frequentes

O que é tome?

Servidor de biblioteca de e-books auto-hospedado, com leitor integrado, sincronização de leitura com KOReader, feed OPDS e estatísticas de leitura, distribuído em uma única imagem Docker. Tome é um servidor de biblioteca de e-books auto-hospedado, desenvolvido com FastAPI, React e SQLite. Seu principal diferencial em relação aos gerenciadores de biblioteca comuns é a integração com o KOReader: um plugin personalizado, o TomeSync, registra as sessões de leitura no e-reader e sincroniza as posições nos dois sentidos entre o dispositivo e a interface web, inclusive quando o dispositivo está offline.

tome é gratuito? Qual é a licença?

tome é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

tome ainda é mantido?

Manutenção ativa. O último commit de tome foi em 3 de nov. de 2026.

Para que posso usar tome?

Manter uma biblioteca de e-books para a casa em um NAS ou servidor doméstico com dispositivos KOReader. Acompanhar hábitos e progresso de leitura no e-reader e no navegador. Gerenciar uma coleção de mangás ou quadrinhos com um leitor no navegador. Disponibilizar um catálogo OPDS para e-readers com tela de tinta eletrônica na rede local.

Como instalar tome?

Inicie o Tome com o Docker (o contêiner é executado na porta 8080): docker run -d --name tome --restart unless-stopped -p 8080:8080 -v ./data:/data -v ./books:/books -v ./bindery:/bindery ghcr.io/bndct-devops/tome:latest Acesse http://localhost:8080 e siga o assistente de configuração para criar sua conta de administrador

Onde consigo tome?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/bndct-devops/tome