calibredb

calibredb command [opzioni] [argomenti]

calibredb è l’interfaccia da linea di comando che agisce sul database di calibre. Possiede molti sotto-comandi, descritti qui di seguito.

calibredb può essere usato per modificare un database di calibre identificato da un percorso oppure da un Server dei contenuti di calibre in esecuzione sulla macchina locale o su internet. Puoi avviare un Server dei contenuti di calibre con il comando calibre-server oppure facendo clic nell’interfaccia principale di calibre Connetti/condividi  →  Avvia Server dei contenuti. Dato che calibredb può modificare le tue biblioteche di calibre, devi prima impostare un’autenticazione per il server. Ci sono due modi per farlo:

  • Se intendi connetterti solamente a un server in esecuzione sul computer stesso,

puoi semplicemente usare l’opzione --enable-local-write del Server dei contenuti, per permettere ad ogni programma, calibredb incluso, in esecuzione sul computer locale di modificare i tuoi dati di calibre. Se il server è avviato dall’interfaccia principale di calibre, questa opzione si trova in Preferenze → Condivisione via rete → Avanzate. Fai attenzione però, perché alcuni browser, principalmente Firefox, permettono a qualunque altro sito web di accedere ai server locali. Se usi Firefox, è meglio impostare utenti e password, come descritto di seguito. Per il momento (Firefox 149), restrizioni all’accesso alla rete locale non sono state ancora introdotte.

  • Se vuoi invece abilitare l’accesso via internet, dovresti impostare

degli utenti per il server e usare le opzioni --username e --password con calibredb per permettergli di accedere. Puoi impostare l’autenticazione utente per calibre-server usando l’opzione --enable-auth e usando --manage-users per creare gli utenti. Se hai lanciato il server dall’interfaccia principale di calibre, usa Preferenze → Condivisione via rete → Richiedi nome utente/password.

Per connetterti a un server dei contenuti in esecuzione, inserisci l’URL del server attraverso l’opzione --with-library; vedi la documentazione dell’opzione per dettagli ed esempi.

OPZIONI GLOBALI

--help, -h

mostra questo messaggio di aiuto ed esci

--library-path, --with-library

Percorso della biblioteca di calibre. Per impostazione predefinita viene usato il percorso salvato nelle impostazioni. Puoi anche connetterti a un server dei contenuti di calibre ed eseguire azioni su biblioteche remote. Per fare ciò usa un URL di formato: http://hostname:port/#library_id per esempio, http://localhost:8080/#mylibrary. library_id è l'id della biblioteca a cui ti vuoi connettere nel server dei contenuti. Puoi usare il valore speciale per library_id di - per ottenere un elenco di id biblioteca disponibili nel server. Per maggiori dettagli su come impostare l'accesso attraverso un server dei contenuti, vedi https://manual.calibre-ebook.com/it/generated/it/calibredb.html.

--password

La password per connettersi a un server dei contenuti di calibre. Per leggere la password dallo standard input, usa il valore speciale: <stdin>. Per leggere la password da un file, usa <f:/path/to/file> (ovvero <f: followed by the full path to the file and a trailing >). Le parentesi angolari di cui sopra sono richieste, ricordati di anteporre un carattere di escape o di usare le virgolette nel tuo terminale.

--timeout

Il timeout, in secondi, della connessione a una biblioteca di calibre in rete. Il tempo predefinito è di due minuti.

--username

Nome utente per connettersi a un server di contenuto calibre

--version

mostra la versione del programma ed esci

list

calibredb list [opzioni]

Elenca i libri disponibili nel database di calibre.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--ascending

Ordina i risultati in ordine crescente

--fields, -f

I campi da mostrare quando sono elencati i libri del database. Dovrebbe essere una lista separata da virgole di campi. Campi disponibili: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Valore predefinito: %predefinito. Il campo speciale "all" può essere usato per selezionare tutti i campi. Oltre ai campi integrati di cui sopra, sono disponibili anche campi personalizzati scritti come *nome_campo; per esempio, per un campo personalizzato #valutazione, usa il nome: *rating

--for-machine

Genera output in formato JSON, più adatto all'elaborazione automatica. Le opzioni di larghezza e separazione di linea verranno ignorate.

--limit

Il numero massimo di risultati da visualizzare. Predefinito: tutti

--line-width, -w

La larghezza massima di una singola riga nell'output. L'impostazione predefinita è quella di rilevare la dimensione dello schermo.

--prefix

Il prefisso per tutti i percorsi. L'impostazione predefinita è il percorso alla cartella della biblioteca.

Filtra i risultati con una ricerca. Per il formato della ricerca, vedere la documentazione relativa alla ricerca nel manuale utente. L'opzione predefinita è quella di non filtrare.

--separator

La stringa usata per separare i campi. Predefinita: uno spazio.

--sort-by

Il campo da usare per l'ordinamento dei risultati. Puoi specificare più campi separandoli con virgole. Campi disponibili: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Predefinito: id. Oltre ai campi integrati di cui sopra, sono disponibili anche campi personalizzati definiti con *nome_campo; per esempio, per un campo personalizzato #valutazione, usa il nome: *valutazione

--template

Il modello da eseguire se "template" si trova nell'elenco dei campi. Tieni presente che i modelli vengono ignorati durente la connessione a un server di calibre. Predefinito: Nessuno

--template_file, -t

Percorso di un file contenente il modello da eseguire se "template" è nell'elenco dei campi. Predefinito: Nessuno

--template_heading

Intestazione della colonna del modello. Predefinito: pre%definito. Questa opzione viene ignorata se l'opzione --for-machine è impostata

add

calibredb add [opzioni] file1 file2 file3 ...

Aggiungi come libri i file specificati nel database. Puoi anche specificare delle cartelle, vedi le opzioni riferite alle cartelle qui sotto.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--authors, -a

Imposta gli autori dei libri aggiunti

--automerge, -m

Se vengono trovati libri con titoli e autori simili, unisci automaticamente i formati (file) in arrivo con voci di libro già esistenti. Un valore di "ignore" significa che i formati duplicati vengono scartati. Un valore di "overwrite" significa che i formati duplicati nella biblioteca vengono sovrascritti dai nuovi file aggiunti. Un valore di "new_record" significa che i formati duplicati sono inseriti in una nuova voce libro.

--cover, -c

Percorso della copertina da utilizzare per il libro aggiunto

--duplicates, -d

Aggiungi libri al database anche se esistono già. Il confronto è basato su titoli e autori dei libri. Nota che l'opzione --automerge ha la precedenza.

--empty, -e

Aggiungi un libro vuoto (un libro senza formati)

--identifier, -I

Imposta gli identificatori per questo libro, ad esempio: -I asin:XXX -I isbn:YYY

--isbn, -i

Imposta l'ISBN dei libri aggiunti

--languages, -l

Un elenco separato da virgole di lingue (meglio utilizzare i codici di lingua ISO639 per evitare che alcuni nomi di lingue non siano riconosciuti)

--series, -s

Imposta le serie dei libri aggiunti

--series-index, -S

Imposta il numero della serie dei libri aggiunti

--tags, -T

Imposta i tag dei libri aggiunti

--title, -t

Imposta il titolo dei libri aggiunti

AGGIUNTA DA CARTELLE

Opzioni per controllare l’aggiunta di libri dalle cartelle. Per impostazione predefinita solo i file con estensioni di e-book note sono aggiunti.

--add

Uno schema per il nome del file (glob pattern), i file che corrispondono a questo schema saranno aggiunti durante la scansione delle cartelle, anche se il loro tipo di file non è quello tipico di un e-book. Può essere specificato più volte per schemi multipli.

--ignore

Uno schema per il nome del file (glob pattern), i file che corrispondono a questo schema saranno ignorati durante la scansione delle cartelle. Può essere specificato più volte per schemi multipli. Ad esempio: *.pdf escluderà tutti i file PDF

--one-book-per-directory, -1

Assumi che ogni cartella abbia un solo libro "logico" e che tutti i file in essa contenuti siano differenti formati e-book dello stesso libro

--recurse, -r

Controlla cartelle ricorsivamente

remove

calibredb remove id

Rimuove dal database i libri identificati dagli id. Gli id dovrebbero essere una lista separata da virgole di numeri id (puoi ottenere i numeri id usando il comando search). Per esempio, 23,34,57-85 (quando si specifica un intervallo, l’ultimo numero dell’intervallo è escluso).

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--permanent

Do not use the trash bin

add_format

calibredb add_format [options] id ebook_file

Aggiungi l” e-book in ebook_file ai formati disponibili per il libro identificato per id. Puoi trovare l’id usando il comando cerca, se il formato è già presente verrà sostituito a meno che l’opzione “non sostituire” non sia stata specificata.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--as-extra-data-file

Aggiungi il file come un file di dati aggiuntivo, non come formato di e-book

--dont-replace

Non sostituire il formato se esiste già

remove_format

calibredb remove_format [opzioni] id fmt

Rimuovi il formato fmt identificato da id dal libro logico. Puoi ottenere l’id usando il comando search. fmt deve essere un’estensione di file come LRF, TXT o EPUB. Se il libro logico non ha un fmt disponibile, non fa niente.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

show_metadata

calibredb show_metadata [opzioni] id

Mostra i metadati salvati nel database di calibre per il libro identificato da id. id è un numero identificativo del comando di ricerca.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--as-opf

Stampa i metadati in formato OPF (XML)

set_metadata

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

Imposta i metadati memorizzati nel database di calibre per il libro identificato da book_id dal file OPF metadata.opf. book_id è un numero di identificazione del libro dal comando di ricerca. Puoi farti un’idea del formato OPF usando –as-opf passa al comando show_metadata. Puoi anche impostare i metadati di singoli campi con l’opzione –field. Se usi l’opzione –field, lì non è necessario specificare un file OPF.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--field, -f

Il campo da impostare. Il formato è nome_campo:valore, per esempio: --field tags:tag1,tag2. Usa --list-fields per ottenere una lista di tutti i nomi dei campi. Puoi specificare questa opzione più volte per impostare più di un campo. Nota bene: per le lingue devi usare i codici lingua ISO639 (p. es. en per inglese, it per italiano e così via). Per gli identificatori, la sintassi è --field identifiers:isbn:XXXX,doi:YYYYY. Per campi booleani (sì/no) usa true e false oppure yes e no.

--list-fields, -l

Elenca i nomi dei campi di metadati che possono essere utilizzati con l'opzione --field

export

calibredb export [opzioni] id

Esporta i libri specificati con id (una lista separata da virgole) su disco. L’operazione di esportazione salva tutti i formati del libro, la copertina e i metadati (in un file OPF). Anche tutti i file di dati aggiuntivi associati al libro vengono salvati. Puoi ottenere i numeri di id con il comando search.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--all

Esporta tutti i libri del database, ignorando la lista di id.

--dont-asciiize

Fai convertire a calibre tutti i caratteri non inglesi nei loro equivalenti inglesi nei nomi di file. Utile se si sta salvando in un vecchio filesystem che non ha il pieno supporto ai nomi di file Unicode. Selezionando questa opzione verrà disattivata questa funzione.

--dont-save-cover

Normalmente calibre salva le copertine in un file separato insieme ai file degli e-book. Selezionando questa opzione verrà disattivata questa funzione.

--dont-save-extra-files

Salvare tutti i file di dati associati al libro quando si salva il libro. Selezionando questa opzione verrà disattivata questa funzione.

--dont-update-metadata

Normalmente calibre aggiorna i metadati nei file salvati usando quelli che si trovano nella biblioteca di calibre. Questo rende il salvataggio più lento. Selezionando questa opzione verrà disattivata questa funzione.

--dont-write-opf

Normalmente calibre scrive i metadati in documenti OPF separati assieme ai file contenenti i libri. Selezionando questa opzione verrà disattivata questa funzione.

--formats

Elenco di formati separati da virgole da salvare per ogni libro. In modo predefinito, saranno salvati tutti i formati disponibili.

--progress

Avanzamento report

--replace-whitespace

Sostituisci gli spazi con trattini bassi.

--single-dir

Esporta tutti i libri in una singola cartella

--template

Lo schema che controlla i nomi di file e l'albero delle cartelle dei file salvati. Il valore predefinito è "{author_sort}/{title}/{title} - {authors}" che salva i libri in una sottocartella per autore mentre i nomi di file contengono titolo e autore. I controlli disponibili sono: {author_sort, authors, id, isbn, languages, last_modified, pages, pubdate, publisher, rating, series, series_index, tags, timestamp, title}

--timefmt

Il formato di visualizzazione delle date. %d - giorno, %b - mese, %m - numero mese, %Y - anno. Predefinito: %b, %Y

--to-dir

Esporta i libri nella cartella specificata. Il valore predefinito è .

--to-lowercase

Converti i percorsi in lettere minuscole.

catalog

calibredb catalog /percorso/di/destinazione.(csv|epub|mobi|xml...) [opzioni]

Esporta un catalogo nel formato specificato dall’estensione di /percorso/di/destinazione. Le opzioni controllano come sono mostrate le voci nel catalogo generato in output. Nota che formati di catalogo differenti supportano diversi set di opzioni. Per vedere le varie opzioni, specifica il nome del file di output e poi l’opzione –help.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--ids, -i

Lista degli identificativi ID per il catalogo in campi separati da virgole. Se dichiarati, --search è ignorata. Valore predefinito: tutti

Filtra i risultati in base alla query di ricerca. Per il formato della query di ricerca fare riferimento alla documentazione sulla sintassi di ricerca nel manuale utente. Predefinito: nessun filtraggio

--verbose, -v

Mostra un output dettagliato. Utile per il debug

EPUB OPZIONI

--catalog-title

Titolo del catalogo generato usato come titolo nei metadati. Valore predefinito: 'My Books' Si applica a: formati di output AZW3, EPUB, MOBI

--cross-reference-authors

Crea riferimenti incrociati nella sezione Autori per libri con autori multipli. Predefinito: 'False' Si applica a: formati di output AZW3, EPUB, MOBI

--debug-pipeline

Salva l'output dei differenti stadi di conversione raggiunti nella cartella specificata. Utile se non si conosce in quale stadio del processo di conversione si verifica l'errore. Valore predefinito: 'None' Si applica a: formati di output AZW3, EPUB, MOBI

--exclude-genre

Regex che descrive i tag da escludere come generi. Valore predefinito: '[.+]|^+$' esclude i tag tra parentesi quadre, p. es. '[Progetto Gutenberg]', e '+', il tag predefinito per i libri letti. Si applica a: formati di output AZW3, EPUB, MOBI

--exclusion-rules

Specifica le regole usate per escludere i libri dal catalogo generato. Il modello per una regola di esclusione è o ('<nome regola>','Tag','<lista di tag separati da virgola>') o ('<nome regola>','<colonna personalizzata>','<pattern>'). Ad Esempio: (('Libri archiviati','#stato,'Archiviato'),) escluderà un libro con valore 'Archiviato' nella colonna personalizzata 'stato'. Tutte le regole specificate verranno applicate. Valore predefinito: "(('Catalogs','Tags','Catalog'),)" Si applica a: formati di output AZW3, EPUB, MOBI

--generate-authors

Includi la sezione 'Autori' nel catalogo. Valore predefinito: 'False' Si applica a: formati di output AZW3, EPUB, MOBI

--generate-descriptions

Includi la sezione 'Descrizioni' nel catalogo. Valore predefinito: 'False' Si applica a: formati di output AZW3, EPUB, MOBI

--generate-genres

Includi la sezione 'Generi' nel catalogo. Valore predefinito: 'False' Si applica a: formati di output AZW3, EPUB, MOBI

--generate-recently-added

Includi la sezione 'Aggiunti di recente' nel catalogo. Valore predefinito: 'False' Si applica a: formati di output AZW3, EPUB, MOBI

--generate-series

Includi la sezione 'Serie' nel catalogo. Valore predefinito: 'False' Si applica a: formati di output AZW3, EPUB, MOBI

--generate-titles

Includi la sezione 'Titoli' nel catalogo. Valore predefinito: 'False' Si applica a: formati di output AZW3, EPUB, MOBI

--genre-source-field

Campo sorgente per la sezione Generi. Valore predefinito: 'Tag' Si applica a: formati di output AZW3, EPUB, MOBI

--header-note-source-field

Campo personalizzato che contiene una nota di testo da inserire nell'intestazione della Descrizione. Valore predefinito: '' Si applica a: formati di output AZW3, EPUB, MOBI

--merge-comments-rule

#<custom field>:[before|after]:[True|False] specificando: <custom field> Campo personalizzato contenente note da unire ai commenti [before|after] Posizione delle note rispetto ai commenti (prima o dopo) [True|False] - Viene inserita una riga orizzontale tra le note e i commenti Valore predefinito: '::' Si applica a: formati di output AZW3, EPUB, MOBI

--output-profile

Specifica il profilo di output. In alcuni casi un profilo di output è richiesto per ottimizzare il catalogo per il dispositivo. Ad esempio 'kindle' o 'kindle_dx' creano un Indice strutturato con Sezioni e Articoli. Valore predefinito: 'None' Si applica a: formati di output AZW3, EPUB, MOBI

--prefix-rules

Specifica le regole utilizzate per includere i prefissi che indicano i libri letti, gli elementi della lista dei desideri e altri prefissi specificati dall'utente. Il modello per una regola di prefisso è ('<nome regola>','<campo sorgente>','<pattern>','<prefisso>'). Quando più regole sono definite viene applicata la prima regola che ha una corrispondenza basata sul pattern. Valore predefinito: '(('Read books','tags','+','✓'),('Wishlist item','tags','Wishlist','×'))' Si applica a: formati di output AZW3, EPUB, MOBI

--preset

Usa un profilo con nome creato con l'interfaccia di costruzione catalogo. Un profilo specifica tutte le impostazioni necessarie per costruire un catalogo. Valore predefinito: 'None' Si applica a: formati di output AZW3, EPUB, MOBI

--thumb-width

Suggerimento di dimensione (in pollici) per le copertine dei libri nel catalogo. Intervallo: 1.0 - 2.0 Valore predefinito: '1.0' Si applica a: formati di output AZW3, EPUB, MOBI

--use-existing-cover

Sostituisci la copertina esistente quando generi il catalogo. Valore predefinito: 'False' Si applica a: formati di output AZW3, EPUB, MOBI

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

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

add_custom_column

calibredb add_custom_column [opzioni] etichetta nome tipo

Crea una colonna personalizzata. etichetta è il nome amichevole della macchina della colonna. Non deve contenere spazi o punteggiatura. nome è il nome amichevole della colonna. tipo è uno di: bool, comments, composite, datetime, enumeration, float, int, rating, series, text

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--display

Un dizionario di opzioni per personalizzare l'interpretazione dei dati di questa colonna. Questa è una stringa JSON. Per le colonne di enumerazione, usare --display"{\ "enum_values\ ":[\ "val1\ ", \ "val2\ "]}". Ci sono molte opzioni che possono entrare nella variabile di visualizzazione. Le opzioni per tipo di colonna sono: composite: composite_template, composite_sort, make_category,contains_html, use_decorations data e ora: formato_data enumerazione: enum_valori, enum_colori, uso_decorazioni int, float: numero_formato testo: is_nomi, uso_decorazioni Il modo migliore per trovare combinazioni ammesse è quello di creare una colonna personalizzata del tipo appropriato nella GUI e poi guardare l'OPF di backup per un libro (assicurarsi che sia stato creato un nuovo OPF da quando la colonna è stata aggiunta). Vedrete il JSON per il "display" per la nuova colonna nell'OPF.

--is-multiple

Questa colonna salva i tag come dati (es. valori separati da virgole). Applicato solo se il tipo di dato è testo.

custom_columns

calibredb custom_columns [options]

Elenca le colonne personalizzate disponibili. Mostra le etichette delle colonne e gli ID.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--details, -d

Mostra i dettagli per ogni colonna

remove_custom_column

calibredb remove_custom_column [opzioni] etichetta

Rimuove la colonna personalizzata identificata dall’etichetta. Puoi vedere le colonne disponibili con il comando custom_columns.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--force, -f

Non chiedere conferma

set_custom

calibredb set_custom [opzioni] colonna id valore

Imposta il valore di una colonna personalizzata per il libro identificato da id. Puoi ottenere una lista di id usando il comando search. Puoi ottenere una lista dei nomi delle colonne personalizzate usando il comando custom_columns.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--append, -a

Se la colonna salva più valori, aggiunge i valori specificati a quelli esistenti, altrimenti li sostituisce.

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.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--really-do-it, -r

Effettua realmente il ripristino. Il comando non sarà eseguito a meno che questa opzione non sia specificata.

check_library

calibredb check_library [opzioni]

Esegue alcuni controlli sul filesystem che rappresenta la biblioteca. I resoconti sono invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, malformed_formats, malformed_paths, failed_folders

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--csv, -c

Output in CSV

--ignore_extensions, -e

Elenco separato da virgole delle estensioni che devono essere ignorate. Predefinito: tutte

--ignore_names, -n

Elenco separato da virgole dei nomi da ignorare. Predefinito: tutti

--report, -r

Elenco separato da virgole dei resoconti. Predefinito: tutti

--vacuum-fts-db

Svuota il database di ricerca del testo completo. Questo può risultare molto lento e richiedere molta memoria, a seconda delle dimensioni del database.

list_categories

calibredb list_categories [options]

Crea un rapporto delle informazione sulle categorie della base di dati. Le informazioni sono equivalenti a ciò che è mostrato nel navigatore delle etichette.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--categories, -r

Elenco separato da virgole di nomi di riferimento per categorie. Predefinito: tutti

--csv, -c

Output in CSV

--dialect

Tipo di file CSV da produrre. Alternative: excel, excel-tab, unix

--item_count, -i

Visualizza solo il numero di oggetti nella categoria invece del totale per oggetto all'interno della categoria

--width, -w

La larghezza massima di una singola riga nell'output. L'impostazione predefinita è quella di rilevare la dimensione dello schermo.

backup_metadata

calibredb backup_metadata [opzioni]

Effettua il backup dei metadati presenti nel database in file OPF dedicati nella cartella di ogni libro. Normalmente questo avviene in maniera automatica ma puoi eseguire questo comando per forzare una nuova creazione dei file OPF, con l’opzione –all.

Nota che normalmente non è necessario farlo dato che il backup dei file OPF viene effettuato automaticamente ogni volta che i metadati cambiano.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--all

Di solito, questo comando opera solo su libri che hanno file OPF datati. Questa opzione lo applica a tutti i libri.

clone

calibredb clone percorso/della/nuova/biblioteca

Crea un clone della biblioteca corrente. Questo crea una nuova biblioteca, vuota, che ha tutte le stesse colonne personalizzate, biblioteche virtuali e altre impostazioni della biblioteca corrente.

La biblioteca clonata non conterrà libri. Se desideri creare un duplicato completo, che includa tutti i libri, è sufficiente usare gli strumenti del filesystem per copiare la cartella della biblioteca.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

embed_metadata

calibredb embed_metadata [opzioni] id_libro

Aggiorna i metadati dentro i file dei libri conservati nella biblioteca di calibre con i metadati del database di calibre. Normalmente i metadati sono aggiornati solo quando vengono esportati file da calibre, questo comando è utile se vuoi che i file siano aggiornati dove si trovano. Tieni presente che formati di file differenti supportano diversi livelli di metadati. Puoi usare il valore speciale “all” come id_libro per aggiornare i metadati in tutti i libri. Puoi anche specificare più id libro separati da spazi e intervalli di id separati da trattini. Per esempio: calibredb embed_metadata 1 2 10-15 23

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--only-formats, -f

Aggiorna i metadati solamente nei file del formato specificato. Specificalo più volte per più formati. Per impostazione predefinita vengono aggiornati tutti i formati.

fts_index

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

Controlla il processo di indicizzazione dei contenuti.

enable

Abilita l’indicizzazione per la Ricerca FT in questa biblioteca

disable

Disbilita l’indicizzazione per la Ricerca FT in questa biblioteca

status

Mostra lo stato di indicizzazione corrente

reindex

Può essere usato per reindicizzare libri specifici o anche l’intera biblioteca. Per reindicizzare libri specifici devi fornire i loro id come argomenti aggiuntivi dopo il il comando reindex. Se non viene specificato alcun id, l’intera biblioteca verrà reindicizzata.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

--indexing-speed

La velocità di indicizzazione. Usa rapida per fare in modo che l'indicizzazione usi tutte le risorse disponibili del computer, lenta per un'indicizzazione con meno impatto sulle risorse. Tieni presente che la velocità è riportata a lenta dopo ogni utilizzo.

--wait-for-completion

Aspetta che tutti i libri siano indicizzati, mostrando periodicamente il progresso dell'indicizzazione

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

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/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 …]

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/some path/with spaces»

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 …

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/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 …

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/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

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

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/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.

Ogni qualvolta vengono passati argomenti con degli spazi a calibredb, è necessario mettere l’argomento fra virgolette. Ad esempio: «/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