NAME¶

calibredb - calibredb

calibredb príkaz [možnosti] [parametre]

calibredb je rozhranie príkazového riadka pre databázu calibre. Má niekoľko podpríkazov, ktoré sú zdokumentované nižšie.

calibredb sa dá použiť na úpravu buď databázy calibre zadanej cestou, alebo server obsahu calibre spusteného buď na lokálnom počítači, alebo cez internet. Server Server obsahu calibre môžete spustiť pomocou programu calibre-server, alebo v hlavnom programe calibre kliknutím na Pripojiť/zdieľať  →  Spustiť server obsahu. Keďže calibredb môže vykonávať zmeny vo vašich knižniciach calibre, musíte najprv nastaviť overovanie na serveri. Existujú dva spôsoby, ako to urobiť:

Ak sa chcete pripojiť k bežiacemu serveru obsahu, zadajte URL adresu servera do voľby --with-library. Podrobnosti a príklady nájdete v dokumentácii k tejto voľbe.

GLOBÁLNE VOĹBY¶

LIST¶

calibredb list [možnosti]

Vypíše zoznam kníh, ktoré sa nachádzajú v databáze calibre.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

ADD¶

calibredb add [options] súbor1 súbor2 súbor3 ...

Pridá uvedené súbory ako knihy do databázy. Môžete zadať aj priečinky, pozrite si možnosti týkajúce sa priečinkov nižšie.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

REMOVE¶

calibredb remove id

Odstráni z databázy knihy identifikované pomocou id. id by mal byť zoznam čísel id oddelených čiarkami (čísla id môžete získať pomocou príkazu search). Napríklad 23,34,57-85 (pri zadávaní rozsahu sa posledné číslo v rozsahu nezahŕňa).

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

ADD_FORMAT¶

calibredb add_format [options] id ebook_file

Pridať e-knihu v ebook_file k dostupným formátom pre logickú knihu identifikovanú pomocou id. Id môžete získať pomocou príkazu search. Ak formát už existuje, bude nahradený, pokiaľ nie je zadaná voľba nenahradzovať.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

REMOVE_FORMAT¶

calibredb remove_format [voľby] id formát

Odstráni formát formát z logickej knihy identifikovanej pomocou id. Id môžete získať pomocou príkazu search. formát by mala byť prípona súboru ako LRF, TXT alebo EPUB. Ak logická kniha formát nemá k dispozícii, neurobí sa nič.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

SHOW_METADATA¶

calibredb show_metadata [voľby] id

Zobraziť metadáta uložené v databáze calibre pre knihu identifikovanú pomocou id. id je číslo id z príkazu search.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

SET_METADATA¶

calibredb set_metadata [voľby] id_knihy [/cesta/k/metadata.opf]

Nastaví metadáta uložené v databáze calibre pre knihu identifikovanú pomocou id_knihy zo súboru OPF metadata.opf. id_knihy je číslo id knihy z príkazu search. Rýchly prehľad formátu OPF získate pomocou prepínača --as-opf pri príkaze show_metadata. Metadáta jednotlivých polí môžete nastaviť aj pomocou voľby --field. Ak použijete voľbu --field, nie je potrebné zadávať súbor OPF.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

EXPORT¶

calibredb export [voľby] id

Exportuje knihy zadané pomocou id (zoznam oddelený čiarkami) do súborového systému. Operácia exportu uloží všetky formáty knihy, jej obálku a metadáta (v súbore OPF). Uložia sa aj všetky ďalšie dátové súbory priradené ku knihe. Čísla id môžete získať pomocou príkazu search.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

CATALOG¶

calibredb catalog /cesta/k/cieľu.(csv|epub|mobi|xml...) [voľby]

Exportuje katalóg vo formáte podľa prípony súboru cesta/k/cieľu. Voľby ovládajú, ako sa položky zobrazia vo výslednom katalógu. Upozorňujeme, že rôzne formáty katalógu podporujú rôzne súbory volieb. Ak chcete vidieť rôzne voľby, zadajte názov výstupného súboru a potom voľbu --help.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/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

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

ADD_CUSTOM_COLUMN¶

calibredb add_custom_column [voľby] označenie názov typdát

Vytvorí vlastný stĺpec. označenie je názov stĺpca pre počítač. Nesmie obsahovať medzery a dvojbodky. názov je názov stĺpca pre ľudí. typdát je jedno z: bool, comments, composite, datetime, enumeration, float, int, rating, series, text

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

CUSTOM_COLUMNS¶

calibredb custom_columns [voľby]

Zoznam dostupných vlastných stĺpcov. Zobrazí popisy a id stĺpcov.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

REMOVE_CUSTOM_COLUMN¶

calibredb remove_custom_column [voľby] popis

Odstrániť vlastný stĺpec identifikovaný popisom. Dostupné stĺpce môžete zobraziť príkazom custom_columns.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

SET_CUSTOM¶

calibredb set_custom [voľby] stĺpec id hodnota

Nastaví hodnotu vlastného stĺpca pre knihu identifikovanú pomocou id. Zoznam id môžete získať pomocou príkazu search. Zoznam názvov vlastných stĺpcov môžete získať pomocou príkazu custom_columns.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/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.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

CHECK_LIBRARY¶

calibredb check_library [voľby]

Vykoná nejaké kontroly v súborovom systéme knižnice. Reporty sú invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, malformed_formats, malformed_paths, failed_folders

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

LIST_CATEGORIES¶

calibredb list_categories [voľby]

Vytvoriť správu o informáciách kategórií v databáze. Táto informácia zodpovedá tomu, čo sa zobrazuje v prehliadači značiek.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

BACKUP_METADATA¶

calibredb backup_metadata [voľby]

Záloha metadát uložených v databáze do jednotlivých súborov OPF v každom priečinku kníh. Toto sa bežne deje automaticky, ale tento príkaz môžete spustiť a vynútiť tak nové vygenerovanie súborov OPF pomocou voľby --all.

Upozorňujeme, že bežne to nie je potrebné robiť, keďže súbory OPF sa zálohujú automaticky pri každej zmene metadát.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

CLONE¶

calibredb clone cesta/k/novej/knižnici

Vytvorí klon aktuálnej knižnice. Vytvorí novú, prázdnu knižnicu, ktorá má všetky rovnaké vlastné stĺpce, virtuálne knižnice a ostatné nastavenia ako aktuálna knižnica.

Klonovaná knižnica nebude obsahovať žiadne knihy. Ak chcete vytvoriť úplný duplikát vrátane všetkých kníh, jednoducho použite nástroje súborového systému na skopírovanie priečinka knižnice.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

EMBED_METADATA¶

calibredb embed_metadata [voľby] id_knihy

Aktualizuje metadáta v skutočných súboroch knihy uložených v knižnici calibre podľa metadát v databáze calibre. Metadáta sa bežne aktualizujú iba pri exportovaní súborov z calibre, tento príkaz je užitočný, ak chcete, aby sa súbory aktualizovali na mieste. Upozorňujeme, že rôzne formáty súborov podporujú rôzne množstvo metadát. Pre id_knihy môžete použiť špeciálnu hodnotu „all“ na aktualizáciu metadát vo všetkých knihách. Môžete tiež zadať viacero id kníh oddelených medzerami a rozsahy id oddelené pomlčkami. Napríklad: calibredb embed_metadata 1 2 10-15 23

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

SEARCH¶

calibredb search [voľby] výraz vyhľadávania

Vyhľadá v knižnici zadaný výraz vyhľadávania a vráti zoznam id kníh zodpovedajúcich výrazu vyhľadávania oddelený čiarkami. Výstupný formát je užitočný na vloženie do iných príkazov, ktoré prijímajú ako vstup zoznam id.

Výraz vyhľadávania môže byť čokoľvek z výkonného jazyka vyhľadávacích dopytov calibre, napríklad: calibredb search author:asimov 'title:"i robot"'

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

FTS_INDEX¶

calibredb fts_index [voľby] enable/disable/status/reindex

Ovláda proces indexovania Fulltextového vyhľadávania.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

FTS_SEARCH¶

calibredb fts_search [voľby] vyhľadávací výraz

Vykonať vyhľadávanie v celom texte celej knižnice alebo jej podmnožiny.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/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

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/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 ...]

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/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 ...

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/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 ...

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/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

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/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.

Vždy, keď odovzdávate calibredb argumenty obsahujúce medzery, uzavrite ich do úvodzoviek. Napríklad: "/some path/with spaces"

Author¶

Kovid Goyal

Copyright¶

Kovid Goyal