Sua biblioteca de quadrinhos,
organizada.

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.

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.

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.

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.

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:

1. Baixe e execute o instalador automático: ⬇ instalar-helper.cmd
2. Clique duas vezes no arquivo baixado — ele faz o download e a instalação automaticamente.
3. 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.

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).

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.

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.

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.

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.