NAME¶

calibredb - calibredb

calibredb command [options] [arguments]

calibredb je rozhraní příkazového řádku k databázi calibre. Má několik dílčích příkazů, které jsou zdokumentovány níže.

calibredb lze použít k manipulaci buď s databází calibre určenou cestou, nebo se serverem calibre Server s obsahem, který běží buď na místním počítači, nebo přes internet. Server s obsahem calibre můžete spustit buď pomocí programu calibre-server, nebo v hlavním programu calibre kliknutím na Připojit nebo sdílet  →  Spustit Server s obsahem. Protože calibredb může provádět změny ve vašich knihovnách calibre, musíte na serveru nejprve nastavit ověřování. Lze to udělat dvěma způsoby:

Chcete-li se připojit ke spuštěnému Serveru s obsahem, předejte URL serveru volbě --with-library; podrobnosti a příklady najdete v dokumentaci k této volbě.

GLOBÁLNÍ VOLBY¶

LIST¶

calibredb list [options]

Vypsat knihy dostupné v databázi Calibre.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

ADD¶

calibredb add [options] file1 file2 file3...

Přidat zadané soubory jako knihy do databáze. Můžete také zadat složky, podívejte se na volby související s následující složkou.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

REMOVE¶

calibredb remove ids

Odebrat knihy identifikované identifikátory z databáze. Identifikátory by měly být čárkami oddělený seznam identifikačních čísel (identifikační čísla můžete získat pomocí příkazu search). Například 23,34,57-85 (když zadáváte rozsah, poslední číslo rozsahu není zahrnuto).

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

ADD_FORMAT¶

calibredb add_format [options] id ebook_file

Přidat e-knihu v ebook_file do dostupných formátů pro logickou knihu identifikovanou identifikátorem. Identifikátor můžete získat pomocí příkazu search. Pokud formát již existuje, je nahrazen, pokud není zadána volba nenahrazovat.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

REMOVE_FORMAT¶

calibredb remove_format [options] id fmt

Odebrat formát fmt z logické knihy identifikované identifikátorem. Identifikátor můžete získat pomocí příkazu search. fmt by měla být přípona souboru, jako je LRF, TXT nebo EPUB. Pokud logická kniha nemá dostupné fmt, nedělat nic.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

SHOW_METADATA¶

calibredb show_metadata [options] id

Zobrazit metadata uložená v databázi Calibre pro knihu identifikovanou identifikátorem. Identifikátor je identifikační číslo z příkazu search.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

SET_METADATA¶

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

Nastavit metadata uložená v databázi Calibre pro knihu identifikovanou pomocí book_id ze souboru OPF metadata.opf. book_id je identifikační číslo knihy z příkazu search. Můžete získat rychlé chování pro formát OPF pomocí přepínače --as-opf příkazu show_metadata. Můžete také nastavit metadata jednotlivých polí pomocí volby --field. Pokud použijete volbu --field, není potřeba zadávat soubor OPF.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

EXPORT¶

calibredb export [options] ids

Exportovat knihy zadané identifikátory (čárkami oddělený seznam) do systému souborů. Operace exportu ukládá všechny formáty knihy, její obálku a metadata (v souboru OPF). Jakákoliv dodatečná data přidružená ke knize jsou také uložena Identifikační čísla můžete získat z příkazu search.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

CATALOG¶

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

Exportovat katalog ve formátu zadaném rozšířením path/to/destination. Volby určují, jak jsou položky v generovaném výstupním katalogu zobrazeny. Pamatujte, že různé formáty katalogu podporují různé sady voleb. Pro zobrazení různých voleb zadejte název výstupního soubor a pak volbu --help.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

SAVED_SEARCHES¶

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

Spravuje uložená hledání v této databázi. Pokud se pokusíte přidat dotaz s názvem, který již existuje, bude nahrazen.

Syntaxe pro výpis (výchozí akce):

calibredb saved_searches list

Syntaxe pro přidání:

calibredb saved_searches add search_name search_expression

Syntaxe pro odebrání:

calibredb saved_searches remove search_name

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

ADD_CUSTOM_COLUMN¶

calibredb add_custom_column [options] label name datatype

Vytvořit vlastní sloupec. label je název sloupce vhodný pro stroje. Neměl by obsahovat mezery nebo dvojtečky. name je název sloupce vhodný pro lidi. datatype je jeden z: bool, comments, composite, datetime, enumeration, float, int, rating, series, text

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

CUSTOM_COLUMNS¶

calibredb custom_columns [options]

Vypsat dostupné vlastní sloupce. Zobrazí popisky sloupců a identifikátory.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

REMOVE_CUSTOM_COLUMN¶

calibredb remove_custom_column [options] label

Odebrat vlastní sloupec identifikovaný popiskem. Dostupné sloupce můžete zobrazit příkazem custom_columns.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

SET_CUSTOM¶

calibredb set_custom [options] column id value

Nastavit hodnotu vlastního sloupce pro knihu identifikovanou identifikátorem. Seznam identifikátorů můžete získat pomocí příkazu search. Seznam názvů vlastních sloupců můžete získat pomocí příkazu custom_columns.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

RESTORE_DATABASE¶

calibredb restore_database [options]

Obnoví tuto databázi z metadat uložených v souborech OPF v jednotlivých složkách knihovny calibre. To je užitečné, pokud byl váš soubor metadata.db poškozen.

VAROVÁNÍ: Tento příkaz zcela znovu vytvoří vaši databázi. Ztratíte všechna uložená hledání, uživatelské kategorie, zásuvné panely, uložená nastavení převodu pro jednotlivé knihy a vlastní předpisy. Obnovená metadata budou pouze tak přesná jako údaje nalezené v souborech OPF.

Návratový kód je 0, pokud obnova proběhla úspěšně, 1, pokud zcela selhala, a 2, pokud byla databáze obnovena, ale některé knihy nebo jiná data se obnovit nepodařilo.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

CHECK_LIBRARY¶

calibredb check_library [options]

Provést některé kontroly souborového systému představujícího knihovnu. Hlášení jsou invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, malformed_formats, malformed_paths, failed_folders

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

LIST_CATEGORIES¶

calibredb list_categories [options]

Vytvořit hlášení informací o kategoriích v databázi. Informace je ekvivalentem toho, co je zobrazeno v Prohlížeči štítků.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

BACKUP_METADATA¶

calibredb backup_metadata [options]

Zálohovat metadata uložená v databázi do jednotlivých souborů OPF v každé složce knih. Toto se normálně děje automaticky, ale můžete tento příkaz spustit s volbou --all, abyste vynutili opětovné vygenerování souborů OPF.

Pamatujte, že normálně není vůbec potřeba toto dělat, protože soubory OPF jsou zálohovány automaticky pokaždé, když se změní metadata.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

CLONE¶

calibredb clone path/to/new/library

Vytvořit klon aktuální knihovny. Toto vytvoří novou, prázdnou knihovnu, která má stejné vlastní sloupce, Virtuální knihovny a jiná nastavení jako aktuální knihovna.

Klonovaná knihovna nebude obsahovat žádné knihy. Pokud chcete vytvořit úplný duplikát včetně všech knih, pak jednoduše použijte nástroje vašeho systému souborů ke zkopírování složky knihovny.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

EMBED_METADATA¶

calibredb embed_metadata [options] book_id

Aktualizovat metadata ve skutečných souborech knih uložená v knihovně Calibre z metadat v databázi Calibre. Normálně jsou metadata aktualizována pouze při exportování souborů z Calibre, tento příkaz je užitečný, pokud chcete, aby byla metadata aktualizována na místě. Pamatujte, že různé formáty souborů podporují různá množství metadat. K aktualizaci metadat ve všech knihách můžete pro book_id použít speciální hodnotu 'all'. Můžete také zadat mnoho identifikátorů knih oddělených mezerami a rozsahů identifikátorů oddělených spojovníky. Například: calibredb embed_metadata 1 2 10-15 23

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

SEARCH¶

calibredb search [options] search expression

Vyhledat v knihovně zadaný hledaný výraz vracející čárkami oddělený seznam identifikátorů knih odpovídající hledanému výrazu. Výstupní formát je užitečný pro zásobení jiných příkazů, které přijímají seznam identifikátorů jako vstup.

Hledaný výraz může být cokoliv z výkonného jazyka vyhledávacích dotazů Calibre, například: calibredb search author:asimov 'title:"i robot"'

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

FTS_INDEX¶

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

Řídí proces indexování pro fulltextové vyhledávání.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

FTS_SEARCH¶

calibredb fts_search [volby] vyhledávací výraz

Provede fulltextové vyhledávání v celé knihovně nebo její podmnožině.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

NOTES¶

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

Spravuje poznámky připojené k položkám, jako jsou autoři, série, štítky a vydavatelé. FIELD je název vyhledávání pole, například authors, series, tags, publisher nebo #mycolumn. ITEM je název položky, například jméno autora. Při hledání položek se nerozlišují velká a malá písmena.

Vypíše položky, které mají poznámky, případně pouze položky v zadaném poli. Toto je výchozí akce:

calibredb notes list [FIELD]

Prohledá text poznámek pomocí stejné syntaxe fulltextového vyhledávání SQLite jako nástroj Procházet poznámky v calibre. Pro každou shodu vypíše pole, název položky a úryvek. Volbou --field omezíte hledání pouze na poznámky v určitém poli:

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

Vypíše poznámku k položce jako text ve formátu Markdown, nebo s přepínačem --as-html jako dokument HTML s vloženými obrázky, vhodný pro použití s akcí set:

calibredb notes show FIELD ITEM

Nahradí poznámku k položce obsahem souboru HTML. Pro načtení HTML ze standardního vstupu použijte -. Obrázky vložené pomocí adres URL se schématem data: a kódováním base64 se do poznámky přidají jak u místních, tak u vzdálených knihoven. Při použití místní knihovny a načítání ze souboru se přidají také obrázky odkazované cestami relativními k tomuto souboru:

calibredb notes set FIELD ITEM FILE

Odstraní poznámku k položce:

calibredb notes remove FIELD ITEM

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

ITEMS¶

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

Přejmenuje nebo odstraní položky, jako jsou autoři, štítky, série a vydavatelé, ve všech knihách, stejně jako akce Spravovat autory, štítky atd. v rozhraní calibre. FIELD je název vyhledávání pole, například authors, tags, series, publisher nebo #mycolumn. Při hledání položek se nerozlišují velká a malá písmena.

Přejmenuje položku. Pokud již existuje položka s názvem NEW_NAME, obě položky se sloučí. U polí s více hodnotami může NEW_NAME obsahovat více hodnot oddělených oddělovačem daného pole, například čárkou u štítků. Položka se pak nahradí všemi těmito hodnotami:

calibredb items rename FIELD ITEM NEW_NAME

Odstraní jednu nebo více položek ze všech knih. Autory nelze odstranit:

calibredb items remove FIELD ITEM [ITEM ...]

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

VIRTUAL_LIBRARIES¶

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

Spravuje virtuální knihovny této knihovny. Virtuální knihovna je hledání, při kterém se knihovna chová, jako by obsahovala pouze knihy, které mu odpovídají. Pro výpis nebo vyhledání knih ve virtuální knihovně použijte: calibredb search 'vl:"name"'

Vypíše virtuální knihovny včetně jejich hledání a počtu knih. Toto je výchozí akce:

calibredb virtual_libraries list

Vytvoří virtuální knihovnu z hledání:

calibredb virtual_libraries add name search_expression

Přejmenuje virtuální knihovnu:

calibredb virtual_libraries rename name new_name

Odebere virtuální knihovny; knihy v nich se nezmění:

calibredb virtual_libraries remove name ...

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

ANNOTATIONS¶

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

Spravuje anotace knih, tedy zvýraznění a záložky vytvořené v Prohlížeči e-knih calibre nebo synchronizované z jiných aplikací.

Vypíše anotace včetně jejich ID. Toto je výchozí akce:

calibredb annotations list

Prohledá zvýrazněný text, poznámky k anotacím a názvy záložek pomocí stejné syntaxe fulltextového vyhledávání SQLite jako nástroj Procházet anotace. Výsledky jsou seřazeny podle relevance a zahrnují ID anotací, názvy knih a odpovídající úryvky. Volbou --search omezíte knihy, volbou --type typ anotace, volbami --user-type a --annotation-user uživatele a volbou --no-stemming vyhledáte přesné slovní tvary. Volbou --format json získáte pole JSON s výsledky včetně dat anotací a úryvků:

calibredb annotations search "search expression"

Exportuje anotace jako prostý text, Markdown nebo JSON, seskupené podle knih. JSON má stejnou podobu kolekce anotací calibre jako při exportu tlačítkem Exportovat v nástroji Procházet anotace:

calibredb annotations export

Importuje kolekci anotací calibre exportovanou jako JSON tímto příkazem nebo nástrojem Procházet anotace. Kolekce musí obsahovat anotace pouze z jedné knihy. BOOK_ID je ID cílové knihy, nikoli ID uložené v souboru. Importují se pouze anotace formátu FORMAT, anotace ostatních formátů se přeskočí. Formát FORMAT musí být v cílové knize k dispozici. Aby pozice odpovídaly, použijte stejné vydání knihy:

calibredb annotations import BOOK_ID FORMAT FILE

Pro načtení ze standardního vstupu použijte místo FILE znak -. Před importem se ověří celá kolekce. Anotace se sloučí se stávajícími podle pravidel prohlížeče: zvýraznění se přiřazují podle UUID a záložky podle názvu, přičemž přednost má novější časové razítko. Opakované importy nevytvářejí duplicity. Nesouvisející anotace a pozice čtení zůstávají zachovány.

Ve výchozím nastavení se anotace importují mezi anotace Prohlížeče e-knih calibre. Chcete-li je místo toho importovat mezi anotace uživatele Serveru s obsahem, použijte --user-type web --annotation-user USER. Exportované kolekce zaznamenávají uživatele, kterému anotace patří, a pokud kolekce obsahuje anotace více než jednoho uživatele, je odmítnuta. Při exportu použijte volby --user-type a --annotation-user, abyste exportovali anotace jediného uživatele.

Trvale odebere anotace se zadanými ID zobrazenými příkazem list:

calibredb annotations remove ID ...

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

TRASH¶

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

Spravuje knihy a formáty, které byly odebrány a přesunuty do koše. Položky v koši se po několika dnech automaticky trvale odstraní. ids je čárkami oddělený seznam ID knih stejně jako u příkazu remove, například: 23,34,57-85 (při zadání rozsahu se poslední číslo rozsahu nezahrnuje).

Vypíše odebrané knihy a formáty, nejnověji odebrané jako první, včetně času odebrání v místním čase. Odebrané formáty knih, které už neexistují, jsou označeny jako neobnovitelné a lze je pouze odstranit. S volbou --for-machine jsou časy v UTC:

calibredb trash list

Obnoví odebrané knihy, nebo s volbou --formats odebrané formáty knih:

calibredb trash restore ids

Trvale odstraní položky z koše:

calibredb trash delete ids

Trvale odstraní vše z koše:

calibredb trash empty

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

DATA_FILES¶

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

Spravuje dodatečné datové soubory přidružené ke knize v místních nebo vzdálených knihovnách. Názvy jsou relativní k datové složce knihy. Pro podsložky používejte /, přijímá se také . Soubory, jejichž názvy obsahují , se vypisují, ale jinak je nelze spravovat. Tímto příkazem nelze přistupovat k formátům e-knih, obálkám ani souboru metadata.opf. Vzdálené knihovny vyžadují účet s oprávněním k zápisu, stejně jako ostatní příkazy pro správu, a nepodporují účty s omezením hledání pro jednotlivé knihovny.

Vypíše názvy souborů, velikosti v bajtech a časy změny (v sekundách od unixové epochy). Pro výstup JSON použijte --for-machine:

calibredb data_files list BOOK_ID

Přidá soubor pod jeho samotným názvem bez cesty; volbou --name lze zadat název nebo podsložku. Stávající soubory se nenahrazují, pokud není zadána volba --replace. Tato možnost je dostupná také prostřednictvím add_format --as-extra-data-file:

calibredb data_files add BOOK_ID FILE

Uloží jeden datový soubor do cíle určeného volbou --output na místním počítači. Stávající výstupní soubory se nenahrazují, pokud není zadána volba --replace:

calibredb data_files get BOOK_ID NAME --output FILE

Přejmenuje soubor. Stávající cíle se nenahrazují, pokud není nastavena volba --replace:

calibredb data_files rename BOOK_ID NAME NEW_NAME

Přesune soubor do koše operačního systému. S volbou --permanent jej místo toho trvale odstraní. U vzdálených knihoven se tato operace provádí na serveru:

calibredb data_files remove BOOK_ID NAME

Složky, které po akcích rename a remove zůstanou prázdné, se odstraní. U vzdálených knihoven se každý soubor přenáší v jediném požadavku, takže velmi velké soubory vyžadují dostatek paměti na klientovi i na serveru a velikost odesílaných souborů je omezena maximální velikostí požadavku serveru.

Kdykoliv předáváte parametry pro calibredb, který mají mezery, uzavřete parametry uvozovkami. Například: „/some path/with spaces

Author¶

Kovid Goyal

Copyright¶

Kovid Goyal