| CALIBREDB(1) | calibre | CALIBREDB(1) |
calibredb - calibredb
calibredb command [options] [arguments]
calibredb 是calibre数据库的命令行接口。它有 几个子命令，记录如下。
calibredb 可以用来操作一个 calibre 数据库 由运行在上的 calibre 或 calibre“内容服务器”指定 本地机器或通过互联网。你可以运行一个 calibre “内容服务器”使用：calibre-server`程序 或在主 calibre 程序中单击 “连接/共享 -> 启动内容服务器”。因为`calibredb 可以更改 calibre 书库，必须首先在服务器上设置身份验证。这里 有两种方法：
要连接到正在运行的内容服务器，请将服务器的URL传递给： --with-library 选项，有关详细信息和示例， 请参阅该选项的文档。
calibredb list [options]
列出 calibre 数据库中可用书籍。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb add [选项] file1 file2 file3 ...
将指定文件当做书籍添加到数据库。你可以指定目录，请查看下面目录相关选项。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
`--automerge`选项优先。
用于控制从文件夹添加书籍的选项。默认情况下，只能添加那些受支持的电子书格式的文件。
calibredb remove ids
从数据库删除指定id的书籍。id为以逗号分隔的 id 号列表（你可以使用搜索命令来获得 id 号）。例如，23,34,57-85（如果指定一个区间，该区间的最后一个数字不会被包括在内）。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb add_format [options] id ebook_file
将 ebook_file中的电子书添加到由id标识的书籍的可用格式中。您可以使用搜索命令获取id。如果格式已经存在，则替换它，除非指定了不替换选项。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb remove_format [options] id fmt
从ID标识的逻辑书籍中删除特定格式- fmt。你可以通过使用搜索命令获取id。fmt 应该是形如LRF或TXT或EPUB的一个文件扩展名。如果逻辑书籍没有 fmt 可用则什么也不做。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb show_metadata [options] id
显示在 calibre 数据库中存储的指定id的书籍的元数据。 id是来自搜索命令的id号。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
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"
calibredb export [options] ids
导出指定id(以逗号分隔的列表)的书籍至文件系统。 导出操作将保存书籍的所有格式，以及其封面和元数据(保存 至一个opf文件)。也会保存与书籍相关联的任何额外的数据文件。 你可以使用搜索命令来获得id。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb catalog /path/to/destination.(csv|epub|mobi|xml...) [options]
以 path/to/destination extension 指定的格式导出书目。 选项控制项目在生成的书目中的显示方式。 请注意，不同的书目格式支持不同的选项。 要查看不同的选项，请指定输出文件的名称，然后指定 --help选项。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
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"
calibredb add_custom_column [options] label name datatype
创建一个自定义栏目，栏目名为你自定义的名称，不能包含空格或冒号。数据类型可为：bool, comments, composite, datetime, enumeration, float, int, rating, series, text
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb custom_columns [options]
列出可用的自定义栏目。显示栏目标签和id。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb remove_custom_column [options] label
删除由标签标识的自定义栏目。可以使用custom_columns command命令查看可用栏目。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb set_custom [options] column id value
为 id 标识的书籍设置自定义栏目的值。 您可以使用搜索命令获取id列表。 您可以使用 custom_columns 命令获取自定义栏目名的列表。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb restore_database [options]
从calibre书库每个文件夹中的OPF文件含有的元数据恢复此数据库，如果你的metadata.db文件已损坏，此方法很有用。
警告：此命令会完全重新生成数据库。你会丢失所有搜索记录，自定义分类，元数据处理规则，已保存的每本书的转换设置和自定义的新闻获取规则。恢复的元数据和OPF文件中的一样准确。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
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"
calibredb list_categories [options]
在数据库中生成一个类别信息的报告。 该信息与分类浏览器中显示的信息相同。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb backup_metadata [options]
将存储在数据库中的元数据备份到每个书籍文件夹中的 单个 OPF 文件中。这通常是自动的，但是您可以运行 此命令来强制重新生成 OPF 文件，并使用 --all 选项。
请注意，通常不需要这样做，因为每次元数据更改时， OPF 文件都会自动备份。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb clone path/to/new/library
创建当前书库的副本。这将创建一个新的、空的书库，它所有的自定义栏目、虚拟书库和其他设置与当前书库相同。
副本书库将没有任何书籍。如果您想要创建一个完整的副本书库，包括所有的书籍，那么只需使用您的文件系统工具来复制书库文件夹。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
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"
calibredb search [options] search expression
搜索书库中指定的搜索项，返回与搜索表达式匹配的以逗号分隔的书籍id列表。输出格式对于输入接受id列表的其他命令非常有用。 搜索表达式可以是来自calibre强大的搜索查询语言中的任何内容，例如：calibredb searchauthor:asimov 'title:"i robot"'
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb fts_index [options] enable/disable/status/reindex
控制全文搜索索引进程。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
calibredb fts_search [options] search expression
对整个书库或其子集进行全文搜索。
每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/some path/with spaces"
Kovid Goyal
Kovid Goyal
| 六月 20, 2025 | 8.5.0 |