[davidfor]

Before using the driver, you need to configure it. The following is how to do this and what the options mean.

1. Open the driver configuration dialog by either:
   • If the device is not connected:
     1. Open the preferences in calibre.
     2. Click the "Plugins" button in the advanced section.
     3. Find the driver in the list and select it.
     4. Press the "Customize plugin" button
   • If the device is connected:
     1. Click the down arrow next to the device button
     2. Select "Configure this device"
2. With the "Configure Kobo Touch" dialog open, you can set the options you want to use.
   1. The top section, down to the "Save template", of the driver is the same as the old driver. These can be left at the default, or the options copied from the configuration of the old driver if you changed it.
   2. The first field below this, is where to specify columns to be used for bookshelves. More than one column can be entered separated by a comma. If a custom column is used, the lookup name needs to be entered with a hash (#). Some columns that can be used are:
      1. A custom tag type column. This will have a lookup name something like "#bookshelves".
      2. The series column. If this is used, a shelf will be created for each series that is put onto the Touch. This is specified with the lookup name "series".
      3. A text column with a single name.
      4. The calibre tags column. The lookup name for this is "tags".
      5. If the custom column above and the series column are used, this will be entered as "#bookshelves, series".
   3. Check or uncheck the other options as you desire. The options are:
      • Create Bookshelves. Select this if you want new shelves to be created on the Touch if they do not already exist. Do not select this if you want to maintain the shelf list only on the Touch itself.
      • Delete Empty Bookshelves. Select this if you want empty bookshelves to be deleted from the Touch. To use this, you must have selected the above option.
      • Upload covers for books. If you want the driver to generate covers for the books and put them on the Touch. Normally, the KOBO readers create the cover image from the ebook file itself. With this option, calibre will send a separate cover image to the reader. This is useful if you have modified the cover without putting into the book. With only this option selected, the covers are only copied if the covers already exist on the Touch.
      • Upload Black and White Covers. If uploading covers, they will be converted to black and white.
      • Always upload covers. This extends the cover uploading to upload them even if they do not exist on the Touch.
      • Keep cover aspect ratio. When sending covers to the device, they are sized to fit on the device. This option keeps the aspect ratio of the book so they don't get stretched. Firmware 2.3.1 and later will display these covers undistorted.
      • Show archived books. Purchased kepubs can be archived to remove the actual book file from the device. Check this option to show these books in the device list. If they match books in the library, the library will show the book as on the device.
      • Show Previews. Kobo previews are included on the Touch. Enable if you wish to see or delete them.
      • Show Recommendations. Kobo now shows recommendations on the device. In some case these have files but in other cases they are just pointers to the web site to buy. Enable if you wish to see or delete them.
      • Set Series information. With firmware 2.2.0, the devices support series! When this option is enabled, the driver will check the series information and update any that has changed. Warning: The first time this is enabled, the device will be updated with series information for all books that have it. If the device has a lot of books, this could take some time.
      • Modify CSS. Modify the stylesheets in ePubs when they are sent to the device. Reads CSS rules from the file "kobo_extra.css" in the root directory of the device. See this post for details.
      • Attempt to support newer firmware. Kobo routinely updates the firmware and the database version. With this option Calibre will attempt to perform full read-write functionality. The driver supports the current firmware version, so this can be left unchecked.
   4. The last option is Title to test when debugging. This is used by the driver developer to help debug problems. Ignore this option unless asked.
3. Once the configuration is how you want it, press the OK button to save the changes. If the Kobo device is connected, you will be prompted to restart calibre for the changes to take effect.
   
4. Other preferences to that might need to changed:
   • Metadata management. This is on "Sending books to devices" page of the preferences. The options are described on the page, but for this driver, the options mean:
     • Manual management - Displays book state including current shelves in the device list when the device is connected. Only changes shelves when a book is sent to the device. Never deletes a shelf even if the option is chosen on the driver configuration.
     • Only on send - Displays book state including current shelf state in device list when device is connected. Only changes shelves when a book is sent to the device.
     • Automatic management - When the device is connected, the current shelves and series information will be updated on the device based on the calibre library and the driver options. After the shelves are updated, any empty shelves will be deleted if that option is chosen on the driver configuration.
   • Metadata plugboard. If you are using a metadata plugboard with the current driver, you will need to create a copy of this for the new driver. As the most common plugboard is to add the series information to the title of the books, if this is not done, books already on the device might not be matched correctly with the library.