Scroll to navigation

CALIBREDB(1) calibre CALIBREDB(1)

NAME

calibredb - calibredb

calibredb command [options] [arguments]


calibredb is the command line interface to the calibre database. It has several sub-commands, documented below.

calibredb can be used to manipulate either a calibre database specified by path or a calibre Content server running either on the local machine or over the internet. You can start a calibre Content server using either the calibre-server program or in the main calibre program click Connect/share  →  Start Content server. Since calibredb can make changes to your calibre libraries, you must setup authentication on the server first. There are two ways to do that:

  • If you plan to connect only to a server running on the same computer, you can simply use the --enable-local-write option of the content server, to allow any program, including calibredb, running on the local computer to make changes to your calibre data. When running the server from the main calibre program, this option is in Preferences → Sharing over the net → Advanced.
  • If you want to enable access over the internet, then you should setup user accounts on the server and use the --username and --password options to calibredb to give it access. You can setup user authentication for calibre-server by using the --enable-auth option and using --manage-users to create the user accounts. If you are running the server from the main calibre program, use Preferences → Sharing over the net → Require username/password.



To connect to a running Content server, pass the URL of the server to the --with-library option, see the documentation of that option for details and examples.

  • OPÇÕES GLOBAIS
  • list
  • add
ADICIONAR A PARTIR DE DIRETÓRIOS

  • remove
  • add_format
  • remove_format
  • show_metadata
  • set_metadata
  • export
  • catalog
EPUB OPÇÕES

  • saved_searches
  • add_custom_column
  • custom_columns
  • remove_custom_column
  • set_custom
  • restore_database
  • check_library
  • list_categories
  • backup_metadata
  • clone
  • embed_metadata
  • search

OPÇÕES GLOBAIS

mostrar esta mensagem de ajuda e sair

Caminho para a biblioteca calibre. O padrão é usar o caminho armazenado nas configurações. Você também pode se conectar a um servidor de conteúdo do calibre para executar ações em bibliotecas remotas. Para fazer isso, use uma URL de formulário: http://hostname:port/#library_id por exemplo, http://localhost:8080/#mylibrary. library_id é o ID da biblioteca da biblioteca à qual você deseja se conectar no Servidor de Conteúdo. Você pode usar o valor de library_id - para obter uma lista de IDs de bibliotecas disponíveis no servidor. Para detalhes sobre como configurar o acesso através de um Servidor de Conteúdo, consulte https://manual.calibre-ebook.com/generated/en/calibredb.html.

Senha para se conectar a um Servidor de Conteúdo Calibre. Para ler a senha da entrada padrão, use o valor especial: <stdin>. Para ler a senha de um arquivo, use: <f:/path/to/file> (ex: <f: followed by the full path to the file and a trailing >). Os colchetes acima são necessários, lembre-se de escapar deles ou usar aspas para o seu shell.

Nome de usuário para conectar ao servidor de conteúdo do Calibre

mostrar número da versão do programa e sair

LIST

calibredb list [opções]


Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Ordenar resultados em ordem ascendente

Campos que serão exibidos ao listar livros no banco de dados. Deve ser uma lista de campos separada por vírgulas. Campos disponíveis: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, timestamp, title, uuid Padrão: title,authors. O campo especial "all" pode ser usado para selecionar todos os campos. Em complemento aos campos acima, campos personalizados também estão disponíveis como *field_name. Por exemplo, para um campo personalizado #rating, use o nome: *rating.

Gerar saída no modo JSON, o que é mais adequado para a análise automática. Faz com que a largura de linha e opções de separação sejam ignoradas.

O número máximo de resultados para exibir. Padrão: tudo

A largura máxima de uma única linha na saída. O padrão é detectar o tamanho da tela.

O prefixo do caminho de todos arquivos. O padrão é o caminho completo até a pasta da biblioteca.

Filtrar os resultados pela frase de pesquisa. Para o formato da frase de pesquisa, consulte a documentação à respeito de pesquisa no Manual do Usuário. O padrão é não filtrar.

O Caractere usado para separar os campos. O padrão é um espaço.

O campo pelo qual ordenar os resultados. Campos disponíveis: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, timestamp, title, uuid Padrão: id

ADD

calibredb add [opções] arquivos1 arquivo2 arquivo3 ...


Adicionar os arquivos especificados como livros para a base de dados. Você pode também especificar diretórios, consulte abaixo as opções relacionadas com diretórios.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Configure o(s) autor(es) do(s) livro(s) adicionado(s)

Caminho para a capa para usar no livro adicionado

Adicionar livros para a base de dados mesmo se eles já existirem. Comparação é feita baseada nos títulos dos livros.

Adicionar um livro vazio (um livro sem formatos)

Defina identificadores para esse livro, como: -I asin:XXX -I isbn:YYY

Configure o ISBN do(s) livro(s) adicionado(s)

Uma lista de idiomas separados por vírgulas (melhor usar códigos de idioma ISO639, assim alguns nomes de idiomas possam também ser reconhecidos)

Definir a série do(s) livro(s) adicionado(s)

Definir o número de série do(s) livro(s) adicionado(s)

Configure as etiquetas do(s) livro(s) adicionado(s)

Configure o título do(s) livro(s) adicionado(s)

ADICIONAR A PARTIR DE DIRETÓRIOS

Opções para controlar a adição de livros a partir de diretórios. Por padrão, apenas os arquivos que tem uma extensão de e-book conhecida são adicionados.

Um padrão de nome de arquivo (glob), arquivos que correspondam a este padrão serão adicionados ao varrer diretórios por arquivos, mesmo se forem de um tipo de e-book desconhecido. Pode ser especificado múltiplas vezes para múltiplos padrões.

Um padrão (glob) de nome de arquivo. Arquivos correspondentes a este padrão serão ignorados ao varrer diretórios por arquivos. Pode ser especificado múltiplas vezes para múltiplos padrões. Por exemplo: *.pdf irá ignorar todos os arquivos pdf

Assumir que cada diretório possui apenas um eBook e que todos os arquivos de um diretório sejam formatos diferentes de um mesmo eBook

Processar diretórios recursivamente

REMOVE

calibredb remove ids


Remove os livros identificados por IDs do banco de dados. IDs devem ser uma lista de números id separados por vírgulas (você pode pegar os números de ids utilizando o comando de busca). Por exemplo, 23 ,34,57-85 (quando especificar um alcance, o último número não é incluído).

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Não usar o lixo

ADD_FORMAT

calibredb add_format [options] id ebook_file


Adiciona o livro em ebook_file para os formatos disponíveis de livro lógico identificados por id. Você pode pegar um id usando o comando de busca. Se o formato já existe, ele é substituído, a menos que a opção de não substituir seja marcada.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Não substituir o formato se ele já existir

REMOVE_FORMAT

calibredb remove_format [options] id fmt


remove o formato fmt de um livro lógico identificado pelo id. Você pode pegar o id utilizando o comando de busca. fmt pode ser uma extensão de arquivo como LRF ou TXT ou EPUB. Se o arquivo lógica não tem fmt disponível, não faz nada.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

SHOW_METADATA

calibredb show_metada[options] id


Apresenta os metadados armazenados na base de dados do calibre para o livro identificado pelo id. Id é um número de id do comando de busca.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Imprimir metadados num formulário OPF (XML)

SET_METADATA

calibredb set_metadata [options] id [/path/to/metadata.opf]


Seta o metadado armazenado na base de dados do calibre para o livro identificado pelo id para o arquivo OPF metadata.opf. Id é um número de id do comando de busca. Você pode pegar rapidamente para o formato OPF utilizando --as-opf no comando show_metadata. Você pode também setar o metadado de campos individuais com a opção --field. Se você utilizar a opção --field, não é necessário especificar um arquivo OPF.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

O campo a ser definido. O formato é field_name:valor, por exemplo: --field tags:etiqueta1,etiqueta2. Use --list-fields para obter uma lista de todos os nomes de campo. Você pode especificar essa opção várias vezes para definir vários campos. Nota: Para idiomas que você deve usar os códigos de linguagem ISO639 (por exemplo, en para Inglês, fr para Francês e assim por diante). Para identificadores, a sintaxe é --field identifiers:isbn:XXXX,doi:YYYYY. Para campos booleanos (sim/não) usam verdadeiro e falso ou sim e não.

Listar os nomes dos campos de metadados que podem ser usados ​​com a opção --field

EXPORT

calibredb export [options] ids


Exportar os livros especificados pelos id (uma lista separada por vírgula) para o sistema de arquivos. A operação de exportação save todos os formatos do livro, suas capas e metadados(em um arquivo opf). Você pode pegar os números de id do comando de busca.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Exportar todos os livros do banco de dados, ignorando a lista de IDs.

Normalmente, o calibre irá converter todos caracteres não Ingleses em equivalentes Ingleses para os nomes dos arquivos. AVISO: Se você desligar este, você poderá experimentar erros durante salvamentos, dependendo de como o sistema de arquivos que você está salvando suporta "unicode". Especificar esta mudança desligará este comportamento

Normalmente, o calibre irá salvar a capa em um arquivo separado juntamente com os atuais arquivos do e-book Especificar esta mudança desligará este comportamento

Normalmente, o calibre atualizará os metadados nos arquivos salvos que estejam na biblioteca do calibre. Faz com que salvamentos no disco sejam mais lentos. Especificar esta mudança desligará este comportamento

Normalmente, calibre escreverá os metadados dentro de arquivos OPF separados com os arquivos de e-book atuais. Especificar esta mudança desligará este comportamento

Lista separada por vírgulas de formatos para salvar cada livro. Por padrão todos formatos disponíveis são salvos.

Relatar progresso

Substituir espaços em branco por "_".

Exportar todos os livros em um diretório

Modelo para controlar a estrutura de nome do arquivo e diretório dos arquivos salvos. O padrão é "{author_sort}/{title}/{title} - {authors}", que vai salvar os livros em um subdiretório por autor com nomes de arquivos contendo título e autor. Os controles disponíveis são: {author_sort, authors, id, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, tags, timestamp, title}

O formato para exibir datas. %d - dia, %b - mês, %m - número do mês, %Y - ano. O padrão é: %b, %Y

Exportar livros para o diretório especificado. O padrão é .

Converter caminhos para letras minúsculas

CATALOG

calibredb catalog /path/to/destination.(csv|epub|mobi|xml...) [options]


Exporta um catálogo em formato especificado pela extensão path/to/destination. Opções controlam como as entradas são exibidas no catálogo gerado. Note que formatos de catálogos diferentes suportam diferentes conjuntos de opções.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Lista separada por vírgulas dos IDs da base de dados do catálogo. Se declarado, --search será ignorado. Padrão: todos

Filtre os resultados por uma frase de pesquisa. Para o formato da frase de pesquisa, consulte a documentação relacionada a pesquisa no Manual do Usuário. Padrão: sem filtros

Mostrar informação detalhada de saída. Útil para depuração

EPUB OPÇÕES

Título do catálogo gerado usado como título em metadados. Padrão: 'My Books' Aplica-se a: formatos de saída AZW3, ePub, MOBI

Criar referências cruzadas na seção Autores de livros com vários autores. Padrão: 'False' Aplica-se a: formatos de saída AZW3, ePub, MOBI

Salvar a saída de diferentes estágios do pipeline de conversão para o diretório especificado. Útil se você não tem certeza em que fase do processo de conversão um erro está ocorrendo. Padrão: 'None' Aplica-se a: formatos de saída AZW3, ePub, MOBI

Expressão regular descrevendo etiquetas para excluir como gêneros. Padrão: '[.+]|^+$' exclui etiquetas entre colchetes, por exemplo, '[Projeto Gutenberg]', e '+', a etiqueta padrão para livros de leitura. Aplica-se a: formatos de saída AZW3, ePub, MOBI

Especifica as regras usadas para excluir livros do catálogo gerado. O modelo para uma regra de exclusão é ('<rule name>','Etiquetas','<comma-separated list of tags>') ou ('<rule name>','<custom column>','<pattern>'). Por exemplo: (('Livros arquivados','#status','Arquivado'),) irá excluir um livro com um valor de 'Arquivado' na coluna personalizada 'status'. Quando várias regras são definidas, todas as regras serão aplicadas. Padrão: "(('Catalogs','Tags','Catalog'),)" Aplica-se aos formatos de saída AZW3, ePub, MOBI

Incluir a seção 'Autores' no catálogo. Padrão: 'False' Aplica-se a: formatos de saída AZW3, ePub, MOBI

Incluir a seção 'Descrições' no catálogo. Padrão: 'False' Aplica-se a: formatos de saída AZW3, ePub, MOBI

Incluir a seção 'Gêneros' no catálogo. Padrão: 'False' Aplica-se a: formatos de saída AZW3, ePub, MOBI

Incluir a seção 'Adicionados Recentemente' no catálogo. Padrão: 'False' Aplica-se a: formatos de saída AZW3, ePub, MOBI

Incluir a seção 'Série' no catálogo. Padrão: 'False' Aplica-se a: formatos de saída AZW3, ePub, MOBI

Incluir a seção 'Títulos' no catálogo. Padrão: 'False' Aplica-se a: formatos de saída AZW3, ePub, MOBI

Campo recurso para a seção 'Gêneros'. Padrão: 'Etiquetas' Aplica-se a: formatos de saída AZW3, ePub, MOBI

Campo personalizado que contém o texto da nota para inserir no cabeçalho da Descrição. Padrão: '' Aplica-se a: formatos de saída AZW3, ePub, MOBI

#<custom field>:[before|after]:[True|False] especificando: <custom field> Campo personalizado contendo notas para mesclar com os Comentários [before|after] Espaços reservados de notas com os respectivos Comentários [True|False] - Uma régua horizontal é inserida entre notas e Comentários Padrão: '::' Aplica-se a formatos de saída AZW3, ePub, MOBI

Especifica o perfil de saída. Em alguns casos, um perfil de saída é necessário para otimizar o catálogo para o dispositivo. Por exemplo, 'kindle' ou 'kindle_dx' cria uma tabela estruturada de conteúdo com seções e artigos. Padrão: 'None' Aplica-se a: formatos de saída AZW3, ePub, MOBI

--prefix-rules
Especifica as regras usadas para incluir prefixos que indicam livros de leitura, lista de sonhos e outros prefixos especificados pelo usuário. O modelo para uma regra de prefixo é ('<rule name>','<source field>','<pattern>','<prefix>'). Quando várias regras são definidas, será usada a primeira regra correspondente. Padrão: "(('Read books','tags','+',''),('Wishlist item','tags','Wishlist','×'))" Aplica-se a formatos de saída AZW3, ePub, MOBI

Usar um nome predefinido criado com a GUI do construtor de catálogo. Uma predefinição especifica todos os ajustes para construir um catálogo. Padrão: 'None' Aplica-se a formatos de saída AZW3, ePub, MOBI

Tamanho da dica (polegadas) para capas de livro no catálogo. Intervalo: 1.0 - 2.0 Padrão: '1.0' Aplicado para formatos de saída AZW3, ePub, MOBI

Substituir capas existentes ao gerar o catálogo. Padrão: 'False' Aplica-se a: formatos de saída AZW3, ePub, MOBI

SAVED_SEARCHES

calibredb saved_searches [options] (list|add|remove)


Gerencie as pesquisas salvas no banco de dados. Se você tentar adicionar uma pesquisa com o nome que já existe, ele será sobrescristo.

Sintaxe para adicionar:

calibredb saved_searches add search_name search_expression

Sintaxe para remover:

calibredb saved_searches remove search_name

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

ADD_CUSTOM_COLUMN

calibredb add_custom_column [opções] identificador nome tipo-de-dado


Criar uma coluna personalizada. "identificador" é o nome de máquina para coluna. Não pode conter espaços ou dois-pontos. "nome" é o nome da coluna que será exibido. tipo-de-dado pode ser um dos seguintes: bool, comments, composite, datetime, enumeration, float, int, rating, series, text

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Um dicionário de opções para personalizar a forma como os dados nesta coluna serão interpretados. Esta é uma string JSON. Para colunas de enumeração, use --display"{\ "enum_values\ ":[\ "val1\ ", \ "val2\ "]}" Existem muitas opções que podem ir para as opções de variáveis de exibição. As opções por tipo de coluna são: composite: composite_template, composite_sort, make_category,contains_html, use_decorations datetime: date_format enumeration: enum_values, enum_colors, use_decorations int, float: number_format text: is_names, use_decorations A melhor maneira de encontrar combinações legais é criar uma coluna personalizada do tipo apropriado na GUI e em seguida olhar para o backup OPF de um livro (assegure-se que um novo OPF foi criado da coluna foi acrescentado). Você vai ver o JSON da "exibição" para a nova coluna em OPF.

Este campo armazena dados como etiquetas (ou seja, vários valores separados por vírgulas). Somente se aplica se o tipo de dados for texto.

CUSTOM_COLUMNS

calibredb custom_columns [options]


Lista colunas personalizadas disponíveis. Exibe os nomes dos campos e seus IDs.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Mostrar detalhes para cada campo.

REMOVE_CUSTOM_COLUMN

calibredb remove_custom_column[options]label


Remover a coluna customizada identificada pela etiqueta. Você poderá ver as colunas costumizadas com o comando custom_columns

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Não pedir confirmação

SET_CUSTOM

calibredb set_custom [options] column id value


Marque o valor da coluna customizada para o livro identificado pelo id. Você pode pegar a lista de ids usando o comando de pesquisa. Você pode pegar a lista de colunas costumizadas usando o custom_columns command.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Se o campo possibilitar armazenar diversos valores, não sobrescreva os valores adicione os valores especificados aos já existentes.

RESTORE_DATABASE

calibredb restore_database [opções]


Restaurar esse banco de dados dos metadados armazenados em arquivos OPF em cada diretório de biblioteca do calibre. Isto é útil se o seu arquivo metadata.db foi corrompido.

AVISO: Este comando regenera completamente o seu banco de dados. Você vai perder todas as buscas salvas, as categorias de usuários, quadros de conexões, configurações armazenadas por conversão de livros, e receitas personalizadas. Os metadados restaurados serão apenas tão precisos quanto aos encontrados nos arquivos OPF

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Realmente faz a recuperação. O comando não será executado, a menos que esta opção seja especificada.

CHECK_LIBRARY

calibredb check_library [options]


Executar algumas verificações no sistema de arquivos representando uma biblioteca. Os relatórios são invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, failed_folders

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Saída em CSV

Lista de extensões separadas por vírgula para ignorar. Padrão: tudo

Lista de nomes separados por vírgula para ignorar. Padrão: tudo

Lista de relatórios separados por vírgula. Padrão: tudo

LIST_CATEGORIES

calibredb list_categories [opções]


Produz um relatório das informações da categoria no banco de dados. A informação é equivalente à que é mostrada no painel de etiquetas.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Lista de categorias separadas por vírgula para pesquisar nomes. Padrão: tudo

Saída em CSV

Tipo de arquivo CSV que será produzido. Escolhas: excel, excel-tab

Processa apenas o número de itens em uma categoria, em vez das contagens por item dentro da categoria

A largura máxima de uma única linha na saída. O padrão é detectar o tamanho da tela.

BACKUP_METADATA

calibredb backup_metadata [options]


Backup dos metadados armazenados no banco de dados em arquivos OPF individuais em cada diretório de livros. Isso normalmente acontece automaticamente, mas você pode executar este comando para forçar uma nova geração dos arquivos OPF, com a opção --all.

Note que normalmente não há necessidade de fazer isso, pois os arquivos OPF são copiados automaticamente, toda vez que os metadados são alterados.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Normalmente, este comando apenas opera em livros que tenham arquivos OPF desatualizados. Esta opção irá criar operações em todos os livros.

CLONE

calibredb clone path/to/new/library


Criar um clone da biblioteca atual. Isto cria uma nova biblioteca vazia que contém as mesmas colunas personalizadas, bibliotecas virtuais e outros ajustes como a biblioteca atual.

A biblioteca clonada não contêm livros. Se você quiser criar uma cópia completa, incluindo todos os livros, use em seguida suas ferramentas de sistema de arquivos para copiar a pasta da biblioteca.

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

EMBED_METADATA

calibredb embed_metadata [options] book_id


Atualizar os metadados nos arquivos de livros atuais armazenados na biblioteca do calibre dos metadados no banco de dados do calibre. Normalmente, os metadados são atualizadas apenas

quando exportar arquivos do calibre, este comando é útil se você deseja que os arquivos


quantidades de metadados. Você pode usar o valor especial 'all' para book_id para atualizar os metadados em todos os livros. Você também pode especificar várias ids de livro separado

por espaços e intervalos de ID separados por hífens. Por exemplo: calibredb embed_metadata 1 2 10-15 23

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

Apenas atualizar os metadados em arquivos do formato especificado. Especifique-o várias vezes para vários formatos. Por padrão, todos os formatos são atualizados.

SEARCH

calibredb search [options] search expression


Procura a biblioteca para o termo de pesquisa específicado, retornando uma lista separada por vírgula de ids de livros resultantes da expressão de busca. O formato de saída é útil para alimentar outros comandos que aceitam uma lista de ids como entrada.

O comando de expressão poder ser qualquer coisa da poderosa consulta de busca do calibre por exemplo: author:asimov title:robot

Sempre que você for passar argumentos para calibredb que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

O número máximo de resultados para retornar. O padrão é todos os resultados.

AUTHOR

Kovid Goyal

COPYRIGHT

Kovid Goyal

novembro 29, 2019 4.5.0