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. Be careful though, because some browsers, primarily Firefox, allow arbitrary websites to also access local servers. If you use Firefox, it is better to setup username and password, as described below. Local Network Access restriction has still not been implemented as of Firefox v149.
  • 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.

  • ГЛОБАЛНИ ОПЦИИ
  • list
  • add
•
ДОБАВЯНЕ ОТ ПАПКИ

  • remove
  • add_format
  • remove_format
  • show_metadata
  • set_metadata
  • export
  • catalog
•
EPUB ОПЦИИ

  • saved_searches
  • add_custom_column
  • custom_columns
  • remove_custom_column
  • set_custom
  • restore_database
  • check_library
  • list_categories
  • backup_metadata
  • clone
  • embed_metadata
  • search
  • fts_index
  • fts_search
  • notes
  • items
  • virtual_libraries
  • annotations
  • trash
  • data_files

ГЛОБАЛНИ ОПЦИИ

Покажи това помощно съобщение и излез

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

Парола за свързване към calibre Съдържание сървър. За да четене на паролата от стандартен вход, използвайте специалната стойност: <stdin>. За четене на паролата от файл, в употреба: <f:/path/to/file> (т.е. <f: последвано от пълния път към файла и следващ >). Ъгловите скоби в горното са необходими, не забравяйте да избягате от тях или използвайте кавички за вашия shell.

Таймаутът, в секунди, при свързване към calibre библиотека над мрежата. По подразбиране е две минути.

Име на потребител за свързване към calibre сървър за отдалечено съдържание

покажи версия на програмата и излез

LIST

calibredb списък [options]


Списък на книгите, налични в calibre базата данни.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Сортиране на резултатите възходящо

Полетата, които да се показват при изброяване на книги в базата данни. Трябва да бъде списък на разделени със запетаи полета. Налични полета: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid По подразбиране: title,authors. Специалното поле "всички" може да се използва за избор на всички полета. В допълнение към вградените полета по-горе, потребителски полета също са достъпни като *field_name, например за потребителско поле #rating използвайте името: *оценка

Генерирайте изход във формат JSON, който е по-подходящ за машинен разбор. Води до игнориране ширината на ред и разделител опции.

Максималният брой резултати за показване. По подразбиране: всички

Максималната ширина на един ред в изхода. По подразбиране е за откриване размер на екрана.

Префиксът за всички файлови пътища. По подразбиране е абсолютният път към папката на библиотеката.

Филтрирайте резултатите по заявката за търсене. За формата на заявката за търсене, моля, вижте свързаната с търсенето документация в Ръководството за потребителя. По подразбиране е да не се прави филтриране.

Низът, използван за разделяне на полета. По подразбиране е интервал.

The field by which to sort the results. You can specify multiple fields by separating them with commas. Available fields: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Default: id. In addition to the builtin fields above, custom fields are also available as *field_name, for example, for a custom field #rating, use the name: *rating

The template to run if "template" is in the field list. Note that templates are ignored while connecting to a calibre server. Default: None

Път до файл, съдържащ шаблона за изпълнение, ако "template" е в списъка с полета. По подразбиране: Няма

Заглавка за колоната на шаблона. По подразбиране: template. Тази опция се игнорира, ако опцията --for-machine е зададена

ADD

calibredb добавяне [опции] файл1 файл2 файл3 ...


Добавете посочените файлове като книги в базата данни. Може също да зададете папки, вижте свързаните с папката опции по-долу.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Задай автора на добавените книга(-и)

Ако се намерят книги с подобни заглавия и автори, слейте входящите формати (файлове) автоматично в съществуващи записи на книги. Стойност на "игнорирай" означава, че дублирани формати се изхвърлят. Стойност на "презапис" означава, че дублирани формати в библиотеката се презаписват с новодобавените файлове. Стойност от "нов_запис" означава, че дублирани формати са поставени в нов запис на книга.

Път към корицата, която да се използва за добавената книга

Добави книги към БД, дори ако вече ги има. Сравнението е въз основа върху заглавия и автори. Забележка, че опцията --automerge има предимство.

Добави празна книга (книга без форматиране)

Задайте идентификаторите за тази книга, например -I asin:XXX -I isbn:YYY

Задай ISBN номера на добавените книга(-и)

Списък със езици, разделени със запетаи (най-добре да използвате езикови кодове ISO639, макар че някои имена на езици също могат да бъдат разпознати)

Задай поредицата на добавените книга(-и)

Задай номер на поредица на добавените книга(-и)

Задай етикетите на добавените книга(-и)

Задай заглавия на добавените книга(-и)

ДОБАВЯНЕ ОТ ПАПКИ

Опции за контрол на добавянето на книги от папки. По подразбиране само файлове които имат разширения на известни типове файлове на е-книга се добавят.

Шаблон на файл-име (glob), файлове, отговарящи на този шаблон, ще бъдат добавени, при сканиране на папки за файлове, дори ако те не са на известен тип файл за е-книга. Може да се посочи няколко пъти за няколко шаблона.

Шаблон за файл-имена (glob), файлове, отговарящи на този модел, ще бъдат игнорирани, при сканиране на папки за файлове. Може да се зададе няколко пъти за няколко шаблона. Например: *.pdf ще игнорира всички PDF файлове

Да предположим, че всяка папка има само една логическа книга и че всички файлове в папката са различни формати на е-книги на тази книга

Рекурсивна обработка на папки

REMOVE

calibredb премахване на ids


Премахнете книгите, идентифицирани от ids, от базата данни. ids трябва да бъде списък от разделени със запетая id номера (може да получите id номера използвайки командата за търсене). Например 23,34,57-85 (при указване на диапазон, последното число в диапазона не е включено).

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Do not use the trash bin

ADD_FORMAT

calibredb add_format [options] id ebook_file


Добавете е-книга в ebook_file към наличните формати за логическата книга, идентифицирана чрез ID. Може да получите ID с помощта на командата за търсене. Ако форматът вече съществува, той се заменя, освен ако опцията - не замествай, е зададена.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Add the file as an extra data file to the book, not an ebook format

Не подменяй форматирането, ако е налично такова

REMOVE_FORMAT

calibredb remove_format [options] id fmt


Премахнете формата fmt от логическата книга, идентифицирана с ID. Може да получите ID с помощта на командата за търсене. FMT трябва да бъде разширение на файла като LRF или TXT или EPUB. Ако логическата книга няма налична FMT, не правете нищо.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

SHOW_METADATA

calibredb show_metadata [options] id


Показване на метаданните, съхранени в calibre базата данни за книгата, идентифицирана от id. id е id номер от командата за търсене.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Разпечатване на метаданни в OPF формат (XML)

SET_METADATA

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


Задайте метаданните, съхранявани в базата данни на calibre за книгата, идентифицирана от book_id от OPF файла metadata.opf. book_id е идентификационен номер на книга от команда за търсене. Може бързо да усетите OPF формата, като използвате --as-opf преминете към командата show_metadata. Може също да зададете метаданните на отделни полета с опцията --field. Ако използвате опцията --field, няма нужда да указвате OPF файл.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Полето за задаване. Форматът е field_name:стойност, например: --field етикети:tag1,tag2. Използвайте --list-fields, за да получите списък с всички имена на полета. Може да зададете тази опция няколко пъти, за да зададете няколко полета. Забележка: За езиците вие трябва да използвате езиковите кодове ISO639 (например en за английски, fr за френски и така нататък). За идентификатори синтаксисът е --field identifiers:isbn:XXXX,doi:YYYYY. За булеви (да/не) полета използвайте вярно и невярно или да и не.

Списък с имена на полета метаданни, които могат да се използват с опцията --field

EXPORT

calibredb export [options] ids


Export the books specified by ids (a comma separated list) to the filesystem. The export operation saves all formats of the book, its cover and metadata (in an OPF file). Any extra data files associated with the book are also saved. You can get id numbers from the search command.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Експортирай всички книги в базата данни, игнорирайки списъка от идентификатори.

Calibre конвертира всички не английски знаци в английски еквиваленти за имената на файлове. Това е полезно, ако записването е в наследена файл-система без пълна подкрепа за Уникод файл-имена. Задаването на тази опция ще деактивира това действие.

Обикновено, calibre ще запише корицата в отделен файл заедно с действителните файлове на е-книги. Задаването на тази опция ще деактивира това действие.

Save any data files associated with the book when saving the book Задаването на тази опция ще деактивира това действие.

Обикновено, calibre ще актуализира метаданните в записаните файлове от това, което е в библиотеката на calibre. По-бавен запис на диск. Задаването на тази опция ще деактивира това действие.

Обикновено, calibre ще напише метаданните в отделен OPF файл заедно с актуалните файлове на е-книги. Задаването на тази опция ще деактивира това действие.

Списък със формати, разделени със запетая, за да запазите за всяка книга. По подразбиране всички налични формати се запазват.

Доклад за напредъка

--replace-whitespace
Заместване на интервалите с подчертаване.

Експорт на всички книги в единична папка

Шаблонът за контрол на файл-име и структурата на папка на записаните файлове. По подразб. е "{author_sort}/{title}/{title} - {authors}" който ще запише книги в в подпапка която ще запише книги в подпапка за автор с файл-име, съдържащо заглавие и автор. Наличните контроли са: {author_sort, authors, id, isbn, languages, last_modified, pages, pubdate, publisher, rating, series, series_index, tags, timestamp, title}

Форматът, в който да се показват дати. %d - ден, %b - месец, %m - номер на месец, %Y - година. По подразб. е: %b, %Y

Експорт на книги в указаната папка. По подразб. е .

Конвертиране на пътища в малки букви.

CATALOG

calibredb каталог /път/към/дестинация.(csv|epub|mobi|xml...) [options]


Експорт на каталог във формат, зададен по разширение път/към/дестинация. Опциите контролират начина за показване на записите в генерирания изход на каталога. Имайте предвид, че различните формати на каталога поддържат различни набори от опции. За да видите различните опции, задайте името на изходния файл и след това --help опцията.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Разделен със запетаи списък с идентификатори на бази данни към каталог. Ако бъде обявено, --търсене се игнорира. По подразбиране: всички

Филтрирайте резултатите по заявката за търсене. За формата на заявката за търсене, моля, вижте документацията, свързана с търсенето, в Ръководството за потребителя. По подразбиране: без филтриране

Показване на подробна изходна информация. Полезно за отстраняване на грешки

EPUB ОПЦИИ

Заглавие на генериран каталог, използван като заглавие в метаданни. По подразб.: 'My Books' Прилага се за: AZW3, EPUB, MOBI изходни формати

Създаване на кръстосани препратки в секция Автори за книги с няколко автори. По подразб.: 'False' Прилага се за: AZW3, EPUB, MOBI изходни формати

Запазете изхода от различни етапи на конверсионния процес в посочената папка. Полезно, ако не сте сигурни на кой етап от процеса на конвертиране се появява бъг. По подразб.: 'None' Прилага се за: AZW3, EPUB, MOBI изходни формати

Regex описващи етикети, за изключване като жанрове. По подразб.: '[.+]|^+$' изключва етикети в скоби, например '[Project Gutenberg]', и '+', етикета по подразбиране за четени книги. Прилага се за: AZW3, EPUB, MOBI изходни формати

Посочва правилата, използвани за изключване на книги от генерирания каталог. Моделът за изключващо правило е или ('<rule name>','Tags','<comma-separated list of tags>') или ('<rule name>','<custom column>','<pattern>'). Например: (('Архивирани книги','#състояние','Архивирани'),) ще изключи книга със стойност 'Архивирана' в потребителската колона 'състояние'. Когато са дефинирани няколко правила, всички правила ще бъдат приложени. По подразб.: "(('Catalogs','Tags','Catalog'),)" Прилага се за: AZW3, EPUB, MOBI изходни формати

Включете секция 'Автори' в каталога. По подразб.: 'False' Прилага се за: AZW3, EPUB, MOBI изходни формати

Включете секция 'Описания' в каталог. По подразб.: 'False' Прилага се за: AZW3, EPUB, MOBI изходни формати

Включете секция 'Жанрове' в каталог. По подразб.: 'False' Прилага се за: AZW3, EPUB, MOBI изходни формати

Включете секция 'Последно добавено' в каталог. По подразб.: 'False' Прилага се за: AZW3, EPUB, MOBI изходни формати

Включете секция 'Серия' в каталог. По подразб.: 'False' Прилага се за: AZW3, EPUB, MOBI изходни формати

Включете секция 'Заглавия' в каталог. По подразб.: 'False' Прилага се за: AZW3, EPUB, MOBI изходни формати

Поле източник за секция 'Жанрове'. По подразб.: 'Етикети' Прилага се за: AZW3, EPUB, MOBI изходни формати

Персонализирано поле, съдържащо текст на бележка за вмъкване в заглавката на описанието. По подразб.: '' Прилага се за: AZW3, EPUB, MOBI изходни формати

#<custom field>:[before|after]:[True|False] указващо: <custom field> Персонализирано поле, съдържащо бележки за обединяване с коментари [before|after] Поставяне на бележки по отношение на коментари [True|False] - Хоризонтално правило се вмъква между бележки и коментари По подразб.: '::' Прилага се за: AZW3, EPUB, MOBI изходни формати

--output-profile
Посочва изходния профил. В някои случаи се изисква изходен профил за оптимизиране на каталога за устройството. Например, 'kindle' или 'kindle_dx' създава структурирана Таблица на съдържанието със секции и артикули. По подразб.: 'None' Прилага се за: AZW3, EPUB, MOBI изходни формати

--prefix-rules
Указва правилата, използвани за включване на префикси, указващи прочетени книги, елементи от списъка с желания и други зададени от потребителя префикси. Моделът за префикс правило е ('<rule name>','<source field>','<pattern>','<prefix>'). Когато се дефинират няколко правила, ще се използва първото съвпадащо правило. По подразб.: "(('Read books','tags','+','✓'),('Wishlist item','tags','Wishlist','×'))" Прилага се за: AZW3, EPUB, MOBI изходни формати

Използвайте наименувана преднастройка, създадена със строителя на GUI каталог. Преднастройка посочва всички настройки за изграждане на каталог. По подразб.: 'None' Прилага се за: AZW3, EPUB, MOBI изходни формати

Подсказка за размер (в инча) на корици за книги в каталог. Обхват: 1.0 - 2.0 По подразб.: '1.0' Прилага се за: AZW3, EPUB, MOBI изходни формати

Заменете налична корица при генериране на каталога. По подразб.: 'False' Прилага се за: AZW3, EPUB, MOBI изходни формати

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 listing, the default action:

calibredb saved_searches list

Syntax for adding:

calibredb saved_searches add search_name search_expression

Syntax for removing:

calibredb saved_searches remove search_name

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

ADD_CUSTOM_COLUMN

calibredb add_custom_column [options] тип данни за име на етикет


Създаване на персонализирана колона. Етикет е машинното приятелско име на колоната. Трябва да не съдържа интервали или двоеточие. Име е човешкото приятелско име на колоната. типът данни е един от: bool, comments, composite, datetime, enumeration, float, int, rating, series, text

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Речник с опции за персонализиране на начина, по който данните в тази колона ще бъдат интерпретирани. Това е JSON низ. За колони за изброяване използвайте --display"{\ "enum_values\ ":[\ "val1\ ", \ "val2\ "]}" Има много опции, които могат да отидат в променливата на дисплея. Опциите по тип колона са: съставен: composite_template, composite_sort, make_category,contains_html, use_decorations време-дата: date_format изброяване: enum_values, enum_colors, use_decorations int, float: number_format text: is_names, use_decorations Най-добрият начин да намерите легални комбинации е да създадете персонализирана колона от подходящ тип в GUI след това да разгледате резервния OPF за книга (гарантирайте, че след добавянето на колоната е създаден нов OPF). Ще видите JSON за "дисплея" за новата колона в OPF.

Тази колона съхранява етикет като данни (т.е. множество стойности, разделени със запетаи). Важи само ако типът на данните е текст.

CUSTOM_COLUMNS

calibredb custom_columns [options]


Списък с налични персонализирани колони. Показва етикети на колони и идентификатори.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Покажи детайли за всяка колона

REMOVE_CUSTOM_COLUMN

calibredb remove_custom_column [options] етикет


Премахнете потребителската колона, идентифицирана по етикет. Може да видите налични колони с командата custom_columns.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Не изисквай потвърждение

SET_CUSTOM

calibredb set_custom [options] column id value


Задайте стойността на персонализирана колона за книгата, идентифицирана от id. Може да получите списък с идентификатори с помощта на командата за търсене. Може да получите списък с персонализирани имена на колони с помощта на custom_columns командата.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Ако колоната съхранява няколко стойности, прибавете зададените стойности към съществуващите, вместо да се заместват.

RESTORE_DATABASE

calibredb restore_database [options]


Restore this database from the metadata stored in OPF files in each folder of the calibre library. This is useful if your metadata.db file has been corrupted.

WARNING: This command completely regenerates your database. You will lose all saved searches, user categories, plugboards, stored per-book conversion settings, and custom recipes. Restored metadata will only be as accurate as what is found in the OPF files.

The exit status is 0 if the restore succeeded, 1 if it failed completely and 2 if the database was restored but some books or other data could not be.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/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, malformed_formats, malformed_paths, failed_folders

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Изход в CSV

Разделен със запетаи списък с разширения за игнориране. По подразбиране: всички

Разделен със запетаи списък с имена, които да се игнорират. По подразбиране: всички

Разделен със запетаи списък на отчетите. По подразбиране: всички

Вакуумирайте базата данни за търсене в пълен текст. Това може да е много бавно и интензивно за паметта, в зависимост от размера на базата данни.

LIST_CATEGORIES

calibredb list_categories [options]


Изготвяне на отчет за информация на категорията в базата данни. Информацията е еквивалент на това, което е показано в Етикети браузъра.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Разделен със запетаи списък с имена на справки за категории. По подразбиране: всички

Изход в CSV

Типът на CSV файл за производство. Избори: excel, excel-tab, unix

Изведете само броя на елементите в категория вместо преброявания за елемент в рамките на категорията

Максималната ширина на един ред в изхода. По подразбиране е за откриване размер на екрана.

BACKUP_METADATA

calibredb backup_metadata [options]


Архивиране на метаданните, съхранени в базата данни в отделни OPF файлове във всяка папка с книги. Това обикновено се случва автоматично, но може да стартирате тази команда за принудително повторно генериране на файловете OPF, с опцията --всички.

Имайте предвид, че обикновено няма нужда да правите това, тъй като OPF файловете се архивират автоматично, всеки път, когато метаданните се променят.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Обикновено тази команда работи само на книги, които имат извън датата OPF файлове. Тази опция я кара да работи на всички книги.

CLONE

calibredb клонинг път/към/нова/библиотека


Създаван клонинг на текущата библиотека. Това създава нова, празна библиотека, която има същите всички персонализирани колони, Виртуални библиотеки и други настройки като текущата библиотека.

Клонираната библиотека няма да съдържа книги. Ако искате да създадете пълен дубликат, включително всички книги, просто използвайте инструментите за файлова система, за да копирате папката на библиотеката.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

EMBED_METADATA

calibredb embed_metadata [options] book_id


Актуализиране на метаданните в актуалните файлове на книги, съхранени в calibre библиотеката от метаданните в calibre база данни. Обикновено метаданните се актуализират само когато се експортират файлове от calibre, тази команда е полезна, ако искате файловете да бъдат актуализирани на място. Имайте предвид, че различните файлови формати поддържат различни суми на метаданни. Може да използвате специалната стойност 'всички' за book_id към актуализиране на метаданни във всички книги. Може също да зададете много идентификатори на книги, разделени с интервали и диапазони на идентификатори разделени с тирета. Например: calibredb embed_metadata 1 2 10-15 23

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Актуализиране само на метаданни във файлове на посочения формат. Задайте гó няколко пъти за няколко формата. По подразбиране всички формати се актуализират.

SEARCH

calibredb search [options] search expression


Търсене в библиотеката за посочен термин за търсене, връщане на разделен със запетаи списък с книжен идентификатор, съвпадащ на израза за търсене. Изходният формат е полезен за да се хранят в други команди, които приемат списък с идентификатори като вход.

Изразът за търсене може да бъде всичко от мощната заявка за търсене на calibre език, например: calibredb търсене author:asimov 'title:"i robot"'

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Максимален брой резултати, който да бъде върнат. По подразбиране са всички резултати.

FTS_INDEX

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


Контролирайте процеса на индексиране при търсене в пълен текст.

Включва FTS индексирането за тази библиотека
Изключва FTS индексирането за тази библиотека
Показва текущото състояние на индексиране
Може да се използва за повторно индексиране на определени книги или цялата библиотека. За повторно индексиране на определени книги посочете ИД на книгите като допълнителни аргументи след reindex команда. Ако не са посочени идентификатори на книги, цялата библиотека се индексира повторно.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Скоростта на индексиране. Използвайте за бързо индексиране чрез всичките ви компютърни ресурси и бавно за по-малко ресурсоемко индексиране. Забележете, че скоростта се нулира, за да се забави след всяко извикване.

Изчакайте, докато всички книги бъдат индексирани, показвайки периодично напредъка на индексирането

FTS_SEARCH

calibredb fts_search [options] израз за търсене


Извършете пълно текстово търсене в цялата библиотека или част от нея.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Съвпадение само на точни думи, несвързани думи. Така че корекцията няма да съвпада с коригирането.

Включете фрагменти от текста около всяко съвпадение. Имайте предвид, че това прави търсенето много по-бавно.

Колко от библиотеката трябва да е индексирана, преди търсенето да бъде разрешено, като процент. По подразбиране е 90

Маркерът, използван за обозначаване на края на съвпадаща дума във фрагмент

Маркерът, използван за обозначаване на началото на съвпадаща дума във фрагмент

--output-format
Форматът за извеждане на резултатите от търсенето. Или "text" за обикновен текст или "json" за JSON извеждане.

Ограничете търсените книги, като използвате израз за търсене или идентификатори. За пример: ids:1,2,3 за ограничаване по ИД или search:tag:foo за ограничаване до книги с етикет foo.

NOTES

calibredb notes [options] [list|search|show|set|remove]


Manage the notes attached to items such as authors, series, tags and publishers. FIELD is the lookup name of the field, for example: authors, series, tags, publisher or #mycolumn. ITEM is the name of the item, for example the name of an author. Items are matched case insensitively.

List the items that have notes, optionally only those in the specified field. This is the default action:

calibredb notes list [FIELD]

Search the text of notes using the same SQLite full text search syntax as the Browse notes tool in calibre. Print the field, item name and an excerpt for each match. Use --field to search only the notes in a particular field:

calibredb notes search "search expression" calibredb notes search --field authors "search expression"

Print the note for an item as Markdown formatted text, or with --as-html as an HTML document with any images embedded, suitable for use with set:

calibredb notes show FIELD ITEM

Replace the note for an item with the contents of an HTML file. Use - to read the HTML from standard input. Images embedded as base64-encoded data: URLs are added to the note for both local and remote libraries. When using a local library and reading from a file, images referenced by paths relative to the file are added as well:

calibredb notes set FIELD ITEM FILE

Remove the note for an item:

calibredb notes remove FIELD ITEM

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

When showing a note, output it as HTML instead of Markdown formatted text

When searching notes, restrict the search to this field, for example: authors, tags or #mycolumn

ITEMS

calibredb items [options] (rename|remove) FIELD ITEM ...


Rename or remove items such as authors, tags, series and publishers in all books, the same as the Manage authors, tags, etc. actions in the calibre interface. FIELD is the lookup name of the field, for example: authors, tags, series, publisher or #mycolumn. Items are matched case insensitively.

Rename an item. If an item named NEW_NAME already exists, the two items are merged. For fields that contain multiple values, NEW_NAME can contain more than one value, separated by the separator for the field, for example a comma for tags. The item is then replaced by all the values:

calibredb items rename FIELD ITEM NEW_NAME

Remove one or more items from all books. Authors cannot be removed:

calibredb items remove FIELD ITEM [ITEM ...]

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Only change books that match the specified search expression, for example: tags:"=Fiction"

VIRTUAL_LIBRARIES

calibredb virtual_libraries [options] [list|add|rename|remove]


Manage the Virtual libraries of this library. A Virtual library is a search that behaves as though the library contains only the books it matches. To list or search the books in a Virtual library, use: calibredb search 'vl:"name"'

List the Virtual libraries, with their searches and number of books. This is the default action:

calibredb virtual_libraries list

Create a Virtual library from a search:

calibredb virtual_libraries add name search_expression

Rename a Virtual library:

calibredb virtual_libraries rename name new_name

Remove Virtual libraries, the books in them are not changed:

calibredb virtual_libraries remove name ...

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Generate output in JSON format, which is more suitable for machine parsing

Replace the search of an existing Virtual library with the same name when adding

ANNOTATIONS

calibredb annotations [options] [list|search|export|import|remove]


Manage the annotations, that is the highlights and bookmarks, of books, as created in the calibre E-book viewer or synced from other applications.

List the annotations, with their ids. This is the default action:

calibredb annotations list

Search highlighted text, annotation notes and bookmark titles using the same SQLite full text search syntax as the Browse annotations tool. Results are ordered by relevance and include annotation ids, book titles and matching excerpts. Use --search to restrict the books, --type to restrict the annotation type, --user-type and --annotation-user to restrict the user, --no-stemming to match exact word forms, or --format json for a JSON array of results including the annotation data and excerpts:

calibredb annotations search "search expression"

Export the annotations as plain text, Markdown or JSON, grouped by book. The JSON is the same calibre annotation collection as created by the Export button in the Browse annotations tool:

calibredb annotations export

Import a calibre annotation collection exported as JSON by this command or the Browse annotations tool. The collection must contain annotations from only one book. BOOK_ID is the destination book id, not the id stored in the file. Only the annotations of the format FORMAT are imported, annotations of other formats are skipped. FORMAT must exist in the destination book. Use the same edition of the book so positions match:

calibredb annotations import BOOK_ID FORMAT FILE

Use - for FILE to read from standard input. The entire collection is validated before importing. Annotations are merged with existing ones using the viewer's rules: highlights are matched by UUID and bookmarks by title, and the newer timestamp wins. Repeated imports do not create duplicates. Unrelated annotations and reading positions are preserved.

By default annotations are imported into those of the calibre E-book viewer. Use --user-type web --annotation-user USER to import them into those of a Content server user instead. Exported collections record the user the annotations belong to, and if a collection contains annotations of more than one user, it is rejected. Use the --user-type and --annotation-user options when exporting, to export the annotations of a single user.

Permanently remove the annotations with the specified ids, as shown by list:

calibredb annotations remove ID ...

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Only list, search or export the annotations of the specified user. For import, the Content server user to import the annotations for, required with --user-type web. Note that this can be any user, not just the one used to connect to a remote library.

The export format, one of: text, markdown, json. For search, text or json. Default is: text

For search, match exact word forms instead of word stems

Only list, search or export the annotations of books matching the specified book search query, for example: --search "series:Foundation"

Only list, search or export annotations of the specified type, one of: highlight, bookmark

Only list, search or export the annotations of the specified type of user. For import, the type of user to import the annotations for, the calibre E-book viewer (local) or a Content server user (web). Default for import is local.

TRASH

calibredb trash [options] (list|restore|delete|empty) [ids]


Manage the books and formats that have been removed and placed in the trash bin. Entries in the trash bin are permanently deleted automatically after some days. ids is a comma separated list of book ids, as for the remove command, for example: 23,34,57-85 (when specifying a range, the last number in the range is not included).

List the removed books and formats, most recently removed first, with the times they were removed in local time. Removed formats of books that no longer exist are marked as not restorable, they can only be deleted. With --for-machine, the times are in UTC:

calibredb trash list

Restore removed books, or with --formats, the removed formats of books:

calibredb trash restore ids

Permanently delete entries from the trash bin:

calibredb trash delete ids

Permanently delete everything in the trash bin:

calibredb trash empty

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Generate output for the list action in JSON format, which is more suitable for machine parsing

Act on the removed formats of the specified books, instead of on removed books

DATA_FILES

calibredb data_files [options] (list|add|get|rename|remove) BOOK_ID ...


Manage the extra data files associated with a book, in local or remote libraries. Names are relative to the book's data directory. Use / for subdirectories, is also accepted. Files whose names contain a are listed, but cannot otherwise be managed. E-book formats, covers and metadata.opf cannot be accessed with this command. Remote libraries require an account with write access, as for other management commands, and do not support accounts with per-library search restrictions.

List file names, sizes in bytes and modification times (seconds since the Unix epoch). Use --for-machine for JSON output:

calibredb data_files list BOOK_ID

Add a file, using its basename, or --name to specify a name or subdirectory. Existing files are not replaced unless --replace is specified. This is also available through add_format --as-extra-data-file:

calibredb data_files add BOOK_ID FILE

Save one data file to --output on the local machine. Existing output files are not replaced unless --replace is specified:

calibredb data_files get BOOK_ID NAME --output FILE

Rename a file. Existing destinations are not replaced unless --replace is set:

calibredb data_files rename BOOK_ID NAME NEW_NAME

Remove a file to the operating system's recycle bin. With --permanent, delete it permanently instead. For remote libraries this happens on the server:

calibredb data_files remove BOOK_ID NAME

Directories left empty by rename and remove are deleted. With remote libraries, each file is transferred in a single request, so very large files need enough memory on both the client and the server, and uploads are limited by the maximum request size of the server.

Винаги, когато предавате аргументи на calibredb, които имат интервали в тях, затворете аргументите в кавички. Например: "/some path/with spaces"

Output the list of files as JSON

Name to use for the added file, relative to the data directory

Local destination for the get action

Permanently delete the data file instead of using the recycle bin

Allow replacing existing files when adding, getting or renaming

Author

Kovid Goyal

Copyright

Kovid Goyal

ноември 06, 2026 9.18.0