table of contents
- NAME
- GLOBÁLIS BEÁLLÍTÁSOK
- LIST
- ADD
- REMOVE
- ADD_FORMAT
- REMOVE_FORMAT
- SHOW_METADATA
- SET_METADATA
- EXPORT
- CATALOG
- 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
- Author
- Copyright
- trixie 8.5.0+ds-1+deb13u3
- trixie-backports 8.16.2+ds+~0.10.5-3~bpo13+1
- testing 9.18.0+ds+~1.1.2-1
- unstable 9.18.0+ds+~1.1.2-1
- العربية
- български
- català (ca)
- čeština
- dansk
- Deutsch
- Ελληνικά
- English
- español
- eesti
- euskara
- فارسی
- suomi
- français
- galego
- עברית
- hrvatski
- magyar
- íslenska
- italiano
- 日本語
- ಕನ್ನಡ
- 한국어
- lietuvių
- latviešu
- मराठी
- Melayu
- norsk bokmål
- Nederlands
- polski
- português (pt)
- português (pt-BR)
- română
- русский
- slovenčina
- slovenščina
- српски
- srpskohrvatski
- svenska
- Türkçe
- українська
- Tiếng Việt
- 中文 (zh-CN)
- 繁體中文 (zh-HK)
- 繁體中文 (zh-TW)
| CALIBREDB(1) | calibre | CALIBREDB(1) |
NAME¶
calibredb - calibredb
calibredb parancs [kapcsolók] [argumentumok]
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.
- GLOBÁLIS BEÁLLÍTÁSOK
- list
- add
- •
- HOZZÁADÁS MAPPÁKBÓL
- remove
- add_format
- remove_format
- show_metadata
- set_metadata
- export
- catalog
- •
- EPUB BEÁLLÍTÁSOK
- 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
GLOBÁLIS BEÁLLÍTÁSOK¶
- --help, -h
- súgó megjelenítése és kilépés
- --library-path, --with-library
- 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>.
- --password
- Jelszó a Calibre tartalomkiszolgálóhoz való csatlakozáshoz. A jelszó normál bemenetről történő olvasásához használja a speciális értéket: <stdin>. A jelszó fájlból való olvasásához használja: <f:/path/to/file> (azaz <f: followed by the full path to the file and a trailing >). A fenti szögletes zárójelek kötelezőek, ne felejtse el kihagyni őket, vagy használjon idézőjeleket a "shell"-hez.
- --timeout
- Időtúllépés másodpercben, amikor a hálózaton keresztül csatlakozik egy Calibre könyvtárhoz. Az alapértelmezett érték két perc.
- --username
- Felhasználónév a Calibre Tartalomkiszolgálóhoz történő kapcsolódáshoz
- --version
- program verziójának megjelenítése és kilépés
LIST¶
calibredb list [options]
A Calibre adatbázisában lévő könyvek :command:
`
list`ája.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --ascending
- Rendezési emelkedő sorrendben
- --fields, -f
- A könyvek adatbázisban való listázásakor megjelenítendő mezők. A mezők vesszővel elválasztott listája legyen. Elérhető mezők: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Alapértelmezett: title,authors. Az "Mind” speciális mezővel az összes mezőt kijelölhetjük. A fenti beépített mezőkön kívül egyéni mezők '*field_name' néven is elérhetők, például egyéni mezőhöz #rating használja a következő nevet: *értékelés
- --for-machine
- Kimenet generálása JSON formátumban, amely alkalmasabb a gépi elemzésre. A vonalszélesség és az elválasztó beállítások figyelmen kívül hagyását okozza.
- --limit
- A megjeleníthető eredmények maximális száma. Alapértelmezett: mind (all)
- --line-width, -w
- Egy sor maximális szélessége a kimenetben. A képernyőmérethez szükséges.
- --prefix
- Minden elérési útvonal előtagja. Alapértelmezettként az adatbázis mappájának elérési útja.
- --search, -s
- Keresési eredmény szűrése. A keresési feltétel megadásához tanulmányozza meg a Felhasználói Kézikönyv ide vonatkozó részét. Alapértelmezésként nincs szűrés.
- --separator
- A mezők elválasztására szolgáló karakter vagy szöveg. Alapbeállítás a szóköz.
- --sort-by
- 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
- --template
- A futtatandó sablon, ha "template" szerepel a mezőlistában. Vegye figyelembe, hogy a sablonokat a rendszer figyelmen kívül hagyja a calibre kiszolgálóhoz való csatlakozáskor. Alapértelmezés: None
- --template_file, -t
- A futtatandó sablont tartalmazó fájl elérési útja, ha "template" szerepel a mezőlistában. Alapértelmezés: nincs
- --template_heading
- Modell oszlopfejléc. Alapértelmezett érték: template. Ezt a beállítást a rendszer figyelmen kívül hagyja, ha a --for-machine opció be van állítva.
ADD¶
calibredb add [opciók] fájl1 fájl2 fájl3 ...
Adja hozzá a megadott fájlokat könyvként az adatbázishoz. Megadhat mappákat is, lásd alább a mappákkal kapcsolatos beállításokat.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- A hozzáadott könyv(ek) szerzőjének megadása
- --automerge, -m
- Ha hasonló címmel és szerzővel rendelkező könyveket talál, a bejövő formátumokat (fájlokat) automatikusan egyesíti a meglévő könyvrekordokba. Az "ignore - kihagyás" érték azt jelenti, hogy a duplikált formátumokat a rendszer elveti. Az "overwrite - felülírás" érték azt jelenti, hogy a könyvtárban található duplikált formátumok felülíródnak az újonnan hozzáadott fájlokkal. A "new_record - új_rekord" értéke azt jelenti, hogy a duplikált formátumok egy új könyvrekordba kerülnek.
- --cover, -c
- Hozzáadott címkép helye
- --duplicates, -d
- Könyvek hozzáadása az adatbázishoz akkor is, ha már léteznek. Az összehasonlítás a könyvcímek és szerzők alapján történik. Vegye figyelembe, hogy --automerge opció élvez elsőbbséget.
- --empty, -e
- Üres könyv hozzáadása (könyv formátumok nélkül)
- --identifier, -I
- Állítsa be a könyv azonosítóit, pl. -I asin:XXX -I isbn:YYY
- --isbn, -i
- A hozzáadott könyv(ek) ISBN-azonosítójának megadása
- --languages, -l
- A nyelvek vesszővel elválasztott listája (legjobb az ISO639 nyelvi kódok használatához, bár egyes nyelveket is fel lehet ismerni)
- --series, -s
- A hozzáadott könyv(ek) sorozatának megadása
- --series-index, -S
- A hozzáadott könyv(ek) sorozatszámának megadása
- A hozzáadott könyv(ek) címkéinek megadása
- --title, -t
- A hozzáadott könyv(ek) címének megadása
HOZZÁADÁS MAPPÁKBÓL¶
Lehetőségek a könyvek mappákból történő hozzáadásának szabályozására. Alapértelmezés szerint csak azok a fájlok kerülnek hozzáadásra, amelyek kiterjesztése ismert e-könyv fájltípusokra vonatkozik.
- --add
- Fájlnév (glob) minta, ennek a mintának megfelelő fájlok hozzáadódnak a mappák fájlok keresésekor, még akkor is, ha azok nem ismert e-könyv fájltípusúak. Több mintához többször is megadható.
- --ignore
- A fájlnév (glob) minta, az ennek a mintának megfelelő fájlok figyelmen kívül maradnak a mappák fájlok keresésekor. Több mintához többször is megadható. Például: *.pdf figyelmen kívül hagy minden PDF fájlt
- --one-book-per-directory, -1
- Tételezzük fel, hogy minden mappában csak egyetlen logikai könyv található, és a benne lévő összes fájl az adott könyv különböző e-könyv-formátumai
- --recurse, -r
- Mappák rekurzív feldolgozása
REMOVE¶
calibredb remove ids
eltávolítja az azonosítókkal azonosított könyveket az adatbázisból. Az id-k az azonosítószámok vesszővel elválasztott listája kell lennie (az azonosítószámokat a keresés paranccsal kaphatja meg). Például 23,34,57-85 (tartomány megadásakor a tartomány utolsó száma nem szerepel).
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --permanent
- Do not use the trash bin
ADD_FORMAT¶
calibredb add_format [options] id ebook_file
Hozzáadja az ebook_file fájlban található e-könyvet az id által azonosított logikai könyv elérhető formátumaihoz. Az azonosítót a keresés paranccsal kaphatja meg. Ha a formátum már létezik, akkor a rendszer lecseréli, hacsak nincs megadva a nincs csere beállítás.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --as-extra-data-file
- Adja hozzá a fájlt kiegészítő adatfájlként a könyvhöz, ne e-könyv formátumként
- --dont-replace
- Ne cserélje ki a formátumot, ha már létezik
REMOVE_FORMAT¶
calibredb remove_format [options] id fmt
Eltávolítja el az fmt formátumot az id által azonosított logikai könyvből. Az azonosítót a keresés paranccsal kaphatja meg. Az fmt egy fájlkiterjesztés, például LRF vagy TXT vagy EPUB. Ha a logikai könyvben nem elérhető az fmt, ne tegyen semmit.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
SHOW_METADATA¶
calibredb show_metadata [options] id
Megjeleníti az id által azonosított könyv Calibre adatbázisában tárolt metaadatokat. Az id a keresési parancsból származó azonosítószám.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --as-opf
- Metaadatok nyomtatása OPF(XML) formátumban
SET_METADATA¶
calibredb set_metadata [options] book_id [/path/to/metadata.opf]
Elhelyezi az OPF metadata.opf fájlból a book_id által azonosított könyv Calibre adatbázisában tárolt metaadatokat. A book_id egy azonosítószám a find parancsból. Gyors áttekintést kaphat az OPF formátumról a show_metadata parancs --as-opf kapcsolójával. Egyedi mező metaadatokat
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --field, -f
- A beállítandó mező. A formátum: field_name:value, például: --field tags:tag1,tag2. --list-fields segítségével lekérheti az összes mezőnév listáját. Ezt a beállítást többször is megadhatja több mező beállításához. Megjegyzés: nyelvek esetén az ISO639 nyelvkódokat kell használnia (pl. en angolhoz, fr franciához stb.). Az azonosítók szintaxisa: --field identifiers:isbn:XXXX,doi:YYYYY. Logikai (igen/nem) mezőkhöz használja az igaz és hamis vagy az igen és nem értéket.
- --list-fields, -l
- A --field paraméterrel használható metaadat-mezőnevek felsorolása
EXPORT¶
calibredb export [opciók] azonosítók
Exportálja az azonosítókkal (vesszővel tagolt lista) megadott könyveket a fájlrendszerbe. Az :command:
`
export`álási művelet elmenti a könyv összes formátumát, borítóját és metaadatait (OPF fájlba). A könyvhöz kapcsolódó további adatfájlok is mentésre kerülnek. Az azonosítószámokat a keresési parancsból kaphatja meg.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --all
- Minden könyv exportálása az adatbázisba. Ne vegye figyelembe az azonosító (ID) listát.
- --dont-asciiize
- A Calibre konvertálja az összes nem angol karaktert a fájlnevek angol megfelelőire. Ez akkor hasznos, ha régi fájlrendszerbe menti, és nem támogatja a Unicode fájlneveket. Ennek megadása kikapcsolja ezt az opciót.
- --dont-save-cover
- Normál esetben a Calibre egy önálló fájlban tárolja a borítót az adott e-könyv egyéb fájljaival mellett. Ennek megadása kikapcsolja ezt az opciót.
- --dont-save-extra-files
- A könyv mentésekor mentse el a könyvhöz kapcsolódó összes adatfájlt Ennek megadása kikapcsolja ezt az opciót.
- --dont-update-metadata
- Alapesetben a Calibre a mentett fájlokban felülírja a metaadatokat az adatbázisban lévőkkel. Ez lassítja a mentési folyamatot. Ennek megadása kikapcsolja ezt az opciót.
- --dont-write-opf
- Alapesetben a Calibre a metaadatokat egy különálló OPF fájlban tárolja a könyv saját mappájában. Ennek megadása kikapcsolja ezt az opciót.
- --formats
- A mentendő formátumok vesszővel tagolt listája. Alapesetben 'all', vagyis minden formátum mentésre kerül.
- --progress
- Folyamatjelentés
- --replace-whitespace
- Szóközök helyettesítése alul-vonással.
- --single-dir
- Minden könyv exportálása külön mappába
- --template
- A mentett fájlok fájlnevének és mappaszerkezetének szabályozására szolgáló sablon. Az alapértelmezett: "{author_sort}/{title}/{title} - {authors}", amely a könyveket egy szerzőnkénti almappába menti, a címet és a szerzőt tartalmazó fájlnevekkel. A következő vezérlők állnak rendelkezésre {author_sort, authors, id, isbn, languages, last_modified, pages, pubdate, publisher, rating, series, series_index, tags, timestamp, title}
- --timefmt
- A megjelenítendő dátum formázása. %d - nap, %b - hónap, %m - hónap száma, %Y - év. Alapértelmezett: %b, %Y
- --to-dir
- Könyvek exportálása egy meghatározott mappába. Alapértelmezett: .
- --to-lowercase
- Elérési út kisbetűssé alakítása.
CATALOG¶
calibredb catalog /path/to/destination.(csv|epub|mobi|xml...) [options]
Katalógus exportálása az elérési út/cél/cél kiterjesztés által megadott formátumban. Az opciók szabályozzák, hogy a bejegyzések hogyan jelenjenek meg a generált katalógus kimenetben. Vegye figyelembe, hogy a különböző
különböző opciók megtekintéséhez adja meg a kimeneti fájl nevét, majd --help opciót.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --ids, -i
- A katalogizálandó, adatbázisból vett ID-k vesszővel tagolt listája. Ha meg van adva, akkor a --search opció nem lesz figyelembe véve. Alapértelmezett: „all” (mind)
- --search, -s
- Az eredmény szűrése keresési lekérdezéssel. A keresési lekérdezés formátumáról bővebben a Felhasználói Kézikönyvben olvashat. Alapértelmezett: nincs szűrés
- --verbose, -v
- Részletes kimeneti információk megjelenítése. Hasznos hibakeresésnél
EPUB BEÁLLÍTÁSOK¶
- --catalog-title
- A metaadatokban címként használt generált katalógus címe. Alapértelmezett: 'My Books' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --cross-reference-authors
- Kereszthivatkozások létrehozása a "Szerzők" részben több szerzőt tartalmazó könyvekhez. Alapértelmezett: 'False' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --debug-pipeline
- Az átalakítási folyamat különböző szakaszaiból származó kimenet mentése a megadott mappába. Hasznos, ha nem biztos abban, hogy az átalakítási folyamat melyik szakaszában történik hiba. Alapértelmezett: 'None' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --exclude-genre
- Műfajként kizárandó címkéket leíró reguláris kifejezés. Alapértelmezett: '[.+]|^+$' nem tartalmazza a zárójeles címkéket, pl. '[Project Gutenberg]', and '+', az olvasott könyvek alapértelmezett címkéje. Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --exclusion-rules
- Meghatározza azokat a szabályokat, amelyek segítségével kizárják a könyveket a létrehozott katalógusból. A kizárási szabály modellje vagy ('<rule name>','Címkék','<comma-separated list of tags>') vagy ('<rule name>','<custom column>','<pattern>'). Például: (('Archivált könyvek','#status','Archivált'),) kizárja az „Archivált” értékű könyvet az "állapot” egyéni oszlopban. Ha több szabályt határoz meg, akkor az összes szabályt alkalmazni fogja. Alapértelmezett: "(('Catalogs','Tags','Catalog'),)" Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --generate-authors
- Tartalmazza a 'Szerzők' részt a katalógusban. Alapértelmezett: 'False' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --generate-descriptions
- Tartalmazza a 'Leírások' részt a katalógusban. Alapértelmezett: 'False' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --generate-genres
- Tartalmazza a "Műfajok” részt a katalógusban. Alapértelmezett: 'False' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --generate-recently-added
- Tartalmazza a 'Legutóbb hozzáadva' részt a katalógusban. Alapértelmezett: 'False' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --generate-series
- Tartalmazza a "Sorozatok” részt a katalógusban. Alapértelmezett: 'False' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --generate-titles
- Tartalmazza a 'Címek' részt a katalógusban. Alapértelmezett: 'False' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --genre-source-field
- A "Műfajok” rész forrásmezője. Alapértelmezett: 'Címke' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --header-note-source-field
- Egyéni mező, amely a "Leírás" fejlécébe beillesztendő megjegyzésszöveget tartalmaz.za. Alapértelmezett: '' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --merge-comments-rule
- #<custom field>:[before|after]:[True|False] meghatározása: <custom field> Egyéni mező, amely kommentekkel egyesítendő megjegyzéseket tartalmaz [előtte|utána] A megjegyzésekhez kapcsolódó megjegyzések elhelyezése [True|False] - A megjegyzések és a kommentek közé vízszintes vonal kerül beillesztésre Alapértelmezett: '::' Alkalmazás: AZW3, EPUB, MOBI kimeneti formátumokhoz
- --output-profile
- A kimeneti profil meghatározása. Egyes esetekben kimeneti profilra van szükség az eszköz katalógusának optimalizálásához. Például a „kindle” vagy a „kindle_dx” strukturált tartalomjegyzéket hoz létre szakaszokkal és cikkekkel. Alapértelmezett: 'None' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --prefix-rules
- Meghatározza azokat a szabályokat, amelyek az olvasott könyveket, kívánságlista elemeket és más, felhasználó által megadott előtagokat jelölik. Az előtag szabály modellje ('<rule name>','<source field>','<pattern>','<prefix>'). Ha több szabályt definiál, az első egyező szabály kerül felhasználásra. Alapértelmezett: "(('Read books','tags','+','✓'),('Wishlist item','tags','Wishlist','×'))" Alkalmazás: AZW3, EPUB, MOBI kimeneti formátumokhoz
- --preset
- Egy, a GUI katalóguskészítővel létrehozott előre beállított készlet használata. Egy előre beállított készlet megadja a katalógus létrehozásához szükséges összes beállítást.. Alapértelmezett: 'None' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --thumb-width
- Méretmutató jüvelykben) a katalógusban szereplő könyvborítókhoz. Tartomány: 1.0 - 2.0 Alapértelmezett: '1.0' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
- --use-existing-cover
- A meglévő borító kicserélése katalógus generálásakor. Alapértelmezett: 'False' Érvényes: AZW3, EPUB, MOBI kimeneti formátumokra
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
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
ADD_CUSTOM_COLUMN¶
calibredb add_custom_column [kapcsolók] oszlop_nev cím adattípus
Saját oszlop készítése. Az „oszlop_nev” az oszlop tárolt neve, angol karaktereket tartalmazzon, de ne legyen benne szóköz és kettőspont. A „cím” az oszlop felhasználóbarát címe. Az „adattípus” lehet: bool, comments, composite, datetime, enumeration, float, int, rating, series, text
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --display
- Az ebben az oszlopban lévő adatok értelmezési módjának testreszabására szolgáló lehetőségek szótára. Ez egy JSON karakterlánc. Felsorolási oszlopokhoz használja a --display"{\ "enum_values\ ":[\ "val1\ ", \ "val2\ "]}" A megjelenítési változóban számos lehetőség szerepelhet. Az oszloptípus szerinti beállítások a következők: összetett: composite_template, composite_sort, make_category,contains_html, use_decorations datetime: date_format felsorolás: enum_values, enum_colors, use_decorations int, float: number_format szöveg: is_names, use_decorations A legális kombinációk megtalálásának legjobb módja, ha létrehoz egy megfelelő típusú egyéni oszlopot a grafikus felhasználói felületen, majd megnézi a könyv biztonsági másolatát (győződjön meg arról, hogy az oszlop hozzáadása óta új OPF jött létre). Látni fogja a JSON-t az új oszlop "megjelenítéséhez” az OPF-ben.
- --is-multiple
- Az oszlop címke-szerű (több elem, vesszővel tagolva) adatokat tárol. Csak szöveg adattípusnál használható.
CUSTOM_COLUMNS¶
calibredb custom_columns [options]
Az elérhető oszlopok kilistázása. Megjeleníti az oszlop tárolt címét és azonosítóját.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --details, -d
- Részletek mutatása minden oszlopnál.
REMOVE_CUSTOM_COLUMN¶
calibredb remove_custom_column [options] label
Eltávolítja a címkével azonosított egyéni oszlopot. Az elérhető oszlopokat a 'custom_columns' paranccsal tekintheti meg.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --force, -f
- Ne kérjen megerősítést
SET_CUSTOM¶
calibredb set_custom [options] column id value
Beállítja az azonosítóval azonosított könyv egyéni oszlopának értékét. Az azonosítók listáját a keresés paranccsal kaphatja meg. Az egyéni oszlopnevek listáját a 'custom_columns' paranccsal kaphatja meg.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --append, -a
- Ha az oszlop több értéket tárol, akkor a megadott értéket adja a meglévőkhöz és cserélje le őket.
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.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --really-do-it, -r
- Tényleg állítsa vissza az adatbázist. Enélkül az opció nélkül nem fut a parancs.
CHECK_LIBRARY¶
calibredb check_library [kapcsolók]
Néhány ellenőrzés lefuttatása a könyvtár belső fájlrendszerén. Visszajelzések: invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, malformed_formats, malformed_paths, failed_folders
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --csv, -c
- CSV kimenet
- --ignore_extensions, -e
- A kihagyandó kiterjesztések vesszővel tagolt listája. Alapértelmezett: all (mind)
- --ignore_names, -n
- Vesszővel elválasztott lista a kihagyandó nevekkel. Alapértelmezett: Összes
- --report, -r
- A naplók vesszővel elválasztott listája. Alapértelmezés: mind
- --vacuum-fts-db
- A teljes szöveges keresés adatbázis kitiszítása. Ez a művelet nagyon lassú és memóriaigényes lehet az adatbázis méretétől függően.
LIST_CATEGORIES¶
calibredb list_categories [options]
Jelentést készít az adatbázisban lévő kategóriainformációkról. Az információ megegyezik a Címkeböngészőben megjelenő információkkal.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --categories, -r
- A kategória keresőneveinek vesszővel elválasztott listája. Alapértelmezett: mind (all)
- --csv, -c
- CSV kimenet
- --dialect
- A létrehozandó CSV-fájl típusa. Választási lehetőségek: excel, excel-tab, unix
- --item_count, -i
- Csak a kategórián belüli elemek számát adja meg az egyes elemekhez tartozó darabszámok helyett
- --width, -w
- Egy sor maximális szélessége a kimenetben. A képernyőmérethez szükséges.
BACKUP_METADATA¶
calibredb backup_metadata [options]
Biztonsági másolatot készít az adatbázisban tárolt metaadatokról az egyes könyvek mappájában lévő egyedi OPF-fájlokba. Ez általában automatikusan megtörténik, de ezt a parancsot futtathatja az OPF fájlok újragenerálására az '--all' kapcsolóval.
Ne feledje, hogy erre általában nincs szükség, mivel az OPF-fájlokról a rendszer automatikusan biztonsági másolatot készít minden metaadat megváltoztatásakor.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --all
- Általában ez a parancs csak azokon a könyveken működik, amelyekben elavult OPF-fájlok vannak. Ezzel az opcióval minden könyvön működik.
CLONE¶
calibredb clone path/to/new/library
Hozzon létre egy klónt az aktuális könyvtárból. Ezzel egy új, üres könyvtárat hoz létre, amely ugyanazokkal az egyéni oszlopokkal, virtuális könyvtárakkal és egyéb beállításokkal rendelkezik, mint az aktuális könyvtárban.
A klónozott könyvtár nem tartalmaz majd könyveket. Ha teljes másolatot hozna létre, beleértve az összes könyvet, egyszerűen használja a fájlrendszer eszközeit a könyvtármappa másolásához.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
EMBED_METADATA¶
calibredb embed_metadata [options] book_id
Frissíti a Calibre könyvtárban tárolt tényleges könyvfájlok metaadatait a Calibre-adatbázis metaadataiból. Normális esetben a metaadatok csak akkor frissülnek, ha fájlokat exportálunk a Calibre-ből. Ez a parancs akkor hasznos, ha azt szeretné, hogy a fájlok a helyükön legyenek frissítve. Vegye figyelembe, hogy a különböző fájlformátumok eltérő mennyiségű metaadatot támogatnak. A book_id speciális "all” értékével frissítheti az összes könyv metaadatait. Számos könyvazonosítót is megadhat szóközzel elválasztva, és azonosító tartományt kötőjellel elválasztva. Például: calibredb embed_metadata 1 2 10-15 23
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --only-formats, -f
- Csak a megadott formátumú fájlok metaadatait frissítése. Több formátum esetén adja meg többször. Alapértelmezés szerint minden formátum frissül.
SEARCH¶
calibredb search [options] search expression
Keres a könyvtárban a megadott keresési kifejezésre, és a keresési kifejezésnek megfelelő könyvazonosítók vesszővel elválasztott listáját adja vissza. A kimeneti formátum hasznos más olyan parancsok betáplálásához, amelyek elfogadják az azonosítók listáját bemenetként.
A keresési kifejezés bármi lehet a Calibre hatékony keresési lekérdezési nyelvéből, például: calibredb search author:asimov 'title:"i robot"'
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --limit, -l
- A visszaküldendő eredmények maximális száma. Alapértelmezett az összes eredmény.
FTS_INDEX¶
calibredb fts_index [options] enable/disable/status/reindex
Irányítja a teljes szöveges keresés indexelési folyamatát.
- enable
- Bekapcsolja az FTS-indexelést ehhez a könyvtárhoz
- disable
- Kikapcsolja az FTS-indexelést ehhez a könyvtárhoz
- status
- Az aktuális indexelési állapotot mutatja
- reindex
- Egyes könyvek vagy a teljes könyvtár újraindexelésére használható. Adott könyvek újraindexeléséhez megadja a könyvazonosítókat további argumentumként a reindex parancs után. Ha nincs megadva könyvazonosító, a teljes könyvtár újraindexelésre kerül.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --indexing-speed
- Az indexelés sebessége. A gyors indexelést a számítógép összes erőforrásának felhasználásával, a lassút pedig a kevésbé erőforrásigényes indexeléshez használja. Vegye figyelembe, hogy a sebesség minden hívás után visszaáll lassúra.
- --wait-for-completion
- Várja meg, amíg az összes könyvet indexeli, és időnként mutatja az indexelés előrehaladását
FTS_SEARCH¶
calibredb fts_search [opciók] keresési kifejezés
Elvégez egy teljes szöveges keresést a teljes könyvtárban vagy annak egy részhalmazában.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --do-not-match-on-related-words
- Csak a pontos szavakra egyezik, nem kapcsolódó szavakra. Tehát a korrekció nem egyezik a javítással.
- --include-snippets
- Az egyes egyezéseket körülvevő szövegrészleteket csatolja be. Ne feledje, hogy ez sokkal lassítja a keresést.
- --indexing-threshold
- A könyvtár mekkora részét kell indexelni a keresés engedélyezése előtt, százalékban. Alapértelmezés szerint 90
- --match-end-marker
- A jelölő a részleten belüli egyező szó végét jelzi
- --match-start-marker
- A jelölő a részleten belüli egyező szó kezdetének jelzésére szolgál
- --output-format
- A keresési eredmények kimeneti formátuma. Vagy "text” az egyszerű szöveghez, vagy "json” a JSON-kimenethez.
- --restrict-to
- Korlátozza a keresett könyveket keresőkifejezés vagy azonosítók használatával. Például: ids:1,2,3 az azonosítókkal való korlátozáshoz vagy search:tag:foo a foo címkével rendelkező könyvekre való korlátozáshoz.
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
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --as-html
- When showing a note, output it as HTML instead of Markdown formatted text
- --field
- 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 ...]
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --search, -s
- 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 ...
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --for-machine
- Generate output in JSON format, which is more suitable for machine parsing
- --replace
- 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 ...
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --annotation-user
- 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.
- --format, -f
- The export format, one of: text, markdown, json. For search, text or json. Default is: text
- --no-stemming
- For search, match exact word forms instead of word stems
- --search, -s
- Only list, search or export the annotations of books matching the specified book search query, for example: --search "series:Foundation"
- --type, -t
- Only list, search or export annotations of the specified type, one of: highlight, bookmark
- --user-type
- 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
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --for-machine
- Generate output for the list action in JSON format, which is more suitable for machine parsing
- --formats
- 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.
Amikor olyan argumentumokat ad át calibredb-nak, amelyekben szóköz van, tegye idézőjelek közé az argumentumokat. Például: "/some path/with spaces"
- --for-machine
- Output the list of files as JSON
- --name
- Name to use for the added file, relative to the data directory
- --output
- Local destination for the get action
- --permanent
- Permanently delete the data file instead of using the recycle bin
- --replace
- Allow replacing existing files when adding, getting or renaming
Author¶
Kovid Goyal
Copyright¶
Kovid Goyal
| November 6, 2026 | 9.18.0 |