CALIBREDB(1)

NAME
calibredb - calibredb

    calibredb command [options] [arguments]

calibredb コマンドは、calibre データベースへのコマンドライン インターフェースです。以下に説明するように、いくつかのサブコマンドがあります。

calibredb コマンドは、パスで指定された calibre データベース、またはローカルマシン上もしくはインターネット経由で実行されている calibreコンテンツ サーバーを操作するために使用できます。calibre コンテンツ サーバー`は、:command:`calibre-server プログラムを使用するか、calibre メイン プログラムで 接続/共有 -> コンテンツ サーバーの開始 をクリックして起動できます。calibredb コマンドは calibre ライブラリに変更を加えることができるため、サーバー側で認証を設定する必要があります。これには2つの方法があります。

•   同じコンピュータ上で動作するサーバーにのみ接続する場合は、コンテンツサーバーの`--enable-local-write`オプションを使用するだけで、ローカルコンピュータ上で動作するcalibredbを含むあらゆるプログラムが、calibreデータに変更を加えることができます。メインのcalibreプログラムからサーバーを起動する場合、このオプションは 環境設定 → ネット共有 → 上級者用 にあります。ただし、一部のブラウザ、特にFirefoxでは、任意のWebサイトがローカルサーバーにアクセスできるため、注意が必要です。Firefoxを使用する場合は、下記で説明するように、ユーザー名とパスワードを設定することをお勧めします。ローカルネットワークアクセス制限は、Firefox v149の時点ではまだ実装されていません。

    ・インターネット経由でのアクセスを有効にするには、サーバー上にユーザーアカウントを設定し、calibredb コマンドに --username オプションと --password オプションを指定してアクセス権限を付与する必要があります。 calibre-server コマンドのユーザー認証は、 --enable-auth オプションと --manage-users オプションを使用して設定できます。 メインの calibre プログラムからサーバーを実行している場合は、環境設定->ネット共有->概略->コンテンツサーバーへのアクセスにユーザー名とパスワードを要求 を使用してください。

    実行中のコンテンツサーバーに接続するには、サーバーの URL を --with-library オプションに渡します。詳細と例については、このオプションのドキュメントを参照してください。

•   グローバルオプション

•   list

•   add

•   フォルダから追加

•   remove

•   add_format

•   remove_format

•   show_metadata

•   set_metadata

•   export

•   catalog

•   EPUB オプション

•   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

グローバルオプション

--help, -h
    このヘルプメッセージを表示して終了

--library-path, --with-library
    calibreライブラリへのパス。デフォルトでは、設定に保存されているパスが使用されます。calibreコンテンツサーバーに接続して、リモートライブラリに対してアクションを実行することもできます。これを行うには、<http://hostname:port/#library_id> 形式のURLを使用します（例： <http://localhost:8080/#mylibrary> ）。library_idは、コンテンツサーバー上の接続先ライブラリのライブラリIDです。library_idの特殊値として-を使用すると、サーバー上で利用可能なライブラリIDのリストを取得できます。コンテンツサーバー経由のアクセスの設定方法の詳細については、 <https://manual.calibre-ebook.com/ja/generated/ja/calibredb.html> を参照してください。

--password
    calibreコンテンツサーバ接続用パスワード。標準入力からパスワードを読み取るには、特殊文字 <stdin> を使ってください。パスワードをファイルから読み込むには <f:/path/to/file> を使ってください。 (例えば先頭の <f: に続けてファイルへのフルパスを記述し、最後に > で閉じます。) カギ括弧は必須です。使用するシェルによっては、必要に応じてエスケープしたり引用符で囲ってください。

--timeout
    ネットワーク経由でキャリバーライブラリに接続するときのタイムアウト。秒単位。デフォルトは2分です。

--username
    calibreコンテンツサーバ接続用ユーザ名

--version
    プログラムのバージョン番号を表示して終了

LIST

    calibredb list [options]

calibreデータベースに存在する本のリスト

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--ascending
    昇順に並び替え

--fields, -f
    データベース中の本の一覧を表示するときに表示するフィールド。フィールドをカンマ区切りで指定します。 指定可能なフィールド: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid デフォルト: title,authors 特殊フィールド名 "all" を指定するとすべてのフィールドを選択します。上記のビルトインフィールドの他、カスタムフィールドも *field_name として指定可能です。たとえば、カスタムフィールド #rating を表示させたいときには *rating と指定してください。

--for-machine
    JSON形式で出力します。JSONはコンピュータでの処理により適した形式です。このオプションを指定すると行幅とセパレーターオプションは無視されます。

--limit
    表示する最大結果数。デフォルトはすべて

--line-width, -w
    出力ファイル中の、1行の最大の長さ。デフォルトは画面サイズから判別。

--prefix
    すべてのファイルパスのプレフィックス。デフォルトはライブラリフォルダへの絶対パス。

--search, -s
    検索文字列で結果を絞り込む。検索文字列の形式については、ユーザマニュアルの検索関連のドキュメントを参照してください。デフォルトでは絞り込みを行いません。

--separator
    区切り文字(デフォルトは半角スペース）

--sort-by
    結果を並べ替えるフィールド。複数のフィールドを指定する場合は、カンマで区切ります。 利用可能なフィールド: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid デフォルト: id。上記の組み込みフィールドに加えて、カスタムフィールドも *field_name として使用できます。たとえば、カスタムフィールド #rating の場合は、*rating という名前を使用します。

--template
    フィールドリストに "template" が含まれている場合に実行されるテンプレート。calibreサーバーへの接続中はテンプレートは無視されることに注意してください。デフォルト: なし

--template_file, -t
    フィールドリストに "template" が含まれている場合に実行するテンプレートを含むファイルへのパス。デフォルト：なし

--template_heading
    テンプレート列の見出し。デフォルト: template。オプション --for-machine が設定されている場合、このオプションは無視されます。

ADD

    calibredb add [options] file1 file2 file3 ...

指定したファイルを本としてデータベースに追加します。フォルダを指定することもできます。参照 以下のフォルダ関連のオプション。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--authors, -a
    追加する本の著者を設定

--automerge, -m
    似たようなタイトルと著者の本が見つかった場合は、受信した形式（ファイル）を既存の本のレコードに自動的にマージします。 'ignore'の値は、重複する形式が破棄されることを意味します。 'overwrite'の値は、ライブラリ内の重複する形式が新しく追加されたファイルで上書きされることを意味します。 'new_record'の値は、重複する形式が新しいブックレコードに配置されることを意味します。

--cover, -c
    追加する本の表紙をパスで指定

--duplicates, -d
    本がすでにデータベースに存在する場合でも追加します。本のタイトルと著者に基づいて比較します。--automerge オプションが優先します。

--empty, -e
    空の本を追加する（形式が1つも無い本）

--identifier, -I
    この本の識別子を設定します。例： -I asin：XXX -I isbn：YYY

--isbn, -i
    追加する本のISBNを設定

--languages, -l
    カンマ区切りの言語のリスト(ISO639言語コードで指定するのが確実ですが、それ以外のいくつかの言語名も認識します)

--series, -s
    追加する本のシリーズを設定

--series-index, -S
    追加する本のシリーズ番号を設定

--tags, -T
    追加する本のタグを設定

--title, -t
    追加する本のタイトルを設定

  フォルダから追加

フォルダからの本の追加を制御するオプション。デフォルトでは、既知の電子書籍ファイルタイプの拡張子を持つファイルのみが追加されます。

--add
    ファイル名（glob）パターン。このパターンに一致するファイルは、既知の電子書籍ファイルタイプでなくても、フォルダーでファイルをスキャンするときに追加されます。複数のパターンに対して複数回指定できます。

--ignore
    ファイル名（glob）パターン。このパターンに一致するファイルは、フォルダーでファイルをスキャンするときに無視されます。複数のパターンに対して複数回指定できます。例：*。pdfはすべてのPDFファイルを無視します

--one-book-per-directory, -1
    フォルダ毎に一冊の本が格納され、その中のすべてのファイルはその本の別の電子書籍形式とみなす

--recurse, -r
    フォルダを再帰的に処理

REMOVE

    calibredb remove ids

idsに指定された本をデータベースから削除。idsには数字をカンマ区切りで指定します (本のIDはsearchコマンドで取得できます)。例: 23,34,57-85 (範囲で指定した場合、範囲の終端は含まれません)

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--permanent
    リサイクルゴミ箱は使用しないでください

ADD_FORMAT

    calibredb add_format [options] id ebook_file

ebook_file で指定する電子書籍ファイルを、id で指定された本の利用可能な形式として追加します。idはsearch コマンドで取得できます。形式がすでに存在する場合は、置換しないオプションを有効にした場合をのぞいて、置換されます。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--as-extra-data-file
    ファイルを電子書籍形式ではなく、本の追加データファイルとして追加してください。

--dont-replace
    形式がすでに存在する場合に置換しない

REMOVE_FORMAT

    calibredb remove_format [options] id fmt

fmt で指定した形式を id で指定した本から削除します。id は search コマンドで取得できます。fmt はLRF, TXT, EPUB のようにファイルの拡張子で指定してください。本に指定した形式がない場合、なにもしません。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

SHOW_METADATA

    calibredb show_metadata [options] id

id で指定された本の、calibreのデータベースに保存された書誌を表示します。id はsearch コマンドで取得できるID番号です。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--as-opf
    OPF 形式 (XML) で書誌を表示

SET_METADATA

    calibredb set_metadata [オプション] book_id [/path/to/metadata.opf]

calibreデータベースに保存されている、指定された本の書誌データを、OPFファイルmetadata.opfから取得します。book_idは、searchコマンドで取得した本のIDです。 show_metadataコマンドに--as-opfオプションを使用すると、OPFフォーマットの概要を簡単に確認できます。 --fieldオプションを使用すると、個々のフィールドのメタデータを設定することもできます。--fieldオプションを使用する場合は、OPFファイルを指定する必要はありません。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--field, -f
    フィールドに設定する値。field_name:value の形式で指定してください。例: --field tags:tag1,tag2。使用可能なフィールド名のリストを得るには --list-fields を使用してください。複数のフィールドの値を設定するためには、このオプションを複数指定してください。注意: 言語を指定する場合は ISO639言語コードを使用してください(英語は en、フランス語は fr 等)。識別子は以下の書式で指定してください --field identifiers:isbn:XXXX,doi:YYYYY。Boolean型(yes/no)のフィールドは、true, false またはyes, no で指定してください。

--list-fields, -l
    --field オプションで使用可能な書誌フィールド名のリストを表示

EXPORT

    calibredb export [オプション] ids

ids（カンマ区切りのリスト）で指定された本をファイルシステムにエクスポートします。 エクスポート操作では、本のすべてのフォーマット、表紙、メタデータ（OPFファイル）が保存されます。本に関連付けられた追加データファイルもすべて保存されます。 ID番号は、検索コマンドで取得できます。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--all
    IDのリストを無視してデータベースからすべての本をエクスポートします。

--dont-asciiize
    ファイル名の英語以外の文字をすべて英語相当の文字に calibre に変換させます。Unicode ファイル名を完全にサポートしていない古いファイルシステム上に保存するときに役に立ちます。 このスイッチ指定すると、この挙動をOFFにできます。

--dont-save-cover
    通常、calibreは表紙を電子書籍ファイルとは別のファイルに保存します。 このスイッチ指定すると、この挙動をOFFにできます。

--dont-save-extra-files
    本を保存する際は、本に関連付けられているデータファイルもすべて保存してください。 このスイッチ指定すると、この挙動をOFFにできます。

--dont-update-metadata
    通常、calibreはライブラリ内のファイルの書誌をアップデートしますが、これはディスクへの保存を遅くします。 このスイッチ指定すると、この挙動をOFFにできます。

--dont-write-opf
    通常、calibreは電子書籍ファイル本体に付随する別個のOPFファイルに書誌を書き込みます。 このスイッチ指定すると、この挙動をOFFにできます。

--formats
    各本を保存する時のカンマ区切りの形式のリスト。デフォルトではすべての存在する形式が保存されます。

--progress
    進捗状況を表示

--replace-whitespace
    空白をアンダースコアに置換

--single-dir
    すべての書籍を1つのフォルダにエクスポート

--template
    保存したファイルのファイル名とフォルダ構成を制御するためのテンプレート。デフォルトは "{author_sort}/{title}/{title} - {authors}" で、タイトルと著者名をファイル名に含むフォルダに著者別に保存します。利用可能なコントロール: {author_sort, authors, id, isbn, languages, last_modified, pages, pubdate, publisher, rating, series, series_index, tags, timestamp, title}

--timefmt
    日付表示時の形式。 %d - 日, %b - 月(の名前), %m - 月の番号, %Y - 年. デフォルト: %b, %Y

--to-dir
    指定したフォルダに本をエクスポートします。デフォルトは .

--to-lowercase
    パスを小文字に変換

CATALOG

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

path/to/destination の拡張子で指定される形式でカタログをエクスポートします。 出力されたカタログに表示するエントリはoptionsで制御します。 カタログの形式により、サポートするオプションが異なるので注意してください。 異なったオプションを見るには、出力ファイルの名前と、次に--help オプションを指定してください。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--ids, -i
    カタログに対するカンマ区切りのデータベースID。 宣言する場合は、:option:
    `
    --search`は無視されます。 デフォルト: all

--search, -s
    結果を検索文字列で絞り込みします。検索文字列の形式については、ユーザマニュアルの検索関連ドキュメントを参照してください。 デフォルト: 絞り込みなし

--verbose, -v
    詳細な出力情報を表示します。デバッグに便利です。

  EPUB オプション

--catalog-title
    書誌のタイトルとして使われる、生成されたカタログのタイトル。 デフォルト: 'My Books' 適用: AZW3, EPUB, MOBI出力形式

--cross-reference-authors
    複数の著者のいる本の著者セクション用にクロスリファレンスを作成。 デフォルト: 'False' 適用: AZW3, EPUB, MOBI出力形式

--debug-pipeline
    変換パイプラインからの別々のステージの出力を指定したフォルダに保存します。変換処理のどのステージで不具合が発生しているのか不明な場合に役立ちます。 デフォルト: 'None' 適用: AZW3, EPUB, MOBI 出力形式

--exclude-genre
    ジャンルとして除外するタグを表す正規表現。 デフォルト: '[.+]|^+$' はブラケットで囲まれたタグを除外します。例: '[Project Gutenberg]' と '+' は本を読むデフォルトのタグ。 適用: AZW3, EPUB, MOBI出力形式

--exclusion-rules
    生成したカタログから除外する本を指定するルール。 除外ルールはだいたい次のいずれかのようになります。 ('<rule name>','Tags','<comma-separated list of tags>') または ('<rule name>','<custom column>','<pattern>'). 使用例: (('Archived books','#status','Archived'),) 上記例では、カスタム列 'status' の値が 'Archived' の本を除外します。 ルールが複数指定されている場合には、すべて適用されます。 デフォルト: "(('Catalogs','Tags','Catalog'),)" 適用: AZW3, EPUB, MOBI出力形式

--generate-authors
    カタログに 'Authors' セクションを含める。 デフォルト: 'False' 適用: AZW3, EPUB, MOBI出力形式

--generate-descriptions
    カタログに 'Description' セクションを含める。 デフォルト: 'False' 適用: AZW3, EPUB, MOBI出力形式

--generate-genres
    カタログに 'Genres' セクションを含める。 デフォルト: 'False' 適用: AZW3, EPUB, MOBI出力形式

--generate-recently-added
    カタログに 'Recently Added' セクションを含める。 デフォルト: 'False' 適用: AZW3, EPUB, MOBI出力形式

--generate-series
    カタログにシリーズセクションを含める。 デフォルト: 'False' 適用: AZW3, EPUB, MOBI出力形式

--generate-titles
    カタログに 'Titles' セクションを含める。 デフォルト: 'False' 適用: AZW3, EPUB, MOBI出力形式

--genre-source-field
    'Genre' セクション用のソースフィールド。 デフォルト: 'タグ' 適用: AZW3, EPUB, MOBI出力形式

--header-note-source-field
    Descriptionヘッダに挿入するノートを格納したカスタムフィールド。 デフォルト: '' 適用: AZW3, EPUB, MOBI出力形式

--merge-comments-rule
    #<custom field>:[before|after]:[True|False] の形式で指定。 <custom field> コメントにマージするノートを含むカスタムフィールド [before|after] コメントに関するノートの位置 [True|False] ノートとコメントの間に水平線を挿入するかどうか デフォルト: '::' 適用: AZW3, EPUB, MOBI出力形式

--output-profile
    出力プロファイルを指定。場合により、デバイスに合わせてカタログをオプティマイズする際に出力プロファイルが必要になります。例えば、'kindle' または 'kindle_dx' は、セクションと記事からなる構造化された目次を精製します。 デフォルト: 'None' 適用: AZW3, EPUB, MOBI出力形式

--prefix-rules
    既読本を示すプレフィックスや、ウィッシュリスト、その他ユーザ指定のプレフィックスを含めるために使用するルールを指定。 プレフィックスルールは ('<rule name>','<source field>','<pattern>','<prefix>') のように指定します。 複数のルールが指定されている場合には、最初に一致したルールが使用されます。 デフォルト: '(('Read books','tags','+','✓'),('Wishlist item','tags','Wishlist','×'))' 適用: AZW3, EPUB, MOBI出力形式

--preset
    GUIカタログビルダーで作成された名前付きプリセットを使用。 カタログ作成のすべての設定を指定するためのプリセットです。 デフォルト: 'None' 適用: AZW3, EPUB, MOBI出力形式

--thumb-width
    カタログ中の本の表紙のサイズのヒント (インチ指定) 範囲: 1.0 - 2.0 デフォルト: '1.0' 適用: AZW3, EPUB, MOBI出力形式

--use-existing-cover
    カタログ生成時に既存の表紙を上書き。 デフォルト: 'False' 適用: AZW3, EPUB, MOBI出力形式

SAVED_SEARCHES

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

データベースに格納された保存済み検索の管理。 既存の名称で検索条件を保存しようとした場合には、上書きされます。

追加の構文:

calibredb saved_searches add search_name search_expression

削除の構文:

calibredb saved_searches remove search_name

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

ADD_CUSTOM_COLUMN

    calibredb add_custom_column [options] label name datatype

カスタム列を作成。labelはマシン・フレンドリな列の名前。スペースやコロンを含めません。 nameは人間に読みやすい列の名前。 datatypeは以下のいずれか: bool, comments, composite, datetime, enumeration, float, int, rating, series, text

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--display
    列のデータがどのように翻訳されるかをカスタマイズする辞書を指定するオプションです。JSON文字列で指定します。列挙型の列の場合、以下を使用してください:option:--display"{\ "enum_values\ ":[\ "val1\ ", \ "val2\ "]}" 。 値の表示方法には、様々なオプションがあります。列の型ごとのオプションは以下の通りです。 合成型: composite_template, composite_sort, make_category,contains_html, use_decorations 日付: date_format 列挙型: enum_values, enum_colors, use_decorations 整数、浮動小数点数: number_format テキスト: is_names, use_decorations 型とオプションの正しい組み合わせを知るには、GUIから適切な型のカスタム列を作成して、出力されるバックアップのOPFファイルを見てみるのが一番よい方法です(列を追加して以降にOPFが再生成されていることを確認してください)。OPFの新しい列に "display" というJSONが見つかるでしょう。

--is-multiple
    この列はタグ状のデータ（例: 複数のカンマ区切りの値）を保持します。datatypeがtextの時のみ有効です。

CUSTOM_COLUMNS

    calibredb custom_columns [options]

利用可能なカスタム列の一覧を表示。列ラベルとIDを表示します。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--details, -d
    各列の詳細を表示

REMOVE_CUSTOM_COLUMN

    calibredb remove_custom_column [options] label

labelで指定されるカスタム列を削除。 custom_columns コマンドで存在するカスタム列を見ることができます。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--force, -f
    確認を表示しない

SET_CUSTOM

    calibredb set_custom [options] column id value

idで指定された本のカスタム列の値を設定します。 search コマンドでIDのリストが取得できます。 custom_columns コマンドでカスタム列の名前のリストが取得できます。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--append, -a
    もし列に複数の値を設定できる場合、値を指定した値に入れ替えるのではなく、すでにある値に付け加えます。

RESTORE_DATABASE

    calibredb restore_database [options]

calibreライブラリの各ディレクトリに保存されている OPF ファイルから書誌を読み取り、データベースを復元します。 これはmetadata.dbファイルが壊れてしまった時に有用です。

注意: このコマンドを実行すると、データベースを完全に再生成します。すべての保存済み検索、ユーザカテゴリ、書誌プラグボード、書誌ごとの変換設定、カスタムレシピは失われます。復元される書誌は、OPFファイルの内容と同等となります。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--really-do-it, -r
    実際にリカバリーを行います。このコマンドはこのオプションを指定しなければ実行されません。

CHECK_LIBRARY

    calibredb check_library [options]

ライブラリのあるファイルシステムをチェックします。レポート：invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, malformed_formats, malformed_paths, failed_folders

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--csv, -c
    CSVで出力

--ignore_extensions, -e
    無視する拡張子(カンマ区切りのリスト) デフォルト: all

--ignore_names, -n
    無視する名前のカンマ区切りのリスト デフォルト: all

--report, -r
    カンマ区切りのレポートのリスト デフォルト: all

--vacuum-fts-db
    全文検索データベースより抽出を行います。この操作はデータベースのサイズによっては非常に遅くなり、またメモリーを消費する場合があります。

LIST_CATEGORIES

    calibredb list_categories [options]

データベース中のカテゴリ情報のレポートを作成します。情報はタグブラウザに表示されるものと同等です。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--categories, -r
    カンマ区切りのカテゴリのルックアップ名のリスト。デフォルト: all

--csv, -c
    CSVで出力

--dialect
    DSVファイルのタイプ。選択肢: excel, excel-tab, unix

--item_count, -i
    カテゴリ内の項目別の数ではなく、カテゴリにある項目数のみを出力します。

--width, -w
    出力ファイル中の、1行の最大の長さ。デフォルトは画面サイズから判別。

BACKUP_METADATA

    calibredb backup_metadata [options]

データベースに格納されている書誌を、本フォルダにある個別の OPF ファイルに バックアップします。通常は自動的に行われますが、--all オプションをつけてコマンドを 実行すれば、OPF ファイルを強制的に再生成することができます。

ただし普通はこれを行う必要はありません。OPF ファイルは書誌が変更されるたびに 自動的にバックアップされるからです。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--all
    通常このコマンドは、古くなったOPFファイルに対してのみ実行されます。このオプションを指定すると、すべての本に対して実行されます。

CLONE

    calibredb clone path/to/new/library

現在のライブラリの複製を作成します。現在のライブラリと 列、仮想ライブラリ、その他の設定が同じである、新しい空の ライブラリが作成されます。

複製されたライブラリに本は含まれません。すべての本を含む複製を 作成したい場合には、単にライブラリのフォルダをコピーしてください。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

EMBED_METADATA

    calibredb embed_metadata [options] book_id

calibreライブラリ内に保存されている電子書籍ファイルの書誌を calibreデータベースの書誌で更新します。 通常、電子書籍ファイルの書誌の更新は、エクスポート時のみ 行われますが、このコマンドはすぐに更新を行いたい場合に便利です。 ファイル形式毎にサポートする書誌のフィールドが 異なることに留意ください。 book_id に特別な値 'all' を指定すると、すべての本が更新されます。 また、スペース区切りで複数のidを指定すること、ハイフン区切りで 範囲を指定することができます。 例: calibredb embed_metadata 1 2 10-15 23

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--only-formats, -f
    指定した形式のファイルのみ書誌を更新します。複数の形式を指定する場合は、オプションを複数回指定してください。デフォルトでは、すべての形式が更新されます。

SEARCH

    calibredb search [options] search expression

検索条件を指定してライブラリを検索し、結果を本のIDのカンマ区切りリストで返します。出力された結果は、本のIDを引数にとる他のコマンドの入力として使用するのに便利です。以下のようにcalibreの強力な検索用言語が使用できます。例: calibredb search author:asimov 'title:"i robot"'

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--limit, -l
    返却する最大結果数。デフォルトはすべての結果。

FTS_INDEX

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

全文検索用インデックス生成処理の設定

enable
    このライブラリーの FTS インデックスを有効にする

disable
    このライブラリーの FTS インデックスを無効にする

status
    現在のインデックス化状態を表示

reindex
    特定のブックまたはライブラリー全体の再インデックス化を行えます。特定ブックの再インデックス化の場合はブックのidを reindex コマンドの後ろに引数として付けてください。ブックid が指定されない場合はライブラリー全体が再インデックス化されます。

    スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--indexing-speed
    インデックス化の速度。高速なインデックス化には fast を選択し、コンピュータのリソースを最大限に活用します。低リソースでのインデックス作成には slow を選択します。なお、速度は実行ごとに slow にリセットされます。

--wait-for-completion
    全てのブックのインデックス生成までお待ちください。インデックス化の進捗は定期的に表示されます

FTS_SEARCH

    calibredb fts_search [オプション] 検索式

ライブラリ全体またはその一部に対して全文検索を実行します。

スペースを含む引数を calibredb に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

--do-not-match-on-related-words
    完全一致のみで、関連語は一致しません。そのため、修正内容は修正対象と一致しません。

--include-snippets
    一致させる箇所回りの文字列のスニペットを含めてください。ただし、これにより検索速度が大幅に低下することに注意してください。

--indexing-threshold
    検索を許可する前に、ライブラリのどのくらいの割合をインデックス化する必要があるか（パーセンテージ）。デフォルト値は90です。

--match-end-marker
    スニペット内の一致する単語の終了を示すために使用されるマーカー

--match-start-marker
    スニペット内の一致する単語の開始を示すために使用されるマーカー

--output-format
    検索結果の出力形式。プレーンテキストの場合は "text"、JSON形式の場合は "json" を指定します。

--restrict-to
    検索式またはIDを使用して、検索対象の本を絞り込むことができます。例えば、ids:1,2,3 と指定するとIDで絞り込み、search:tag:foo と指定するとタグfooを持つ本に絞り込みます。

Author
Kovid Goyal

Copyright
Kovid Goyal