.. _calibre-en:

.. raw:: html

    <style>code {font-size: 1em; background-color: transparent; font-family: sans-serif }</style>

``calibre``
===================================================================

.. code-block:: none

    calibre [options] [path_to_ebook or calibre url ...]


Launch the main :command:`calibre` Graphical User Interface and optionally add the e-book at
path_to_ebook to the database. You can also specify :command:`calibre` URLs to perform various
different actions, than just adding books. For example:

:command:`calibre`://view-book/test_library/1842/epub

Will open the book with id 1842 in the EPUB format from the library
"test_library" in the :command:`calibre` E-book viewer. Library names are the folder names of the
libraries with spaces replaced by underscores. A full description of the
various URL based actions is in the User Manual.


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

[options]
----------------------------------------

.. program:: calibre

.. option:: --detach

    Detach from the controlling terminal, if any (Linux only)

.. option:: --help, -h

    show this help message and exit

.. option:: --ignore-plugins

    Ignore custom plugins, useful if you installed a plugin that is preventing calibre from starting

.. option:: --no-update-check

    Do not check for updates

.. option:: --shutdown-running-calibre, -s

    Cause a running calibre instance, if any, to be shutdown. Note that if there are running jobs, they will be silently aborted, so use with care.

.. option:: --start-in-tray

    Start minimized to system tray.

.. option:: --verbose, -v

    Ignored, do not use. Present only for legacy reasons

.. option:: --version

    show program\ ``'``\ s version number and exit

.. option:: --with-library

    Use the library located at the specified path.