CALIBRE-DEBUG(1)                    calibre                   CALIBRE-DEBUG(1)

NAME
       calibre-debug - calibre-debug

          calibre-debug [options]

       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 -e myscript.py -- --option1 --option2 file1 file2 ...

       Everything after the -- is passed to the script. You can also use
       calibre-debug as a shebang in scripts, like this:
          #!/usr/bin/env -S calibre-debug -e -- --

       <?><?><?><?><?><?><?><?><?><?> calibre-debug
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>:
       "/some path/with spaces"

[<?><?><?><?><?>]

       --add-simple-plugin
              <?><?><?><?><?><?><?><?><?><?><?><?>py<?><?><?><?><?>path<?><?><?><?><?><?><?><?><?><?><?><?><?>(<?><?><?>.py<?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>)<?><?><?>

       --command, -c
              Python<?><?><?><?><?><?>

       --debug-device-driver, -d
              <?><?><?><?><?><?><?><?><?><?><?>

       --default-programs
              Windows <?><?><?><?><?><?><?><?><?><?><?><?>/<?><?><?><?>
              --default-programs = (register|unregister)

       --diff <?><?><?><?><?><?><?><?><?><?>: calibre-debug --diff file1 file2

       --edit-book
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>

       --exec-file, -e
              <?><?><?><?><?><?>Python<?><?><?><?><?><?>

       --explode-book, -x
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?>:
              -x file.epub output_dir
              <?><?>HTML<?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>HTML<?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>EPUB,
              AZW3, HTMLZ, DOCX <?><?><?><?><?><?><?><?>

       --export-all-calibre-data
              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. Examples:    calibre-debug --export-all-calibre-data
              # for interactive use   calibre-debug --export-all-calibre-data
              /path/to/empty/export/folder /path/to/library/folder1
              /path/to/library2   calibre-debug --export-all-calibre-data
              /export/folder all  # export all known libraries

       --fix-multiprocessing
              <?><?><?>

       --gui, -g
              GUI<?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>stdout<?>stderr<?><?><?><?><?><?><?><?>

       --gui-debug
              <?><?><?><?><?><?><?><?><?><?>GUI<?><?><?><?><?><?><?><?><?><?>path<?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>GUI<?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              -g <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>

       --help, -h
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>

       --implode-book, -i
              <?><?><?><?><?><?><?><?><?><?> <?><?><?>: -i output_dir
              file.epub :option:
              `
              --explode-book`<?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              output_dir
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>

       --import-calibre-data
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>

       --inspect-mobi, -m
              <?><?><?><?><?><?><?><?>MOBI<?><?><?><?><?><?><?>

       --paths
              calibre<?><?><?><?><?><?><?><?><?>path<?><?><?>

       --run-plugin, -r
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>:
              calibre-debug -r "Plugin name" -- file1 --option1 --
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>

       --run-test, -t
              Run the named test(s). Use the special value "all" to run all
              tests. If the test name starts with a period it is assumed to be
              a module name. If the test name starts with @ it is assumed to
              be a category name.

       --run-without-debug
              Don't run with the DEBUG flag set

       --shutdown-running-calibre, -s
              <?><?><?><?>calibre<?><?><?><?><?><?><?><?><?><?><?>:
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>

       --subset-font, -f
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              "--"
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>

       --test-build
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>

       --version
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>

       --viewer, -w
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>

AUTHOR
       Kovid Goyal

COPYRIGHT
       Kovid Goyal

7.10.0                           5<?> 03, 2024                CALIBRE-DEBUG(1)