Scroll to navigation



calibre-debug - calibre-debug

calibre-debug [選項]

Various command line interfaces useful for debugging calibre. With no options, this command starts an embedded Python interpreter. You can also run the main calibre GUI, the calibre E-book viewer and the calibre editor in debug mode.

It also contains interfaces to various bits of calibre that do not have dedicated command line tools, such as font subsetting, the E-book diff tool and so on.

You can also use calibre-debug to run standalone scripts. To do that use it like this:

calibre-debug -- --option1 --option2 file1 file2 ...

Everything after the -- is passed to the script.

Whenever you pass arguments to calibre-debug that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"


藉由指定包含外掛代碼的 py 檔案路徑,來加入簡單外掛(即只由一個 .py 檔案組成的外掛)

--command, -c
執行 Python 程式碼

--debug-device-driver, -d

從 Windows 預設程式註冊 / 註銷 calibre。 --default-programs = (register|unregister)

執行calibre diff工具。例如: calibre-debug --diff file1 file2

--edit-book, -t

--exec-file, -e
執行存有 Python 程式碼的檔案

--explode-book, -x
Explode the book into the specified folder. Usage: -x file.epub output_dir Exports the book as a collection of HTML files and metadata, which you can edit using standard HTML editing tools. Works with EPUB, AZW3, HTMLZ and DOCX files.

Export all calibre data (books/settings/plugins). Normally, you will be asked for the export folder and the libraries to export. You can also specify them as command line arguments to skip the questions. Use absolute paths for the export folder and libraries. The special keyword "all" can be used to export all libraries.

For internal use

--gui, -g
開啟偵錯模式介面。Debug將輸出至 stdout 與 stderr 。

以偵錯主控台啟動GUI,並將記錄日誌寫入到指定路徑,僅供內部使用,使用 -g選項啟動以偵錯主控台啟動GUI。

--help, -h

--implode-book, -i
Implode a previously exploded book. Usage: -i output_dir file.epub Imports the book from the files in output_dir which must have been created by a previous call to --explode-book. Be sure to specify the same file type as was used when exploding.


--inspect-mobi, -m
查看指定目錄的 MOBI 檔案

設定 calibre 環境時輸出路徑是必需的

將指定路徑的calibre SQLite 資料庫重新初始化,這對資料庫損毀有所幫助。

--run-plugin, -r
執行一個提供命令行介面的外掛。例如: calibre-debug -r "Add Books" -- file1 --option1-- 後方的內容將被當作參數傳遞給外掛。

--shutdown-running-calibre, -s
原因是有執行中的 calibre 實體,如果有,應該將它關閉,注意如果有任何執行中的工作,它們會被直接中止,因此請小心使用。

--subset-font, -f



--viewer, -w


Kovid Goyal


Kovid Goyal
4月 19, 2021 5.16.1