NAME¶

calibredb - calibredb

calibredb Befehl [Optionen] [Argumente]

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:

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.

GLOBALE OPTIONEN¶

LIST¶

calibredb list [Optionen]

Auflisten der in der Calibre-Datenbank verfügbaren Bücher.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

ADD¶

calibredb add [Optionen] Datei1 Datei2 Datei3 …

Hinzufügen der angegebenen Dateien als Bücher zur Datenbank. Sie können auch Verzeichnisse angeben - vergleichen Sie hierfür die auf Verzeichnisse bezogenen Optionen unten.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

REMOVE¶

calibredb remove IDs

Entfernen der durch IDs bezeichneten Bücher aus der Datenbank. Die IDs müssen in Form einer kommagetrennten Liste von ID-Nummern angegeben werden (Sie können ID-Nummern mithilfe des Suchbefehls erhalten). Beispielsweise 23,34,57-85 (bei Angabe eines Bereichs ist die letzte Nummer im Bereich nicht enthalten).

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

ADD_FORMAT¶

calibredb add_format [Optionen] ID eBook_Datei

Hinzufügen des eBooks in eBook_Datei zu den verfügbaren Formaten für das durch die ID bestimmte logische Buch. Sie können die ID durch die Verwendung des Suchbefehls erhalten. Falls das Format bereits existiert, wird es ersetzt, es sei denn, die "Nicht ersetzen"-Option ist ausgewählt.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

REMOVE_FORMAT¶

calibredb remove_format [Optionen] ID Fmt

Entfernen des Formats Fmt des durch die ID bezeichneten logischen Buches. Sie erhalten die ID durch Verwendung des Suchbefehls. fmt sollte eine Dateinamenerweiterung wie LRF, TXT oder EPUB sein. Falls das logische Buch nicht im angegebenen Format verfügbar ist, passiert gar nichts.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

SHOW_METADATA¶

calibredb show_metadata [Optionen] ID

Anzeigen der in der Calibre-Datenbank gespeicherten Metadaten für das durch die ID bezeichnete Buch. ID ist eine ID-Nummer aus dem Suchbefehl.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

SET_METADATA¶

calibredb set_metadata [Optionen] Buch-ID [/pfad/zu/metadata.opf]

Legt die in der calibre-Datenbank gespeicherten Metadaten für das durch die Buch-ID angegebene Buch anhand der OPF-Datei metadata.opf fest. Die Buch-ID ist eine numerische Kennung, die Sie mit dem Befehl search ermitteln können. Einen schnellen Überblick über das OPF-Format erhalten Sie, indem Sie den Befehl show_metadata mit der Option --as-opf ausführen. Mit der Option --field können Sie auch die Metadaten einzelner Felder festlegen. Wenn Sie diese Option verwenden, müssen Sie keine OPF-Datei angeben.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

EXPORT¶

calibredb export [Optionen] IDs

Exportiert die durch IDs angegebenen Bücher (eine durch Kommas getrennte Liste) in das Dateisystem. Beim Export werden sämtliche Buchformate, das Buchcover und die Metadaten (in einer OPF-Datei) gespeichert. Alle zusätzlichen Datendateien, die dem Buch zugeordnet sind, werden ebenfalls exportiert. Die Buch-IDs können Sie mit dem Befehl search ermitteln.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

CATALOG¶

calibredb catalog /pfad/zur/zieldatei.(csv|epub|mobi|xml...) [Optionen]

Exportiert einen Katalog in dem Format, das durch die /pfad/zur/zieldatei Dateiendung der Zieldatei festgelegt wird.

Die Optionen bestimmen, wie die Einträge im erzeugten Katalog dargestellt werden.

Beachten Sie, dass verschiedene Katalogformate unterschiedliche Optionen unterstützen. Um die verfügbaren Optionen anzuzeigen, geben Sie den Namen der Ausgabedatei und anschließend die Option --help an.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

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

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

ADD_CUSTOM_COLUMN¶

calibredb add_custom_column [Optionen] Bezeichnung Name Datentyp

Erstellen einer benutzerdefinierten Spalte. Bezeichnung ist der maschinenfreundliche Name der Spalte, und sollte keine Leerzeichen oder Doppelpunkte enthalten. Name ist der anwenderfreundliche Name der Spalte. Datentyp ist einer von : bool, comments, composite, datetime, enumeration, float, int, rating, series, text

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

CUSTOM_COLUMNS¶

calibredb custom_columns [Optionen]

Auflisten aller verfügbaren benutzerdefinierten Spalten. Zeigt Spaltenbezeichnungen und IDs an.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

REMOVE_CUSTOM_COLUMN¶

calibredb remove_custom_column [Optionen] Bezeichnung

Entfernen der bezeichneten benutzerdefinierten Spalte. Verfügbare Spalten können durch den Befehl custom_columns angezeigt werden.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

SET_CUSTOM¶

calibredb set_custom [Optionen] Spalte ID Wert

Festlegen des Werts einer benutzerdefinierte Spalte für das durch die ID bezeichnete Buch. Sie erhalten eine Liste der IDs mithilfe des Suchbefehls. Sie erhalten eine Liste der Namen von benutzerdefinierten Spalten mithilfe des Befehls custom_columns.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

RESTORE_DATABASE¶

calibredb restore_database [Optionen]

Stellt die Datenbank anhand der Metadaten wieder her, die in den OPF-Dateien in den einzelnen Ordnern der calibre-Bibliothek gespeichert sind. Dies ist hilfreich, wenn Ihre Datei metadata.db beschädigt wurde.

WARNUNG: Dieser Befehl erstellt Ihre Datenbank vollständig neu. Dabei gehen alle gespeicherten Suchanfragen, Benutzerkategorien, Metadaten-Schalttafeln, gespeicherten buchspezifischen Konvertierungseinstellungen und benutzerdefinierten Nachrichtenrezepte verloren. Die wiederhergestellten Metadaten sind nur so vollständig und korrekt wie die Angaben in den OPF-Dateien.

Der Rückgabewert ist 0, wenn die Wiederherstellung erfolgreich war, 1, wenn sie vollständig fehlgeschlagen ist, und 2, wenn die Datenbank wiederhergestellt wurde, aber einige Bücher oder andere Daten nicht wiederhergestellt werden konnten.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

CHECK_LIBRARY¶

calibredb check_library [Optionen]

Durchführen einiger Überprüfungen des Dateisystems einer Bibliothek. Berichte sind invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, malformed_formats, malformed_paths, failed_folders

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

LIST_CATEGORIES¶

calibredb list_categories [Optionen]

Erstellt einen Bericht über die in der Datenbank gespeicherten Kategorieinformationen. Die Informationen entsprechen denen, die in der Schlagwortverwaltung angezeigt werden.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

BACKUP_METADATA¶

calibredb backup_metadata [Optionen]

Sichert die in der Datenbank gespeicherten Metadaten als einzelne OPF-Dateien im jeweiligen Buchordner. Dies geschieht normalerweise automatisch. Sie können diesen Befehl jedoch mit der Option --all ausführen, um die OPF-Dateien vollständig neu erzeugen zu lassen.

Beachten Sie, dass dies normalerweise nicht erforderlich ist, da die OPF-Dateien bei jeder Änderung der Metadaten automatisch gesichert werden.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

CLONE¶

calibredb dupliziere Pfad/zur/neuen/Bibliothek

Erstellt eine Kopie der aktuellen Bibliothek. Dies erstellt eine neue, leere Bibliothek mit allen eigenen Spalten, virtulellen Bibliothelen und anderen Einstellungen der aktuellen Bibliothek.

Die geklonte Bibliothek enthält keine Bücher. Wenn Sie eine Kopie mit allen Büchern erstellen möchten, nutzen Sie einfach die Werkzeuge Ihres Dateisystems, um den Bibliotheksordner zu kopieren.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

EMBED_METADATA¶

calibredb embed_metadata [Optionen] Buch_ID

Aktualisieren der in den eigentlichen Buchdateien enthaltenen Metadaten auf Basis der in der Calibre-Bibliothek gespeicherten. Die Metadaten werden normalerweise nur aktualisiert, wenn Dateien aus Calibre exportiert werden. Dieser Befehl ist hilfreich, wenn Dateien an Ort und Stelle aktualisiert werden sollen. Beachten Sie, dass unterschiedliche Formate unterschiedliche Metadaten unterstützen. Sie können den besonderen Wert "all" als Buch_ID verwenden, um die Metadaten aller Bücher zu aktualisieren. Mehrere Bücher können ebenfalls mittels Leerzeichen voneinander getrennter Buch-IDs und mittels Bindestrichen voneinander getrennter ID-Bereiche angegeben werden. Beispiel: calibredb embed_metadata 1 2 10-15 23

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

SEARCH¶

calibredb search [Optionen] Suchausdruck

Durchsucht die Bibliothek nach dem angegebenen Suchbegriff und gibt eine durch Kommas getrennte Liste der Buch-IDs zurück, die dem Suchausdruck entsprechen. Dieses Ausgabeformat eignet sich zur Übergabe an andere Befehle, die eine Liste von IDs als Eingabe akzeptieren.

Der Suchausdruck kann die leistungsfähige Suchabfragesprache von calibre verwenden. Beispiel: calibredb search author:asimov 'title:"i robot"'

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

FTS_INDEX¶

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

Steuert die Volltextsuchindizierung.

reindex Ermöglicht die erneute Indizierung einzelner Bücher oder der gesamten Bibliothek. Um einzelne Bücher neu zu indizieren, geben Sie deren Buch-IDs als zusätzliche Argumente nach dem Befehl reindex an. Werden keine Buch-IDs angegeben, wird die gesamte Bibliothek neu indiziert.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

FTS_SEARCH¶

calibredb fts_search [Optionen] Suchausdruck

Führt eine Volltextsuche in der gesamten Bibliothek oder in einem Teil davon durch.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

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

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

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

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

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

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

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

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

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

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

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.

Wann immer Sie Argumente mit Leerzeichen an calibredb weitergeben, müssen diese Argumente in Anführungsstriche gesetzt werden. Zum Beispiel: "/some path/with spaces"

Author¶

Kovid Goyal

Copyright¶

Kovid Goyal