Scroll to navigation

CALIBREDB(1) calibre CALIBREDB(1)

NAME

calibredb - calibredb

calibredb command [options] [arguments]


calibredb är kommandoradsgränssnittet till calibre-databasen. Det har flera underkommandon som dokumenteras nedan.

calibredb kan användas för att hantera antingen en calibre-databas som anges med en sökväg eller en calibre-innehållsserver som körs antingen på den lokala datorn eller via internet. Du kan starta en calibre- innehållsserver antingen med programmet calibre-server eller genom att klicka på Anslut/dela  →  Starta innehållsserver i huvudprogrammet calibre. Eftersom calibredb kan ändra dina calibre-bibliotek måste du först konfigurera autentisering på servern. Det kan göras på två sätt:

  • Om du endast tänker ansluta till en server som körs på samma dator kan du använda innehållsserverns alternativ --enable-local-write. Då kan alla program som körs på den lokala datorn, inklusive calibredb, ändra dina calibre-data. När servern körs från huvudprogrammet calibre finns alternativet under Inställningar → Dela via nätet → Avancerat. Var dock försiktig, eftersom vissa webbläsare, framför allt Firefox, även låter godtyckliga webbplatser komma åt lokala servrar. Om du använder Firefox är det bättre att konfigurera användarnamn och lösenord enligt beskrivningen nedan. Begränsning av åtkomst till lokala nätverk är fortfarande inte implementerad i Firefox 149.
  • Om du vill aktivera åtkomst via internet bör du skapa användarkonton på servern och använda alternativen --username och --password för calibredb för att ge programmet åtkomst. Du kan konfigurera användarautentisering för calibre-server genom att använda alternativet --enable-auth och skapa användarkonton med --manage-users. Om du kör servern från huvudprogrammet calibre använder du Inställningar → Dela via nätet → Kräv användarnamn/lösenord.



För att ansluta till en innehållsserver som körs anger du serverns URL med alternativet --with-library. Se dokumentationen för alternativet för detaljer och exempel.

  • GLOBALA ALTERNATIV
  • list
  • add
•
LÄGGA TILL FRÅN MAPPAR

  • remove
  • add_format
  • remove_format
  • show_metadata
  • set_metadata
  • export
  • catalog
•
EPUB ALTERNATIV

  • 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

GLOBALA ALTERNATIV

visa denna hjälptext och avsluta

Sökväg till calibre-biblioteket. Standardinställningen är att använda sökvägen som lagras i inställningarna. Du kan också ansluta till en calibre-innehållsserver för att utföra åtgärder på fjärrbibliotek. För att göra det, använd en URL av formatet: <http://hostname:port/#library_id> till exempel <http://localhost:8080/#mylibrary>. library_id är biblioteks-ID:t för det bibliotek du vill ansluta till på innehållsservern. Du kan använda det speciella library_id-värdet - för att få en lista över biblioteks-ID:n som är tillgängliga på servern. För information om hur du konfigurerar åtkomst via en innehållsserver, se https://manual.calibre-ebook.com/sv/generated/sv/calibredb.html.

Lösenord för anslutning till en calibre-innehållsserver. För att läsa lösenordet från standardinmatning, använd specialvärdet: <stdin>. För att läsa lösenordet från en fil, använd: <f:/path/to/file> (dvs. <f: följt av hela sökvägen till filen och en efterföljande >). Vinkelparenteserna ovan är nödvändiga, kom ihåg att skydda dem med escape-tecken eller citattecken i skalet.

Tidsgränsen, i sekunder, när du ansluter till ett calibre-bibliotek via nätverket. Standard är två minuter.

Användarnamn för anslutning till en calibre-innehållsserver

visa programmets versionsnummer och avsluta

LIST

calibredb list [options]


Lista de böcker som finns i calibre-databasen.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Sortera resultaten i stigande ordning

Fält som ska visas när böcker listas i databasen. Ska vara en kommaseparerad lista med fält. Tillgängliga fält: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Standard: title,authors. Specialfältet "all" kan användas för att välja alla fält. Förutom de inbyggda fälten ovan är anpassade fält också tillgängliga som *field_name, till exempel för ett anpassat fält #rating, använd namnet: *rating

Skapa utmatning i JSON-format, som är mer lämpat för maskintolkning. Alternativen för radbredd och avgränsare ignoreras då.

Högsta antalet resultat att visa. Standard: alla

Största bredd på en enskild rad i utmatning. Standardinställningen är att upptäcka skärmstorlek.

Prefixet för alla sökvägar. Standard är den absoluta sökvägen till biblioteksmappen.

Filtrera resultat efter sökförfrågan. För information om sökformatet, se sökrelaterad dokumentation i användarmanualen. Standard är att inte filtrera.

Sträng som används för att separera fält. Standard är blanksteg.

Fältet som resultaten ska sorteras efter. Du kan ange flera fält genom att separera dem med kommatecken. Tillgängliga fält: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Standard: id. Utöver de inbyggda fälten ovan finns även anpassade fält tillgängliga som *field_name, till exempel för ett anpassat fält #rating, använd namnet: *rating

Mallen som ska köras om "template" finns i fältlistan. Observera att mallar ignoreras när du ansluter till en calibre-server. Standard: Ingen

Sökväg till en fil som innehåller mallen som ska köras om "template" finns i fältlistan. Standard: Ingen

Rubrik till mallkolumnen. Standard: template. Det här alternativet ignoreras om alternativet --for-machine är inställt

ADD

calibredb add [options] file1 file2 file3 ...


Lägg till de angivna filerna som böcker i databasen. Du kan även ange mappar, se mapprelaterade alternativ nedan.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Ange författarna för den tillagda boken eller de tillagda böckerna

Om böcker med liknande titlar och författare hittas, slå samman de inkommande formaten (filer) automatiskt med befintliga bokposter. Värdet "ignore" betyder att dubblettformat ignoreras. Värdet "overwrite" betyder att dubblettformat i biblioteket skrivs över med de nyligen tillagda filerna. Värdet "new_record" betyder att dubblettformat placeras i en ny bokpost.

Sökväg till omslaget att använda för den tillagda boken

Lägg till böcker i databasen även om de redan finns. Jämförelse görs baserat på boktitlar och författare. Observera att alternativet --automerge har företräde.

Lägg till en tom bok (en bok utan format)

Ange identifierare för den här boken, t.ex. -I asin:XXX -I isbn:YYY

Ange ISBN för den tillagda boken eller de tillagda böckerna

En kommaseparerad lista med språk (bäst att använda ISO639-språkkoder, även om vissa språknamn kanske också känns igen)

Ange serie för den tillagda boken eller de tillagda böckerna

Ange serienummer för den tillagda boken eller de tillagda böckerna

Ange taggar i den tillagda boken eller de tillagda böckerna

Ange titel för den tillagda boken eller de tillagda böckerna

LÄGGA TILL FRÅN MAPPAR

Alternativ för att anpassa tilläggning av böcker från mappar. Som standard läggs endast filer som har ändelser av kända e-boksfiltyper till.

Ett filnamnsmönster (glob), filer som matchar det här mönstret kommer att läggas till vid skanning av mappar efter filer, även om de inte är av en känd e-boksfiltyp. Kan anges flera gånger för flera mönster.

Ett filnamnsmönster (glob), filer som matchar det här mönstret ignoreras vid skanning av mappar efter filer. Kan anges flera gånger för flera mönster. Till exempel: *.pdf ignorerar alla PDF-filer

Antag att varje mapp endast har en enda logisk bok och att alla filer i den är olika e-boksformat av den boken

Bearbeta mappar rekursivt

REMOVE

calibredb remove ids


Ta bort böckerna som anges av ids från databasen. ids ska vara en kommaseparerad lista med ID-nummer (du kan få fram ID-nummer med kommandot search). Till exempel 23,34,57-85 (när du anger ett intervall ingår inte det sista numret i intervallet).

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Använd inte papperskorgen

ADD_FORMAT

calibredb add_format [options] id ebook_file


Lägg till e-boken i ebook_file bland de tillgängliga formaten för den logiska bok som identifieras av id. Du kan få fram id med kommandot search. Om formatet redan finns ersätts det, såvida inte alternativet för att förhindra ersättning anges.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Lägg till filen som en extra datafil till boken, inte som ett e-boksformat

Ersätt inte formatet om det redan finns

REMOVE_FORMAT

calibredb remove_format [options] id fmt


Ta bort formatet fmt från den logiska boken identifierad med hjälp av id. Du kan få id med sökkommandot. fmt bör vara en filändelse som LRF eller TXT eller EPUB. Om den logiska boken inte har fmt tillgängligt, görs inget.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

SHOW_METADATA

calibredb show_metadata [options] id


Visa metadata lagrade i calibre-databasen för boken identifierad av id. id är ett id-nummer från sökkommandot.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Skriv metadata i OPF-form (XML)

SET_METADATA

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


Ställ in metadata som lagras i calibre-databasen för den bok som identifieras med book_id från OPF-filen metadata.opf. book_id är ett bok-id-nummer från sökkommandot. Du kan få en snabb känsla för OPF-formatet genom att använda omkopplaren --as-opf till kommandot show_metadata. Du kan också ställa in metadata för enskilda fält med flaggan --field. Om du använder flaggan --field behöver du inte ange en OPF-fil.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Fältet som ska anges. Formatet är field_name:value, till exempel: --field tags:tag1,tag2. Använd --list-fields för att få en lista över alla fältnamn. Du kan ange alternativet flera gånger för att ställa in flera fält. Observera att du för språk måste använda ISO 639-språkkoder (t.ex. en för engelska och fr för franska). För identifierare är syntaxen --field identifiers:isbn:XXXX,doi:YYYYY. För booleska fält (ja/nej) använder du true och false eller yes och no.

Lista namnen på de metadatafält som kan användas med alternativet --field

EXPORT

calibredb export [options] ids


Exportera böckerna som anges av identifierare (en kommaseparerad lista) till filsystemet. Exporten sparar alla format av boken, dess omslag och metadata (i en OPF-fil). Eventuella extra datafiler som är kopplade till boken sparas också. Du kan få id-nummer från sökkommandot.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Exportera alla böcker i databasen och ignorera listan med identifierare.

Låt calibre konvertera alla icke-engelska tecken till engelska ekvivalenter för filnamn. Detta är användbart om du sparar i ett äldre filsystem utan fullt stöd för Unicode-filnamn. Om den här flaggan anges stängs beteendet av.

Normalt sparar calibre omslaget i en separat fil tillsammans med själva e-boksfilerna. Om den här flaggan anges stängs beteendet av.

Spara alla datafiler som är kopplade till boken när du sparar boken Om den här flaggan anges stängs beteendet av.

Normalt kommer calibre att uppdatera metadata i de sparade filerna utifrån det som finns i calibre-biblioteket. Detta gör att filerna sparas långsammare till disken. Om den här flaggan anges stängs beteendet av.

Normalt kommer calibre att skriva metadata i en separat OPF-fil tillsammans med själva e-boksfilerna. Om den här flaggan anges stängs beteendet av.

Kommaseparerad lista med format att spara för varje bok. Som standard sparas alla tillgängliga format.

Rapportera förlopp

--replace-whitespace
Ersätt blanktecken med understreck.

Exportera alla böcker till en enda mapp

Mallen för att anpassa filnamn och mappstruktur för de sparade filerna. Standard är "{author_sort}/{title}/{title} - {authors}" vilket sparar böcker i en undermapp per författare med filnamn bestående av titel och författare. Tillgängliga kontroller är: {author_sort, authors, id, isbn, languages, last_modified, pages, pubdate, publisher, rating, series, series_index, tags, timestamp, title}

Format för datumvisning. %d - dag, %b - månad, %m - månadsnummer, %Y - år. Standard är: %b, %Y

Exportera böcker till den angivna mappen. Standard är .

Konvertera sökvägar till gemener.

CATALOG

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


Exportera en katalog i det format som anges av filändelsen i path/to/destination. Alternativen styr hur poster visas i den genererade katalogen. Olika katalogformat stöder olika uppsättningar alternativ. För att se de olika alternativen anger du utmatningsfilens namn och sedan alternativet --help.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Kommaseparerad lista över databas-ID:n som ska ingå i katalogen. Om listan anges ignoreras --search. Standard: alla

Filtrera resultat efter sökförfrågan. För information om sökformatet, se sökrelaterad dokumentation i användarmanualen. Standard: Ingen filtrering

Visa detaljerad utmatningsinformation. Användbart för felsökning

EPUB ALTERNATIV

Titel på den genererade katalogen som används som titel i metadata. Standard: 'My Books' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Skapa korsreferenser i författarsektionen för böcker med flera författare. Standard: 'False' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Spara utmatning från olika stadier av konverteringsprocessen till den angivna mappen. Användbart om du är osäker på i vilket skede av konverteringsprocessen ett problem inträffar. Standard: 'None' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Regex som beskriver taggar som ska exkluderas som genrer. Standard: '[.+]|^+$' exkluderar taggar inom hakparenteser, t.ex. '[Project Gutenberg]', och '+', standardtaggen för lästa böcker. Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Anger de regler som används för att exkludera böcker från den genererade katalogen. Modellen för en undantagsregel är antingen ('<rule name>','Tags','<comma-separated list of tags>') eller ('<rule name>','<custom column>','<pattern>'). Till exempel: (('Archived books','#status','Archived'),) exkluderar en bok med värdet 'Archived' i den anpassade kolumnen 'status'. När flera regler har definierats tillämpas alla regler. Standard: "(('Catalogs','Tags','Catalog'),)" Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Inkludera sektionen 'Författare' i katalogen. Standard: 'False' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Inkludera sektionen 'Beskrivningar' i katalogen. Standard: 'False' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Inkludera sektionen 'Genrer' i katalogen. Standard: 'False' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Inkludera sektionen 'Nyligen tillagda' i katalogen. Standard: 'False' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Inkludera sektionen 'Serier' i katalogen. Standard: 'False' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Inkludera sektionen 'Titlar' i katalogen. Standard: 'False' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Källfält för avsnittet 'Genrer'. Standard: 'Taggar' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Anpassat fält med anteckningstext som ska infogas i beskrivningsrubriken. Standard: '' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

#<custom field>:[before|after]:[True|False] anger: <custom field> Anpassat fält innehåller anteckningar att slå samman med kommentarer [before|after] Placering av anteckningar med avseende på kommentarer [True|False] - En horisontell linje infogas mellan anteckningar och kommentarer Standard: '::' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

--output-profile
Anger utmatningsprofilen. I vissa fall krävs en utmatningsprofil för att optimera katalogen för enheten. Till exempel skapar "kindle" eller "kindle_dx" en strukturerad innehållsförteckning med avsnitt och artiklar. Standard: 'None' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

--prefix-rules
Anger de regler som används för att inkludera prefix som indikerar lästa böcker, önskelistsposter och andra användardefinierade prefix. Modellen för en prefixregel är ('<rule name>','<source field>','<pattern>','<prefix>'). När flera regler har definierats används den första matchande regeln. Standard: "(('Read books','tags','+','✓'),('Wishlist item','tags','Wishlist','×'))" Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Använd en namngiven förinställning som skapats med katalogbyggaren i det grafiska gränssnittet. En förinställning anger alla inställningar för att bygga en katalog. Standard: 'None' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Riktvärde för storleken (i tum) på bokomslag i katalogen. Intervall: 1.0 - 2.0 Standard: '1.0' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

Ersätt befintliga omslag när du skapar katalog. Standard: 'False' Gäller: AZW3-, EPUB-, MOBI-utmatningsformat

SAVED_SEARCHES

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


Hantera de sparade sökningarna i den här databasen. Om du försöker lägga till en sökfråga med ett namn som redan finns ersätts den befintliga sökningen.

Syntax för att lista, vilket är standardåtgärden:

calibredb saved_searches list

Syntax för att lägga till:

calibredb saved_searches add search_name search_expression

Syntax för att ta bort:

calibredb saved_searches remove search_name

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

ADD_CUSTOM_COLUMN

calibredb add_custom_column [options] label name datatype


Skapa en anpassad kolumn. label är det maskinvänliga namnet på kolumnen. Får inte innehålla blanksteg eller kolon. name är det människovänliga namnet på kolumnen. datatype är en av: bool, comments, composite, datetime, enumeration, float, int, rating, series, text

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

En uppslagstabell med alternativ för att anpassa hur data i den här kolumnen ska tolkas. Det här är en JSON-sträng. För uppräkningskolumner, använd --display"{\ "enum_values\ ":[\ "val1\ ", \ "val2\ "]}" Variabeln display kan innehålla många alternativ. Alternativen per kolumntyp är: composite: composite_template, composite_sort, make_category,contains_html, use_decorations datetime: date_format enumeration: enum_values, enum_colors, use_decorations int, float: number_format text: is_names, use_decorations Det bästa sättet att hitta giltiga kombinationer är att skapa en anpassad kolumn av lämplig typ i gränssnittet och sedan titta på OPF-säkerhetskopian för en bok (se till att en ny OPF har skapats sedan kolumnen lades till). I OPF-filen ser du JSON-värdet för "display" för den nya kolumnen.

Den här kolumnen lagrar taggliknande data (dvs. flera kommaseparerade värden). Gäller endast om datatypen är text.

CUSTOM_COLUMNS

calibredb custom_columns [options]


Lista tillgängliga anpassade kolumner. Visar kolumnetiketter och ID:n.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Visa detaljer för varje kolumn.

REMOVE_CUSTOM_COLUMN

calibredb remove_custom_column [options] label


Ta bort den anpassade kolumnen som identifieras med label. Du kan se tillgängliga kolumner med kommandot custom_columns.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Fråga inte efter bekräftelse

SET_CUSTOM

calibredb set_custom [options] column id value


Ange värdet i en anpassad kolumn för boken som identifieras av id. Du kan få en lista med ID:n med kommandot search. Du kan få en lista med anpassade kolumnnamn med kommandot custom_columns.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Om kolumnen lagrar flera värden, lägg till de angivna värdena till de befintliga i stället för att ersätta dem.

RESTORE_DATABASE

calibredb restore_database [options]


Återställ den här databasen från metadata som lagras i OPF-filer i varje mapp i calibre-biblioteket. Det är användbart om filen metadata.db har skadats.

VARNING: Det här kommandot återskapar databasen fullständigt. Du förlorar alla sparade sökningar, användarkategorier, metadatakopplingar, sparade konverteringsinställningar för enskilda böcker och anpassade recept. Återställd metadata är bara så korrekt som innehållet i OPF-filerna.

Avslutningsstatusen är 0 om återställningen lyckades, 1 om den misslyckades helt och 2 om databasen återställdes men vissa böcker eller andra data inte kunde återställas.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Utför återställningen. Kommandot körs inte om det här alternativet inte anges.

CHECK_LIBRARY

calibredb check_library [options]


Utför kontroller av filsystemet som representerar ett bibliotek. Rapporterna är invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, malformed_formats, malformed_paths, failed_folders

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Utmatning i CSV

Kommaseparerad lista över filändelser att ignorera. Standard: alla

Kommaseparerad lista över namn att ignorera. Standard: Alla

Kommaseparerad lista över rapporter. Standard: Alla

Komprimera databasen för fulltextsökning. Detta kan vara mycket långsamt och minneskrävande, beroende på databasens storlek.

LIST_CATEGORIES

calibredb list_categories [options]


Skapa en rapport om kategoriinformationen i databasen. Informationen motsvarar vad som visas i taggbläddraren.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Kommaseparerad lista över kategoriuppslagsnamn. Standard: Alla

Utmatning i CSV

Den typ av CSV-fil som ska produceras. Val: excel, excel-tab, unix

Mata endast ut antalet poster i en kategori i stället för antalet per post inom kategorin

Största bredd på en enskild rad i utmatning. Standardinställningen är att upptäcka skärmstorlek.

BACKUP_METADATA

calibredb backup_metadata [options]


Säkerhetskopiera metadata från databasen till separata OPF-filer i varje bokmapp. Det sker normalt automatiskt, men du kan köra det här kommandot med alternativet --all för att tvinga fram nya OPF-filer.

Det behövs normalt inte, eftersom OPF-filerna säkerhetskopieras automatiskt varje gång metadata ändras.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Normalt fungerar det här kommandot endast på böcker som har inaktuella OPF-filer. Det här alternativet gör att det fungerar på alla böcker.

CLONE

calibredb clone sökväg/till/nytt/bibliotek


Skapa en klon av det aktuella biblioteket. Det här skapar ett nytt, tomt bibliotek som har alla samma anpassade kolumner, virtuella bibliotek och andra inställningar som det aktuella biblioteket.

Det klonade biblioteket kommer inte att innehålla några böcker. Om du vill skapa en fullständig dubblett, inklusive alla böcker, använd helt enkelt dina filsystemverktyg för att kopiera biblioteksmappen.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

EMBED_METADATA

calibredb embed_metadata [options] book_id


Uppdatera metadata i själva bokfilerna som är lagrade i calibre-biblioteket från metadata i calibre-databasen. Normalt uppdateras metadata endast vid export av filer från calibre, det här kommandot är användbart om du vill att filerna ska uppdateras på plats. Observera att olika filformat stöder olika mängder metadata. Du kan använda specialvärdet 'all' för book_id för att uppdatera metadata i alla böcker. Du kan också ange många bokidentifierare åtskilda med blanksteg och id-intervall åtskilda med bindestreck. Till exempel: calibredb embed_metadata 1 2 10-15 23

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Uppdatera endast metadata i filer med det angivna formatet. Ange alternativet flera gånger för flera format. Som standard uppdateras alla format.

SEARCH

calibredb search [options] sökuttryck


Sök i biblioteket efter den angivna söktermen och returnera en kommaseparerad lista med bokidentifierare som matchar sökuttrycket. Utmatningsformatet är användbart som inmatning till andra kommandon som accepterar en lista med identifierare.

Sökuttrycket kan vara vad som helst från calibres kraftfulla sökfrågespråk, till exempel: calibredb search author:asimov 'title:"i robot"'

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Högsta antalet resultat att returnera. Standard är alla resultat.

FTS_INDEX

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


Styr indexeringsprocessen för fulltextsökning.

Aktiverar FTS-indexering för det här biblioteket
Inaktiverar FTS-indexering för det här biblioteket
Visar aktuell indexeringsstatus
Kan användas för att återindexera antingen vissa böcker eller hela biblioteket. För att återindexera vissa böcker, ange bok-ID:n som ytterligare argument efter kommandot reindex. Om inga bokidentifierare anges återindexeras hela biblioteket.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Indexeringshastigheten. Använd fast för snabb indexering som använder datorns alla resurser och slow för mindre resurskrävande indexering. Observera att hastigheten återställs till slow efter varje anrop.

Vänta tills alla böcker har indexerats och visa indexeringsförloppet med jämna mellanrum

FTS_SEARCH

calibredb fts_search [options] sökuttryck


Gör en fulltextsökning i hela biblioteket eller en delmängd av det.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Matcha endast exakta ord, inte besläktade ord. Då matchar correction inte correcting.

Inkludera utdrag ur texten runt varje träff. Observera att detta gör sökningen mycket långsammare.

Hur mycket av biblioteket som måste indexeras innan sökning är tillåten, i procent. Standard är 90

Markören som anger slutet på ett matchande ord i ett textutdrag

Markören som anger början på ett matchande ord i ett textutdrag

--output-format
Formatet att mata ut sökresultaten i. Antingen "text" för vanlig text eller "json" för JSON-utmatning.

Begränsa de sökta böckerna, antingen med ett sökuttryck eller identifierare. Till exempel: ids:1,2,3 för att begränsa med id eller search:tag:foo för att begränsa till böcker med taggen foo.

NOTES

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


Hantera anteckningar som hör till objekt som författare, serier, taggar och utgivare. FIELD är fältets söknamn, till exempel authors, series, tags, publisher eller #mycolumn. ITEM är objektets namn, till exempel en författares namn. Objekten matchas utan hänsyn till skiftläge.

Lista objekten som har anteckningar, eventuellt bara i det angivna fältet. Detta är standardåtgärden:

calibredb notes list [FIELD]

Sök i anteckningarnas text med samma syntax för SQLite-fulltextsökning som verktyget Bläddra bland anteckningar i calibre. Skriv ut fältet, objektnamnet och ett utdrag för varje träff. Använd --field för att bara söka i anteckningar i ett visst fält:

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

Skriv ut ett objekts anteckning som Markdown-formaterad text, eller med --as-html som ett HTML-dokument med eventuella bilder inbäddade, lämpligt för användning med set:

calibredb notes show FIELD ITEM

Ersätt ett objekts anteckning med innehållet i en HTML-fil. Använd - för att läsa HTML-koden från standardinmatning. Bilder som är inbäddade som base64-kodade <data:-URL:er> läggs till i anteckningen för både lokala bibliotek och fjärrbibliotek. När ett lokalt bibliotek används och innehållet läses från en fil läggs även bilder till som anges med sökvägar relativa till filen:

calibredb notes set FIELD ITEM FILE

Ta bort anteckningen för ett objekt:

calibredb notes remove FIELD ITEM

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Visa anteckningen som HTML i stället för Markdown-formaterad text

Vid sökning i anteckningar begränsas sökningen till detta fält, till exempel: authors, tags eller #mycolumn

ITEMS

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


Byt namn på eller ta bort objekt, som författare, taggar, serier och utgivare, i alla böcker, på samma sätt som åtgärderna Hantera författare, taggar osv. i calibres gränssnitt. FIELD är fältets söknamn, till exempel authors, tags, series, publisher eller #mycolumn. Objekten matchas utan hänsyn till skiftläge.

Byt namn på ett objekt. Om ett objekt med namnet NEW_NAME redan finns slås de båda objekten ihop. För fält som innehåller flera värden kan NEW_NAME innehålla mer än ett värde, åtskilda av fältets avgränsare, till exempel ett kommatecken för taggar. Objektet ersätts då av alla värden:

calibredb items rename FIELD ITEM NEW_NAME

Ta bort ett eller flera objekt från alla böcker. Författare kan inte tas bort:

calibredb items remove FIELD ITEM [ITEM ...]

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Ändra endast böcker som matchar det angivna sökuttrycket, till exempel: tags:"=Fiction"

VIRTUAL_LIBRARIES

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


Hantera det här bibliotekets virtuella bibliotek. Ett virtuellt bibliotek är en sökning som får biblioteket att fungera som om det bara innehöll de böcker som matchar sökningen. För att lista eller söka efter böckerna i ett virtuellt bibliotek använder du: calibredb search 'vl:"name"'

Lista de virtuella biblioteken med deras sökningar och antal böcker. Detta är standardåtgärden:

calibredb virtual_libraries list

Skapa ett virtuellt bibliotek från en sökning:

calibredb virtual_libraries add name search_expression

Byt namn på ett virtuellt bibliotek:

calibredb virtual_libraries rename name new_name

Ta bort virtuella bibliotek; böckerna i dem ändras inte:

calibredb virtual_libraries remove name ...

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Generera utdata i JSON-format, som lämpar sig bättre för maskintolkning

Ersätt sökningen för ett befintligt virtuellt bibliotek med samma namn när ett bibliotek läggs till

ANNOTATIONS

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


Hantera böckers noteringar, det vill säga markeringar och bokmärken, som skapats i calibres e-bokvisare eller synkroniserats från andra program.

Lista noteringarna med deras id. Detta är standardåtgärden:

calibredb annotations list

Sök i markerad text, anteckningar till noteringar och bokmärkestitlar med samma syntax för SQLite-fulltextsökning som verktyget Bläddra bland noteringar. Resultaten sorteras efter relevans och innehåller noteringarnas id, boktitlar och matchande utdrag. Använd --search för att begränsa böckerna, --type för att begränsa typen av notering, --user-type och --annotation-user för att begränsa till en användare, --no-stemming för att matcha exakta ordformer eller --format json för en JSON-array med resultat som innehåller noteringsdata och utdrag:

calibredb annotations search "search expression"

Exportera noteringarna som vanlig text, Markdown eller JSON, grupperade efter bok. JSON-formatet är samma noteringssamling för calibre som skapas av knappen Exportera i verktyget Bläddra bland noteringar:

calibredb annotations export

Importera en noteringssamling för calibre som exporterats som JSON med detta kommando eller verktyget Bläddra bland noteringar. Samlingen får endast innehålla noteringar från en bok. BOOK_ID är målbokens id, inte det id som lagrats i filen. Endast noteringar för formatet FORMAT importeras; noteringar för andra format hoppas över. FORMAT måste finnas i målboken. Använd samma utgåva av boken så att positionerna stämmer överens:

calibredb annotations import BOOK_ID FORMAT FILE

Använd - som FILE för att läsa från standardinmatning. Hela samlingen valideras före importen. Noteringarna slås ihop med befintliga enligt e-bokvisarens regler: markeringar matchas efter UUID och bokmärken efter titel, och den nyare tidsstämpeln gäller. Upprepad import skapar inte dubbletter. Orelaterade noteringar och läspositioner bevaras.

Som standard importeras noteringar till dem som hör till calibres e-bokvisare. Använd --user-type web --annotation-user USER för att i stället importera dem till en användare av innehållsservern. Exporterade samlingar anger vilken användare noteringarna tillhör. Om en samling innehåller noteringar från mer än en användare avvisas den. Använd alternativen --user-type och --annotation-user vid export för att exportera en enda användares noteringar.

Ta permanent bort noteringarna med angivna id, som visas av list:

calibredb annotations remove ID ...

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Lista, sök efter eller exportera endast den angivna användarens noteringar. Vid import anger detta vilken användare av innehållsservern noteringarna ska importeras för och krävs med --user-type web. Observera att detta kan vara vilken användare som helst, inte bara den som används för att ansluta till ett fjärrbibliotek.

Exportformatet, ett av: text, markdown, json. Vid sökning: text eller json. Standardvärdet är: text

Matcha exakta ordformer i stället för ordstammar vid sökning

Lista, sök efter eller exportera endast noteringar för böcker som matchar den angivna boksökfrågan, till exempel: --search "series:Foundation"

Lista, sök efter eller exportera endast noteringar av den angivna typen, en av: highlight, bookmark

Lista, sök efter eller exportera endast noteringar för den angivna typen av användare. Vid import anger detta vilken typ av användare noteringarna ska importeras för: calibres e-bokvisare (local) eller en användare av innehållsservern (web). Standardvärdet vid import är local.

TRASH

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


Hantera böcker och format som har tagits bort och lagts i papperskorgen. Poster i papperskorgen raderas automatiskt permanent efter några dagar. ids är en kommaseparerad lista över bok-id, precis som för kommandot remove, till exempel: 23,34,57-85 (när ett intervall anges ingår inte det sista talet i intervallet).

Lista de borttagna böckerna och formaten, med de senast borttagna först, och tidpunkten då de togs bort, angiven i lokal tid. Borttagna format för böcker som inte längre finns markeras som omöjliga att återställa; de kan bara raderas. Med --for-machine anges tiderna i UTC:

calibredb trash list

Återställ borttagna böcker eller, med --formats, böckernas borttagna format:

calibredb trash restore ids

Radera poster från papperskorgen permanent:

calibredb trash delete ids

Radera allt i papperskorgen permanent:

calibredb trash empty

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Generera utdata för åtgärden list i JSON-format, som lämpar sig bättre för maskintolkning

Utför åtgärden på de angivna böckernas borttagna format i stället för på borttagna böcker

DATA_FILES

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


Hantera de extra datafiler som hör till en bok i lokala bibliotek eller fjärrbibliotek. Namnen är relativa till bokens datamapp. Använd / för undermappar; accepteras också. Filer vars namn innehåller ett listas, men kan inte hanteras på annat sätt. E-boksformat, omslag och metadata.opf kan inte nås med detta kommando. Fjärrbibliotek kräver ett konto med skrivåtkomst, liksom andra hanteringskommandon, och stöder inte konton med sökbegränsningar per bibliotek.

Lista filnamn, storlekar i byte och ändringstider (sekunder sedan Unix-epoken). Använd --for-machine för JSON-utdata:

calibredb data_files list BOOK_ID

Lägg till en fil med dess basnamn, eller använd --name för att ange ett namn eller en undermapp. Befintliga filer ersätts inte om inte --replace anges. Detta kan också göras med add_format --as-extra-data-file:

calibredb data_files add BOOK_ID FILE

Spara en datafil till --output på den lokala datorn. Befintliga utdatafiler ersätts inte om inte --replace anges:

calibredb data_files get BOOK_ID NAME --output FILE

Byt namn på en fil. Befintliga mål ersätts inte om inte --replace anges:

calibredb data_files rename BOOK_ID NAME NEW_NAME

Flytta en fil till operativsystemets papperskorg. Med --permanent raderas den permanent i stället. För fjärrbibliotek sker detta på servern:

calibredb data_files remove BOOK_ID NAME

Mappar som lämnas tomma av rename och remove tas bort. För fjärrbibliotek överförs varje fil i en enda begäran, så mycket stora filer kräver tillräckligt med minne både på klienten och servern. Uppladdningar begränsas av serverns maximala storlek för en begäran.

När du skickar argument som innehåller blanksteg till calibredb ska du omge argumenten med citattecken. Till exempel: "/some path/with spaces"

Mata ut listan över filer som JSON

Namn att använda för den tillagda filen, relativt datamappen

Lokalt mål för åtgärden get

Radera datafilen permanent i stället för att använda papperskorgen

Tillåt att befintliga filer ersätts när filer läggs till, hämtas eller byter namn

Author

Kovid Goyal

Copyright

Kovid Goyal

November 6, 2026 9.18.0