NAME

calibredb - calibredb

calibredb command [options] [arguments]

calibredb 是calibre数据库的命令行接口。它有 几个子命令，记录如下。

calibredb 可以用来操作一个 calibre 数据库 由运行在上的 calibre 或 calibre“内容服务器”指定 本地机器或通过互联网。你可以运行一个 calibre “内容服务器”使用：calibre-server`程序 或在主 calibre 程序中单击 “连接/共享 -> 启动内容服务器”。因为`calibredb 可以更改 calibre 书库，必须首先在服务器上设置身份验证。这里 有两种方法：

要连接到正在运行的内容服务器，请将服务器的URL传递给： --with-library 选项，有关详细信息和示例， 请参阅该选项的文档。

全局选项

LIST

calibredb list [options]

列出 calibre 数据库中可用书籍。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

ADD

calibredb add [选项] file1 file2 file3 ...

将指定文件当做书籍添加到数据库。你可以指定目录，请查看下面目录相关选项。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

REMOVE

calibredb remove ids

从数据库删除指定id的书籍。id为以逗号分隔的 id 号列表（你可以使用搜索命令来获得 id 号）。例如，23,34,57-85（如果指定一个区间，该区间的最后一个数字不会被包括在内）。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

ADD_FORMAT

calibredb add_format [options] id ebook_file

将 ebook_file中的电子书添加到由id标识的书籍的可用格式中。您可以使用搜索命令获取id。如果格式已经存在，则替换它，除非指定了不替换选项。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

REMOVE_FORMAT

calibredb remove_format [options] id fmt

从ID标识的逻辑书籍中删除特定格式- fmt。你可以通过使用搜索命令获取id。fmt 应该是形如LRF或TXT或EPUB的一个文件扩展名。如果逻辑书籍没有 fmt 可用则什么也不做。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

SHOW_METADATA

calibredb show_metadata [options] id

显示在 calibre 数据库中存储的指定id的书籍的元数据。 id是来自搜索命令的id号。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

SET_METADATA

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

根据 OPF 文件 --metadata.opf 设置存储在 calibre 数据库中的以 book_id 标识的书籍的元数据。 book_id 是来自搜索命令的 id 号。您可以通过使用 --as-opf 切换到 show_metadata 命令来快速 了解 OPF 格式。还可以用 --field 选项设置各个字段的元数据。如果使用 --field 选项则 不需要指定 OPF 文件。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

EXPORT

calibredb export [options] ids

导出指定id(以逗号分隔的列表)的书籍至文件系统。 导出操作将保存书籍的所有格式，以及其封面和元数据(保存 至一个opf文件)。也会保存与书籍相关联的任何额外的数据文件。 你可以使用搜索命令来获得id。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

CATALOG

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

以 path/to/destination extension 指定的格式导出书目。 选项控制项目在生成的书目中的显示方式。 请注意，不同的书目格式支持不同的选项。 要查看不同的选项，请指定输出文件的名称，然后指定 --help选项。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

SAVED_SEARCHES

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

管理存储在此数据库中的搜索记录。 如果尝试添加已经存在的一个名称查询， 则它将被替换。

用于添加的语法：

calibredb saved_searches add search_name search_expression

用于删除的语法：

calibredb saved_searches remove search_name

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

ADD_CUSTOM_COLUMN

calibredb add_custom_column [options] label name datatype

创建一个自定义栏目，栏目名为你自定义的名称，不能包含空格或冒号。数据类型可为：bool, comments, composite, datetime, enumeration, float, int, rating, series, text

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

CUSTOM_COLUMNS

calibredb custom_columns [options]

列出可用的自定义栏目。显示栏目标签和id。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

REMOVE_CUSTOM_COLUMN

calibredb remove_custom_column [options] label

删除由标签标识的自定义栏目。可以使用custom_columns command命令查看可用栏目。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

SET_CUSTOM

calibredb set_custom [options] column id value

为 id 标识的书籍设置自定义栏目的值。 您可以使用搜索命令获取id列表。 您可以使用 custom_columns 命令获取自定义栏目名的列表。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

RESTORE_DATABASE

calibredb restore_database [options]

从calibre书库每个文件夹中的OPF文件含有的元数据恢复此数据库，如果你的metadata.db文件已损坏，此方法很有用。

警告：此命令会完全重新生成数据库。你会丢失所有搜索记录，自定义分类，元数据处理规则，已保存的每本书的转换设置和自定义的新闻获取规则。恢复的元数据和OPF文件中的一样准确。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

CHECK_LIBRARY

calibredb check_library [options]

对书库的文件系统执行一些检查。报告是invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, failed_folders

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

LIST_CATEGORIES

calibredb list_categories [options]

在数据库中生成一个类别信息的报告。 该信息与分类浏览器中显示的信息相同。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

BACKUP_METADATA

calibredb backup_metadata [options]

将存储在数据库中的元数据备份到每个书籍文件夹中的 单个 OPF 文件中。这通常是自动的，但是您可以运行 此命令来强制重新生成 OPF 文件，并使用 --all 选项。

请注意，通常不需要这样做，因为每次元数据更改时， OPF 文件都会自动备份。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

CLONE

calibredb clone path/to/new/library

创建当前书库的副本。这将创建一个新的、空的书库，它所有的自定义栏目、虚拟书库和其他设置与当前书库相同。

副本书库将没有任何书籍。如果您想要创建一个完整的副本书库，包括所有的书籍，那么只需使用您的文件系统工具来复制书库文件夹。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

EMBED_METADATA

calibredb embed_metadata [options] book_id

通过calibre 数据库中的元数据更新存储在 calibre 书库中的实际书籍文件中的元数据。 通常，只有从 calibre 导出文件时才更新元数据，如果希望文件就地更新，则此命 令很有用。请注意，不同的文件格式支持不同数量的元数据。你可以使用book_id 的特殊值“all”来更新所有书籍中的元数据。还可以指定许多由空格分隔的书籍id 和由连字符分隔的ID区间。例如：calibredb embed_metadata 1 2 10-15 23

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

SEARCH

calibredb search [options] search expression

搜索书库中指定的搜索项，返回与搜索表达式匹配的以逗号分隔的书籍id列表。输出格式对于输入接受id列表的其他命令非常有用。 搜索表达式可以是来自calibre强大的搜索查询语言中的任何内容，例如：calibredb searchauthor:asimov 'title:"i robot"'

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

FTS_INDEX

calibredb fts_index [options] enable/disable/status/reindex

控制全文搜索索引进程。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

FTS_SEARCH

calibredb fts_search [options]  search expression

对整个书库或其子集进行全文搜索。

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"

AUTHOR

Kovid Goyal

COPYRIGHT

Kovid Goyal