The Graphical User Interface

The Graphical User Interface (GUI) provides access to all library management and ebook format conversion features. The basic workflow for using calibre is to first add books to the library from your hard disk. calibre will automatically try to read metadata from the books and add them to its internal database. Once they are in the database, you can performa various Actions on them that include conversion from one format to another, transfer to the reading device, viewing on your computer, editing metadata, including covers, etc.

The interface is divided into various sections:

Actions

The actions toolbar provides convenient shortcuts to commonly used actions. Most of the action buttons have little arrows next to them. By clicking the arrows, you can perform variations on the default action.

Add books

The Add books action has three variations, accessed by the arrow next to the button.

1. Add books from a single directory: Opens a file chooser dialog and allows you to specify which books in a directory should be added. This action is context sensitive, i.e. it depends on which catalog you have selected. If you have selected the Library, books will be added to the library. If you have selected the ebook reader device, the books will be uploaded to the device, and so on.
2. Add books recursively (One book per directory): Allows you to choose a directory. The directory and all its sub-directories are scanned recursively and any ebooks found are added to the library.The algorithm assumes that each directory contains a single book. All ebook files in a directory are assumedto be the same book in different formats. This action is the inverse of the Save to disk action, i.e. you can Save to disk, delete the books and re-add them with no lost information (except date).
3. Add books recursively (Multiple books per directory): Allows you to choose a directory. The directory and all its sub-directories are scanned recursively and any ebooks found are added to the library.The algorithm assumes that each directory contains many books. All ebook files with the same name in a directory are assumed to be the same book in different formats. This action is the inverse of the Save to disk action, i.e. you can Save to disk, delete the books and re-add them with no lost information (except date).

The Add books action can read metadata from the following ebook formats: LRF, EPUB, LIT, MOBI, RTF, PDF, PRC, HTML. In addition it tries to guess metadata from the filename. See the Guessing metadata from file names section, to learn how to configure this.

To add a new format to an existing book, use the Edit meta information action.

Remove books

The Remove books action deletes books permanently, so use it with care. It is context sensitive, i.e. it depends on which catalog you have selected. If you have selected the Library, books will be removed from the library. If you have selected the ebook reader device, the books will be removed from the device. To remove only a particular format for a given book use the Edit meta information action.

Edit meta information

The Edit meta information action has two variations, accessed by the arrow next to the button.

1. Edit metadata individually: This allows you to edit the metadata of books one-by-one, with the option of fetching metadata, including covers from the internet. It also allows you to add/remove particular ebook formats from a book. For more detail see Editing E-book Metadata.
2. Edit metadata in bulk: This allows you to edit common metadata fields for large numbers of books simulataneously. It operates on all the books you have selected in the Library view.

Send to device

The Send to device action has two variations, accessed by the arrow next to the button.

1. Send to main memory: The selected books are transferred to the main memory of the ebook reader.
2. Send to card: The selected books are transferred to the storage card on the ebook reader.

Save to disk

The Save to disk action has two variations, accessed by the arrow next to the button.

1. Save to disk: This will save the selected books to disk organized in directories. The directory structure looks like:

   Author
       Title
           Book Files

2. Save to disk in a single directory: The selected books are saved to disk in a single directory.

All available formats as well as metadata is stored to disk for each selected book. Metadata is stored in an OPF file.

Saved books can be re-imported to the library without any loss of information by using the Add books action.

Fetch news

The Fetch news action downloads news from various websites and converts it into an ebook that can be read on your ebook reader. Normally, the newly created ebook is added to your ebook library, but if an ebook reader is connected at the time the download finishes, the news is uploaded to the reader directly.

The Fetch news action uses simple recipes (10-15 lines of code) for each news site. To learn how to create recipes for your own news sources, see Adding your favorite news website.

Convert e-books

Ebooks can be converted from a number of formats into the LRF format (for the SONY Reader). Note that ebooks you purchase will typically have Digital Rights Management (DRM). calibre will not convert these ebooks. For many DRM formats, it is easy to remove the DRM, but as this is illegal, you have to find tools to liberate your books yourself and then use calibre to convert them.

For most people, conversion should be a simple 1-click affair. But if you want to learn more about the conversion process, see E-book Conversion.

The Convert E-books action has three variations, accessed by the arrow next to the button.

1. Convert individually: This will allow you to specify conversion options to customize the conversion of each selected ebook.
2. Bulk convert: This allows you to specify options only once to convert a number of ebooks in bulk.
3. Set conversion defaults: Allows you to set the default settings for future conversions.

View

The View action displays the book in an ebook viewer program. calibre has a builtin viewer for the LRF format. For other formats it uses the default operating system application. If a book has more than one format, you can view a particular format by clicking the arrow next to the View button.

Catalogs

A catalog is a collection of books. calibre can manage three different catalogs:

1. Library: This is a collection of books stored in a database file on your computers harddisk.
2. Reader: This is a collection of books stored in the main memory of your ebook reader. It will be available when you connect the reader to your computer.
3. Card: This is a collection of books stored on the storage card in your reader. Note that ${app} supports only a single storage card at a time.

Search & Sort

The Search & Sort section allows you to perform several powerful actions on your book collections.

• You can sort them by title, author, date, rating etc. by clicking on the column titles.

• You can search for a particular book or set of books using the search bar. More on that below.

• You can quickly and conveniently edit metadata by double-clicking the entry you want changed in the list.

• You can perform Actions on sets to books. To select multiple books you can either:

  • Keep the Ctrl key pressed and click on the books you want selected.
  • Keep the Shift key pressed and click on the starting and ending book of arange of books you want selected.

• You can configure which fields you want displayed by using the Configuration dialog.

The Search Interface

You can search all the metadata by entering search terms in the search bar. Searches are case insensitive. For example:

Asimov Foundation format:lrf

This will match all books in your library that have Asimov and Foundation in their metadata and are available in the LRF format. You can build advanced search queries easily using the Advanced Search Dialog, accessed by clicking the button .

Advanced Search Dialog

You can search on individual fields as shown. The “Negate” checkbox implies that only results that do not match the search expression will be returned. You can require all the search criteria to match or any of them.

Configuration

The configuration dialog allows you to set some global defaults used by all of calibre. To access it, click the .

Guessing metadata from file names

In the Advanced section of the configuration dialog, you can specify a regularexpression that calibre will use to try and guess metadata from the names of ebook files that you add to the library. The default regular expression is:

title - author

i.e., it will assumes that all character up to the first - are the title of the book and subsequent characters are the author of the book. For example, the filename:

Foundation and Earth - Isaac Asimov.txt

will be interpreted to have the title: Foundation and Earth and author: Isaac Asimov

Tip

If the filename does not contain the hyphen, the regular expression will fail.

Book Details

The Book Details display shows you extra information and the cover for the currently selected book. THe comments section is truncated if the comments are too long. To see the full comments as well as a larger image of the cover, click anywhere in the Book Details area.

Jobs

The Jobs panel shows you the number of currently running jobs. Jobs are tasks that run in a separate process, they include converting ebooks and talking to your reader device. You can click on the jobs panel to access the list of jobs. Once a job has completed, by double-clicking it in the list, you can see a detailed log from that job. This is useful to debug jobs that may not have completed successfully.