Provided by: calibre_3.21.0+dfsg-1build1_all 
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
--help, -h
mostrar esta mensagem de ajuda e sair
--library-path, --with-library
Path to the calibre library. Default is to use the path stored in the settings. You can also
connect to a calibre Content server to perform actions on remote libraries. To do so use a URL of
the form: http://hostname:port/#library_id for example, http://localhost:8080/#mylibrary.
library_id is the library id of the library you want to connect to on the Content server. You can
use the special library_id value of - to get a list of library ids available on the server. For
details on how to setup access via a Content server, see
https://manual.calibre-ebook.com/generated/en/calibredb.html.
--password
Password for connecting to a calibre Content server. To read the password from standard input, use
the special value: <stdin>. To read the password from a file, use: <f:/path/to/file> (i.e. <f:
followed by the full path to the file and a trailing >). The angle brackets in the above are
required, remember to escape them or use quotes for your shell.
--username
Nome de usuário para conectar ao servidor de conteúdo do Calibre
--version
mostrar número da versão do programa e sair
LIST
calibredb list [opções]
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--ascending
Ordenar resultados em ordem ascendente
--fields, -f
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.
--for-machine
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.
--limit
O número máximo de resultados para exibir. Padrão: tudo
--line-width, -w
A largura máxima de uma única linha na saída. O padrão é detectar o tamanho da tela.
--prefix
O prefixo do caminho de todos arquivos. O padrão é o caminho completo até a pasta da biblioteca.
--search, -s
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.
--separator
O Caractere usado para separar os campos. O padrão é um espaço.
--sort-by
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.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--authors, -a
Configure o(s) autor(es) do(s) livro(s) adicionado(s)
--cover, -c
Caminho para a capa para usar no livro adicionado
--duplicates, -d
Adicionar livros para a base de dados mesmo se eles já existirem. Comparação é feita baseada nos
títulos dos livros.
--empty, -e
Adicionar um livro vazio (um livro sem formatos)
--identifier, -I
Defina identificadores para esse livro, como: -I asin:XXX -I isbn:YYY
--isbn, -i
Configure o ISBN do(s) livro(s) adicionado(s)
--languages, -l
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)
--series, -s
Configure as séries do(s) livro(s) adicionado(s)
--series-index, -S
Configure o número de série do(s) livro(s) adicionado(s)
--tags, -T
Configure as etiquetas do(s) livro(s) adicionado(s)
--title, -t
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.
--add 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.
--ignore
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
--one-book-per-directory, -1
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
--recurse, -r
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).
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--permanent
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.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--dont-replace
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.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/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.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--as-opf
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.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--field, -f
O campo a ser definido. O formato é field_name:value, por exemplo: --field tags:tag1,tag2. 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.
--list-fields, -l
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.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--all Exportar todos os livros do banco de dados, ignorando a lista de IDs.
--dont-asciiize
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
--dont-save-cover
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
--dont-update-metadata
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
--dont-write-opf
Normalmente, calibre escreverá os metadados dentro de arquivos OPF separados com os arquivos de
e-book atuais. Especificar esta mudança desligará este comportamento
--formats
Lista separada por vírgulas de formatos para salvar cada livro. Por padrão todos formatos
disponíveis são salvos.
--progress
Relatar progresso
--replace-whitespace
Substituir espaços em branco por "_".
--single-dir
Exportar todos os livros em um diretório
--template
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}
--timefmt
O formato para exibir datas. %d - dia, %b - mês, %m - número do mês, %Y - ano. O padrão é: %b, %Y
--to-dir
Exportar livros para o diretório especificado. O padrão é .
--to-lowercase
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.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--ids, -i
Lista separada por vírgulas dos IDs da base de dados do catálogo. Se declarado, --search será
ignorado. Padrão: todos
--search, -s
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
--verbose, -v
Mostrar informação detalhada de saída. Útil para depuração
EPUB OPÇÕES
--catalog-title
Title of generated catalog used as title in metadata. Default: 'My Books' Applies to: AZW3, EPUB,
MOBI output formats
--cross-reference-authors
Create cross-references in Authors section for books with multiple authors. Default: 'False'
Applies to: AZW3, EPUB, MOBI output formats
--debug-pipeline
Save the output from different stages of the conversion pipeline to the specified directory.
Useful if you are unsure at which stage of the conversion process a bug is occurring. Default:
'None' Applies to: AZW3, EPUB, MOBI output formats
--exclude-genre
Regex describing tags to exclude as genres. Default: '[.+]|^+$' excludes bracketed tags, e.g.
'[Project Gutenberg]', and '+', the default tag for read books. Applies to: AZW3, EPUB, MOBI
output formats
--exclusion-rules
Specifies the rules used to exclude books from the generated catalog. The model for an exclusion
rule is either ('<rule name>','Tags','<comma-separated list of tags>') or ('<rule name>','<custom
column>','<pattern>'). For example: (('Archived books','#status','Archived'),) will exclude a book
with a value of 'Archived' in the custom column 'status'. When multiple rules are defined, all
rules will be applied. Default: "(('Catalogs','Tags','Catalog'),)" Applies to: AZW3, EPUB, MOBI
output formats
--generate-authors
Include 'Authors' section in catalog. Default: 'False' Applies to: AZW3, EPUB, MOBI output formats
--generate-descriptions
Include 'Descriptions' section in catalog. Default: 'False' Applies to: AZW3, EPUB, MOBI output
formats
--generate-genres
Include 'Genres' section in catalog. Default: 'False' Applies to: AZW3, EPUB, MOBI output formats
--generate-recently-added
Include 'Recently Added' section in catalog. Default: 'False' Applies to: AZW3, EPUB, MOBI output
formats
--generate-series
Include 'Series' section in catalog. Default: 'False' Applies to: AZW3, EPUB, MOBI output formats
--generate-titles
Include 'Titles' section in catalog. Default: 'False' Applies to: AZW3, EPUB, MOBI output formats
--genre-source-field
Source field for 'Genres' section. Default: 'Etiquetas' Applies to: AZW3, EPUB, MOBI output
formats
--header-note-source-field
Custom field containing note text to insert in Description header. Default: '' Applies to: AZW3,
EPUB, MOBI output formats
--merge-comments-rule
#<custom field>:[before|after]:[True|False] specifying: <custom field> Custom field containing
notes to merge with Comments [before|after] Placement of notes with respect to Comments
[True|False] - A horizontal rule is inserted between notes and Comments Default: '::' Applies to:
AZW3, EPUB, MOBI output formats
--output-profile
Specifies the output profile. In some cases, an output profile is required to optimize the catalog
for the device. For example, 'kindle' or 'kindle_dx' creates a structured Table of Contents with
Sections and Articles. Default: 'None' Applies to: AZW3, EPUB, MOBI output formats
--prefix-rules
Specifies the rules used to include prefixes indicating read books, wishlist items and other
user-specified prefixes. The model for a prefix rule is ('<rule name>','<source
field>','<pattern>','<prefix>'). When multiple rules are defined, the first matching rule will be
used. Default: "(('Read books','tags','+','✓'),('Wishlist item','tags','Wishlist','×'))" Applies
to: AZW3, EPUB, MOBI output formats
--preset
Use a named preset created with the GUI catalog builder. A preset specifies all settings for
building a catalog. Default: 'None' Applies to: AZW3, EPUB, MOBI output formats
--thumb-width
Size hint (in inches) for book covers in catalog. Range: 1.0 - 2.0 Default: '1.0' Applies to:
AZW3, EPUB, MOBI output formats
--use-existing-cover
Replace existing cover when generating the catalog. Default: 'False' Applies to: AZW3, EPUB, MOBI
output formats
SAVED_SEARCHES
calibredb saved_searches [options] (list|add|remove)
Manage the saved searches stored in this database. If you try to add a query with a name that already
exists, it will be replaced.
Syntax for adding:
calibredb saved_searches add search_name search_expression
Syntax for removing:
calibredb saved_searches remove search_name
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/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
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--display
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.
--is-multiple
Este campo armazena dados como etiquetas (ex. 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.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--details, -d
Mostrar detalhes para cada campo.
REMOVE_CUSTOM_COLUMN
calibredb remove_custom_column [options] label
Remove the custom column identified by label. You can see available columns with the custom_columns
command.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--force, -f
Não pedir confirmação
SET_CUSTOM
calibredb set_custom [options] column id value
Set the value of a custom column for the book identified by id. You can get a list of ids using the
search command. You can get a list of custom column names using the custom_columns command.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--append, -a
Se o campo possibilitar armazenar diversos valores, não sobrescreva os valores adicione os valores
especificados aos já existentes.
RESTORE_DATABASE
calibredb restore_database [options]
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 dispositivos, 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
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--really-do-it, -r
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
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--csv, -c
Saída em CSV
--ignore_extensions, -e
Lista de extensões separadas por vírgula para ignorar. Padrão: tudo
--ignore_names, -n
Lista de nomes separados por vírgula para ignorar. Padrão: tudo
--report, -r
Lista de relatórios separados por vírgula. Padrão: tudo
LIST_CATEGORIES
calibredb list_categories [options]
Produzir um relatório das informações da categoria no banco de dados. A informação é equivalente a que é
mostrada no painel de etiquetas.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--categories, -r
Lista de categorias separadas por vírgula para pesquisar nomes. Padrão: tudo
--csv, -c
Saída em CSV
--dialect
Tipo de arquivo CSV que será produzido. Escolhas: excel, excel-tab
--item_count, -i
Processa apenas o número de itens em uma categoria, em vez das contagens por item dentro da
categoria
--width, -w
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.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--all 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.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/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
sejam atualizados no local. Observe que diferentes formatos de arquivos suportam diferentes
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
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--only-formats, -f
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 é utilizado em 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
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation
marks. For example: "/some path/with spaces"
--limit, -l
O número máximo de resultados para retornar. O padrão é todos os resultados.
AUTHOR
Kovid Goyal
COPYRIGHT
Kovid Goyal
3.21.0 abril 06, 2018 CALIBREDB(1)