Gibiteka

🚀 Comece Certo!

Siga estes passos na primeira vez que usar o Gibiteka para ter tudo configurado e pronto para funcionar:

Instale o Gibiteka Helper — o pequeno serviço que habilita a abertura de revistas, o seletor de pasta nativo e a extração de capas no Windows.
Defina a pasta padrão — configure o diretório base onde suas revistas estão armazenadas; isso agiliza toda a importação.
Crie suas bibliotecas — organize sua coleção em categorias (ex: Marvel, DC, Mangás, Nacional) antes de importar qualquer coisa.
Importe suas revistas — use + Pasta para catalogar de uma vez todos os CBR/CBZ de um diretório, ou + Revista para arquivos individuais.

💡 Com esses quatro passos concluídos, sua coleção já estará navegável, pesquisável e com capas geradas automaticamente.

1. Criando Bibliotecas

Antes de importar revistas, crie ao menos uma biblioteca para organizá-las (ex: Marvel, DC, Mangás, Nacional).

Clique com o botão direito em qualquer área da barra lateral e escolha Adicionar Biblioteca.
Clique com o botão direito em uma biblioteca existente para Adicionar, Editar ou Excluir (atenção: excluir uma biblioteca remove também todas as suas revistas).

2. Importando Revistas

O Gibiteka cataloga arquivos CBR, CBZ e CB7 que já existam no seu computador. Para importar:

Selecione a biblioteca de destino na barra lateral.
Clique em + Revista na barra de ferramentas para importar um arquivo individual.
Informe o caminho completo do arquivo (ex: D:\Quadrinhos\batman.cbz) ou use o botão de navegação para localizar o arquivo no seu computador.
Preencha os metadados opcionais (editora, coleção, número) e confirme.
Para importar vários arquivos de uma vez, clique em + Pasta e informe o caminho da pasta — todos os CBR/CBZ/CB7 encontrados serão importados, ignorando duplicatas.

💡 Os arquivos permanecem no local original — o Gibiteka apenas registra o caminho e extrai a capa automaticamente.

3. Navegando pela Coleção

Clique em uma biblioteca na barra lateral para ver seu conteúdo.
Mais Recentes exibe as últimas revistas adicionadas em todas as bibliotecas.
Use os botões de paginação no rodapé para navegar (24 revistas por página). Role para baixo para carregar as páginas seguintes automaticamente.
Altere a ordenação pelo seletor na barra de ferramentas: mais recentes, título, número ou data de publicação.
Clique em uma revista para abrir o painel de detalhes à direita. Clique em Fechar para recolhê-lo.

4. Pesquisando Revistas

Digite no campo de busca e pressione Enter ou clique na lupa. A pesquisa abrange título, roteirista, artista, capista, personagens, sinopse, número, EAN, editora e coleção.

Múltiplas palavras — batman robin retorna revistas que contenham ambas as palavras.
Operador OU — use | para buscar uma palavra ou outra: batman | superman.
É possível combinar: batman robin | superman encontra revistas com (batman E robin) ou superman.

💡 A pesquisa usa índice FULLTEXT do MySQL — rápida mesmo em coleções com milhares de revistas.

5. Editando Metadados

Clique com o botão direito em uma revista e escolha Editar Revista, ou selecione a revista e clique em Editar no painel de detalhes.

Aba Dados Gerais: número, páginas, preço de capa, data de publicação, código EAN, roteirista, artista, capista e personagens.
Aba Sinopse: texto livre de até 2.000 caracteres.
Para Editora: informe o código de uma editora existente (use … para selecionar) ou deixe o código em branco e informe só o nome para criar uma nova.
O mesmo vale para o campo Coleção.
O campo Páginas é preenchido automaticamente na importação e ao abrir o editor, contando as imagens do arquivo CBR/CBZ.

6. Organizando em Coleções

Uma coleção agrupa revistas de uma mesma série dentro de uma biblioteca.

Ao editar uma revista, informe o campo Coleção para vinculá-la.
A coleção aparece na biblioteca como um item especial com capa composta pelas primeiras revistas da série.
Clique na coleção para ver todas as revistas pertencentes, ordenadas por número.
Clique com o botão direito na coleção para Abrir, Editar, Gerar Capa, Atualizar ou Excluir.

Atualizar uma coleção

Quando você adiciona novas revistas à pasta de uma coleção no seu computador, use a opção Atualizar (menu de contexto da coleção) para sincronizar tudo de uma vez — sem precisar importar arquivo por arquivo.

Detecta a pasta da coleção automaticamente a partir das revistas já cadastradas (ou usa a pasta informada na importação por + Pasta).
Importa os arquivos novos — qualquer CBR/CBZ/CB7 presente na pasta que ainda não esteja na coleção é adicionado, já com a capa extraída.
Completa as páginas faltantes — preenche a contagem de páginas das revistas que ainda estavam com o valor zerado.
Um painel de progresso mostra, linha a linha, a pasta identificada, os arquivos novos encontrados e o resultado de cada importação.

💡 O Atualizar requer o Gibiteka Helper em execução e que você esteja no computador onde a pasta da coleção existe. Como toda a leitura é feita localmente, os arquivos CBR/CBZ nunca são enviados ao servidor — apenas as capas extraídas e os metadados.

Atualizar a biblioteca inteira

Para verificar todas as coleções de uma biblioteca de uma só vez, clique com o botão direito na biblioteca (na barra lateral) e escolha Atualizar Coleções.

O Gibiteka percorre cada coleção da biblioteca aplicando a mesma sincronização descrita acima — importando arquivos novos e completando páginas faltantes.
O painel de progresso mostra o avanço coleção a coleção e um resumo final com os totais.

💡 Ideal para a rotina periódica: depois de adicionar números novos em várias pastas, um único Atualizar Coleções põe toda a biblioteca em dia. Também requer o Helper e estar no computador onde as pastas existem.

7. Gibiteka Helper

O Gibiteka Helper é um pequeno serviço para Windows que habilita as seguintes funcionalidades:

Abertura de revistas — registra o protocolo gibiteka:// para abrir CBR/CBZ no CDisplayEx ou outro leitor configurado.
Seletor de pasta nativo — ao clicar em … nos campos de pasta (importação ou configurações), abre o seletor moderno do Windows já posicionado dentro da pasta indicada, pronto para navegar.
Extração de capas — permite gerar ou regenerar capas diretamente a partir do arquivo CBR/CBZ no seu disco, sem precisar reimportar a revista.

Instalação única, sem necessidade de Administrador:

Baixe e execute o instalador automático: ⬇ instalar-helper.cmd
Clique duas vezes no arquivo baixado — ele faz o download e a instalação automaticamente.
Após a confirmação, atualize o navegador (F5 ou Ctrl+R ou Ctrl+Shift+R) — o Helper inicia automaticamente a cada login no Windows.

💡 O Helper é um serviço leve que roda em segundo plano. Não requer instalação de software adicional nem privilégios de Administrador.

8. Configurações — Pasta Padrão

Clique no botão ⚙ na barra de ferramentas para abrir as Configurações.

Pasta padrão de revistas — define o diretório base que será aberto automaticamente ao clicar em … nos modais de + Pasta e + Revista, bem como no próprio modal de Configurações.
Use o botão … ao lado do campo para selecionar a pasta via seletor nativo do Windows (requer o Helper instalado), ou digite o caminho manualmente (ex: E:\Revistas).

💡 Com a pasta padrão configurada, ao abrir o seletor de pastas o Windows já exibe o conteúdo desse diretório, tornando a importação muito mais rápida.

9. Cópia de Segurança

O Gibiteka pode copiar seus arquivos CBR/CBZ para outra unidade ou pasta, criando um backup que preserva a estrutura de pastas original.

Abra ⚙ Configurações e vá até a seção Cópia de segurança.
Informe a pasta de destino (ex: E:\Gibiteka) — use o botão … para selecioná-la pelo seletor do Windows.
Clique em Executar cópia de segurança. Uma janela de progresso mostra cada arquivo, com os totais de copiados, já existentes e erros.

Como funciona

Incremental — copia apenas as revistas incluídas após a última cópia que ainda não existam no destino; as demais são ignoradas.
Estrutura preservada — D:\Gibiteka\Bonelli\Bella & Bronco\01.cbr vai para E:\Gibiteka\Bonelli\Bella & Bronco\01.cbr.
Data registrada — a data e hora da última cópia ficam visíveis nas Configurações.

💡 A cópia só está disponível no computador onde estão as revistas (PC-mãe) e requer o Gibiteka Helper atualizado em execução. Apenas o seu próprio acervo é copiado; os arquivos originais nunca são alterados.

10. Gerenciando Capas

O menu de contexto (botão direito) em uma revista oferece duas opções para capas:

Gerar Capa — extrai automaticamente a primeira imagem do arquivo CBR/CBZ cadastrado e a define como capa. Não é necessário reimportar a revista; o Gibiteka acessa o arquivo diretamente pelo caminho registrado no banco. Requer o Helper instalado e em execução.
Definir Capa… — abre um seletor de arquivo para escolher manualmente uma imagem (JPEG, PNG ou WebP) como capa da revista.

💡 Para coleções, Gerar Capa recria automaticamente a grade composta pelas capas das primeiras revistas da série.

11. Referência Rápida — Menu de Contexto (Botão Direito)

Em revistas: Abrir · Editar · Gerar Capa · Definir Capa… · Atualizar · Excluir
Em coleções: Abrir · Editar · Gerar Capa · Definir Capa… · Atualizar · Excluir
Em bibliotecas (barra lateral): Adicionar Biblioteca · Editar Biblioteca · Atualizar Coleções · Excluir Biblioteca
No fundo da barra lateral (área sem biblioteca): Adicionar Biblioteca

12. O Que Acontece ao Excluir

Ao excluir uma revista, coleção ou biblioteca, somente o banco de dados e a imagem de capa em cache são removidos. Os arquivos originais CBR/CBZ nunca são tocados — eles permanecem exatamente onde estão no seu disco, intactos.

🛡️ O Gibiteka não move, renomeia nem apaga seus arquivos de quadrinhos em nenhuma circunstância. A exclusão afeta apenas os registros internos da aplicação.

13. Fale Conosco

Tem uma sugestão, encontrou um problema ou quer deixar um elogio? Use o botão ✉ Contato no rodapé da barra lateral para enviar uma mensagem diretamente à equipe do Gibiteka.

Sua biblioteca de quadrinhos,
organizada.

Tudo que sua coleção precisa

Múltiplas Bibliotecas

Coleções e Séries

Capas Automáticas

Busca Avançada

Importação em Lote

Leitor Integrado

Sua biblioteca de quadrinhos,organizada.