Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Software > Calibre > Devices

Notices

Closed Thread
 
Thread Tools Search this Thread
Old 01-26-2011, 04:10 PM   #1
GRiker
Comparer of the Ephemeris
GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.
 
Posts: 1,496
Karma: 424697
Join Date: Mar 2009
Device: iPad
Calibre + Apple iDevices: Start here

Calibre supports sending books to iTunes/iDevices in OSX and Windows. This thread contains in-depth information about sending books from calibre to iTunes.

To send books directly to supported iOS reader applications such as GoodReader, iBooks and Marvin, refer to the iOS reader applications plugin.

To disable iDevice recognition in calibre:
Spoiler:
If your regular Reader is a device other than an iDevice (Sony, Kindle, Nook, etc) and you routinely connect an iPhone to your computer to charge or sync it with iTunes, you will want to disable your iDevice in calibre. In Preferences|Advanced|Plugins|Device Interface plugins select the Apple device interface plugin. Click the Enable/Disable button so that the icon is grayed out, then restart calibre.

There are multiple iOS reader applications capable of opening epubs directly from a website (e.g. Dropbox) or from an email attachment. In Safari, navigate to the online location of the epub, or email yourself a copy of the epub, then click on the attached epub in the mail program. Here are a few of the iOS reader applications known to support the 'Open in' functionality at this time:
  • Bluefire Reader
  • iBooks
  • Kobo
  • Marvin
  • Stanza

You can also use calibre's content server feature to open books in iBooks, bypassing iTunes. See the content server section of the calibre manual.

Additionally, there are other methods to wirelessly transfer books to third-party ereader apps. Some of these methods are:
The rest of this post describes how to transfer books from calibre to iTunes using a USB cable.

Important incompatability note for OS X 10.9 (Mavericks) users:
Spoiler:
As of OS X 10.9 (Mavericks), iTunes no longer manages ebooks for iDevices. As a result, you will not be able to transfer books from calibre to iTunes or iBooks under Mavericks via USB. At this time, it is not known if or when a fix might be available.
You can use calibre's content server feature under Mavericks to open books in iBooks on your iDevice.


If you have recently updated your version of iTunes, it is important to let iTunes update its database before connecting to it with calibre. Start iTunes, then wait until it has completed any housekeeping before starting calibre.

Quick start: 'Connect to iTunes' mode (updated as of version 0.8.8)
  1. Launch iTunes with no connected iDevices.
  2. In iTunes Preferences|Advanced, select an option for Copy files to iTunes Media folder when adding to library. If you already have existing content in iTunes (music, videos, etc), you should keep your current setting.
    • Checked: iTunes will make copies of transferred books to your iTunes Media folder.
    • Unchecked: iTunes will reference a copy of the transferred book in your calibre configuration directory.
    Make a note of this setting, as you will need it in the next step.
  3. Launch calibre, set Preferences:
    • Preferences|Behavior|Preferred output format to EPUB
    • Preferences|Conversion|common options|page setup|Output profile to iPad
    • With the Apple iTunes interface selected, click Customize plugin. Set 'Copy files to iTunes Media folder…' is enabled in iTunes Advanced|Preferences to match the setting of the similar option in the iTunes Preferences|Advanced dialog step above. If the option is checked in both dialogs, iTunes will make copies of transferred books in your iTunes Media folder. If the option is unchecked in both dialogs, copies will be made in your calibre configuration directory. Regardless of your choice, both options should be set the same.
    • Enable the formats you want to transfer to iTunes. iBooks supports both epub and pdf formats.
  4. Restart calibre.
  5. Select Connect/ShareConnect to iTunes to connect iTunes as a Reader device.
  6. To send epubs or PDFs from calibre to iTunes:
    • Select the book(s) to send from your calibre Library window, then click Send to device. Your books are added to the 'Books' playlist in your iTunes library.
  7. To use Fetch news to download periodicals from the Internet:
    • Preferences|Interface|Automatically send downloaded news to ebook reader:
      Recommendation: checked
    • Preferences|Interface|Delete news from library when it is automatically sent to reader:
      Recommendation: unchecked
    • Click Fetch news, select the recipe you wish to download, click Download now. Repeat for other recipes, then click Save to exit the Schedule news download dialog.
    • To learn more about iPad-optimized periodicals, see 'iPad + Recipes: New optimizations in 0.7.5'.
  8. When you're ready to sync your iDevice with iTunes:
    • Connect your iDevice to your computer
    • Sync your iDevice with iTunes as you normally would.
    • If you manually manage songs and videos in iTunes, you can simply drag books from the Library|Books list to your iDevice.
Options
Spoiler:
Configuration options are accessed in Preferences|Plugins|Device Interface plugins|Apple device interface, then clicking Customize plugin.
  • Select available formats and their order for this device: If you have both an epub and pdf file, the order of these formats in this list determines which will be sent to iTunes when clicking Send to device. If you want to send a particular format, use Send to device↓Send specific format.
  • Use Series as Category in iTunes/iBooks: If checked, the Series name from the book's metadata will be used as the Genre in iTunes. If no Series name exists, the first tag will be used as the Genre. If unchecked, the first tag will be used as the Genre.
  • Cache covers from iTunes/iBooks: If checked, calibre will read cover images from iTunes and display them in the Book Details section of the Reader pane. Calibre caches cover images to improve performance. If you have a very large library and simply want to load as fast as possible, uncheck this option.
  • 'Copy files to iTunes Media folder…' is enabled in iTunes Preferences|Advanced: This setting should match your iTunes Preferences|Advanced setting. Disabling will store copies of books transferred to iTunes in your calibre configuration directory. Enabling indicates that iTunes is configured to store copies in your iTunes Media folder. (Option added in version 0.8.8)

Metadata Mapping and Plugboard Transformations
Spoiler:
Calibre sends eBooks to iTunes/iBooks with its best effort to apply the book's metadata as it exists in the calibre database. The relationship between calibre metadata and iTunes metadata is not exact. Metadata items listed as 'tweakable' may be transformed via a plugboard. Plugboard transformations are discussed below.

Calibre metadata may be viewed in calibre's Edit Meta information dialog, invoked by clicking the 'i' icon or pressing the 'E' key.

iTunes metadata may be viewed in iTunes' Get Info dialog. iBooks metadata is implicit in the Library list view, where books may be sorted by Titles, Authors, or Categories.
  • Title
    • calibre: Title
    • iTunes: Name, Album
    • iBooks: Title
    • tweakable: Yes
    • See Title transformations below for an example of prepending Series information to Title when displayed in iTunes/iBooks.
  • Sort Title
    • calibre: title_sort (by default, not visible in UI**)
    • iTunes: Sort Name, Sort Album
    • iBooks: Sort Title
    • tweakable: Yes
    • The algorithm generating Sort Title looks for opening articles 'A', 'An' or 'The', moving them to the end of the title. E.g., 'The Man Who Loved Books Too Much' becomes 'Man Who Loved Books Too Much, The'
  • Author
    • calibre: Author(s)
    • iTunes: Artist
    • iBooks: Author
    • tweakable: Yes
    • See Display Authors as LN, FN in iTunes/iBooks below for an example of using Author Sort in place of Author.
  • Author Sort
    • calibre: Author Sort
    • iTunes: Sort Artist
    • iBooks: Sort Author
    • tweakable: Yes
  • Publisher
    • calibre: Publisher
    • iTunes: n/a
    • iBooks: n/a
    • tweakable: No
    • Plugboard transforms to 'publisher' are ignored.
  • Date of Publication
    • calibre: Published
    • iTunes: Release Date, Year
    • iBooks: n/a
    • tweakable: No
    • iTunes extracts Release Date field from <dc:date> in the ePub's OPF file. Calibre writes iTunes' Year field from calibre's Published field.
  • Tags
    • calibre: Tags
    • iTunes: Genre
    • iBooks: Category
    • tweakable: Yes
    • The first tag beginning with an alphabetic character is used as the iTunes Genre / iBooks Category. If no tags, the first <dc:subject> from the ePub's OPF file is used. See Using a custom column as Genre/Category below for an example of directly specifying Genre/Category for iTunes/iBooks.
  • Series Information
    • calibre: Series/series_index
    • iTunes: Sort Name, Genre, Episode ID, Episode Number
    • iBooks: Sort Title, Category
    • tweakable: Yes
    • If a book has series information AND Preferences|Advanced|Plugins|Device Interface Plugins|Apple device interface|Customize plugin|Use Series as Category in iTunes/iBooks is checked, the Sort Title is generated from the Series/series_index, and the Category/Genre is set to the Series name. Series and series_index are passed as Episode ID and Episode Number.
      N.B.: Tag transformations override using Series as Category/Genre.
  • Comments
    • calibre: Comments
    • iTunes: Comments
    • iBooks: n/a
    • tweakable: No
    • Comments are clipped at 255 characters by the iTunes automation interface. Longer comments may be added manually. Comments are not visible in iBooks.
  • Language
    • calibre: language (not visible in UI)
    • iTunes: added to ePub's OPF file
    • iBooks: added to ePub's OPF file
    • tweakable: Yes
    • Plugboard transforms to 'language' are added to the ePub's OPF file as <dc:language>.
  • UUID
    • calibre: uuid (by default, not visible in UI**)
    • iTunes: Composer
    • iBooks: Composer
    • tweakable: No
    • The uuid is used to correlate books between the calibre library and the iTunes database. Its use allows the metadata attributes to be different while still allowing the book to be recognized as the same.
  • Description
    • calibre: n/a
    • iTunes: Description
    • iBooks: Description
    • tweakable: No
    • A comment is added to iTunes/iBooks of the form 'added by calibre 2010-10-05 11:41:31'.
    ** Metadata values not visible in the UI by default may be shown in a custom column by creating a composite column. See 'Using functions in templates' in the calibre user manual for more details.

Transforming metadata using calibre's Metadata plugboard feature
Added in 0.7.21, plugboards offer users the opportunity to transform metadata as an eBook is saved to disk or sent to a device. This discussion focuses exclusively on plugboarding with iTunes/iBooks. Plugboard support for iTunes/iBooks was added in 0.7.23.
  • Title transformations
    A common use of plugboards is transforming a book's title when it is part of a series. For example, consider 'The Girl with the Dragon Tattoo' by Stieg Larsson, book 1 of the Millenium series. By default, iBooks would list it as simply 'The Girl with the Dragon Tattoo'.

    To have the book listed in iTunes/iBooks as 'Millenium 1: The Girl with the Dragon Tattoo':
    • Open the Metadata plugboards dialog - Preferences|Import/Export|Metadata plugboards.
    • Select any format, epub or pdf from the Format dropdown list, then APPLE from the Device dropdown list.
    • In the Source template field, add this template:
      Code:
      {series}{series_index:| |: }{title}
      This tells the templating engine "If there is a series_index for the book, prepend the series name, a space, the series_index, then a colon and a space before the book's title."
    • Select title from the Destination field dropdown list.
    • Click the Save plugboard button, then Apply (upper left corner of the dialog) to save and close.
    • All books matching the specified formats sent to iTunes/iBooks will have this plugboard transform applied.
  • Using a custom column as Genre/Category
    Creating a custom 'Genre' column is useful when you want exact control of the Genre/Category applied in iTunes/iBooks:
    • In Preferences|Interface|Add your own columns, click the Add custom column button. In the Lookup name field, type genre. In the Column heading field, type Genre (or 'iBooks Category', or whatever you please). In Column type, select Text, column shown in the tag browser. Click OK to exit the dialog. Restart calibre.
    • Populate your new custom column with the Genre/Category names to be used with iTunes/iBooks.
    • Open the Metadata plugboards dialog - Preferences|Import/Export|Metadata plugboards.
    • If you already have an existing plugboard for APPLE, select it in the Existing plugboards list, otherwise follow the steps described in the first example to create a new plugboard.
    • In the Source template field, add this template:
      Code:
      {#genre}
      In the Destination field, select tags. This tells the templating engine "Retrieve the value stored in the custom column whose lookup name is 'genre', and apply it to the tags field."
    • Click the Save plugboard button, then Apply (upper left corner of the dialog) to save and close.
    • All books matching the specified formats sent to iTunes/iBooks will have this plugboard transform applied.
    In the event that Preferences|Advanced|Plugins|Device Interface Plugins|Apple device interface|Customize plugin|Use Series as Category in iTunes/iBooks is checked, the normal behavior is to use the Series name as the Genre/Category in iTunes/iBooks. However, if a plugboard transform is defined for tags, it takes priority over using the Series name.
  • Display Authors as LN, FN in iTunes/iBooks
    • If you already have an existing plugboard for APPLE, select it in the Existing plugboards list, otherwise follow the steps described in the first example to create a new plugboard.
    • In the Source template field, add this template:
      Code:
      {author_sort}
      In the Destination field, select authors. This tells the templating engine "Retrieve the authors_sort value, and apply it to the authors field."
    • Click the Save plugboard button, then Apply (upper left corner of the dialog) to save and close.
    • All books matching the specified formats sent to iTunes/iBooks will have this plugboard transform applied.
  • Force <dc:language> to specific value (ePubs only)
    • If you already have an existing plugboard for APPLE, select it in the Existing plugboards list, otherwise follow the steps described in the first example to create a new plugboard.
    • In the Source template field, add this template:
      Code:
      fr
      In the Destination field, select language. This tells the templating engine "Set the value of <dc:language> to 'fr'."
    • Click the Save plugboard button, then Apply (upper left corner of the dialog) to save and close.
    • All books matching the specified formats sent to iTunes/iBooks will have this plugboard transform applied.
Learn more about the templating language here in the calibre user manual, and discuss plugboard uses here in calibre's Mobileread forum.

'Connect to iDevice' mode (unsupported)
Spoiler:
  1. Launch iTunes with your iDevice connected.
  2. Launch calibre, set Preferences:
    • Preferences|General|Preferred output format to EPUB
    • Preferences|Conversion|Common Options|Page Setup|Output profile to your iDevice.
    • Preferences|Plugins|Device Interface plugins|Apple device interface - click Enable/Disable plugin so that driver is enabled (not grayed out)
  3. To send epubs or PDFs from calibre to your iDevice:
    • Select the book(s) to send from your calibre Library window, then click Send to device. Your books are sent to iTunes and iBooks.
  4. To use Fetch News to download periodicals from the Internet:
    • Preferences|Interface|Automatically send downloaded news to ebook reader:
      Recommendation: checked
    • Preferences|Interface|Delete news from library when it is automatically sent to reader:
      Recommendation: checked
    • Click Fetch news, select the recipe(s) you want downloaded, click Download now then Save. When the Jobs spinner has stopped and your iDevice has finished syncing, you can read your downloaded periodicals as epubs in iBooks.

'Connect to iDevice' mode - more details
  1. The iDevice driver is very different than a conventional calibre driver which sees the connected device as a USB drive. The iDevice driver accomplishes its tasks by talking to iTunes through an automation interface. As a result, settings in iTunes influence how various operations are carried out. I have not tested all of the possible combinations of iTunes settings that one might use, so it's entirely possible that your configuration will trigger unexpected results. This overview discusses the most common settings.
  2. It's a good idea to sync your iDevice with iTunes before connecting your iDevice to calibre for the first time. Syncing apps and other media between your iDevice and iTunes before working with calibre will speed up transfers.
  3. In iTunes Device Summary, the Manually manage music and videos checkbox influences how syncs are accomplished:
    • If unchecked, calibre adds all of the transferred epubs to iTunes, then does a single sync operation to transfer all of the uploaded epubs to iBooks on your iDevice at once. If iTunes decides that other items need to be synced at the same time, it will do so during this sync cycle. This could include doing an incremental backup of your iDevice.
    • If checked, books are sent to the iDevice directly without a full sync cycle.
    There will be performance differences between the two settings depending on your usage patterns and your OS, but the driver is designed to work with either setting.
    Recommendation: start with unchecked. Windows users: things seem to work better with the checkbox unchecked.
  4. Launch calibre. When a connected iDevice is detected, calibre will launch iTunes (minimized) if it's not already running. Calibre does not support multiple iDevices connected simultaneously. If calibre detects more than one physically connected iDevice in iTunes (iPad, iPhone, iPod Touch), the driver will not launch. This includes devices that have been ejected but not physically disconnected.
  5. In calibre, set Preferences|General|Preferred output format to 'EPUB', and Preferences|Conversion|Page Setup|Output profile to 'iPad'.
  6. The first time you connect your iDevice to calibre, calibre will be caching metadata and thumbnails as it scans iTunes and iBooks, making subsequent connections much faster.
  7. The iDevice 'Reader' icon will be shown next to the 'Library' icon, indicating that calibre is connected to your iDevice. Click it to see books in the Books playlist on your iDevice.
  8. To upload books in either epub or PDF format from calibre to your iDevice, select the book(s) to transfer from your Library, then click Send to device.
  9. iTunes/iBooks supports a single Category tag. You may choose to use either a tag or a Series name as the Category by indicating your preference in Preferences|Plugins|Device Interface plugins|Apple device interface. Click Customize plugin. Use Series as Category in iTunes/iBooks has the following meaning:
    • checked: If your book has a Series name, it will be used as the Category in iTunes/iBooks. If your book does not have a Series name, a tag will be used.
    • unchecked: If you have multiple tags assigned to a book in calibre, the first tag beginning with an alpha character will be used. Special tags like '[Project Gutenberg]' or '+' are ignored.
  10. Recipes and catalogs may be sent to the iDevice.
  11. While calibre is running, it's best to do all iDevice-related actions through calibre rather than iTunes. Minimizing iTunes while calibre is running will reduce the temptatation to meddle.
  12. Syncing is initiated after clicking Send to device or Remove books in the Reader view. In some cases, the syncing operation between iTunes and your iDevice will continue after calibre is done with its part. Watch the screen on the iDevice to know when the sync is done.
  13. Unlike some other readers, the iDevice may be used while connected to the computer. This means that you can open your uploaded books in iBooks (after syncing is complete) while the iDevice is still connected to calibre. You don't need to eject the iDevice until you want to disconnect the iPad from your computer.
  14. You can copy books from your iDevice to your computer using Save to disk, but be aware that all epubs acquired through the iBooks store are encrypted with Apple's Fairplay DRM, and thus not readable anywhere but on your iDevice.
  15. Books with DRM are able to have their metadata updated in calibre.
  16. iBooks stores epubs on the iDevice in uncompressed form. As a result, you will notice that the size of the book shown in calibre's Library window (and iTunes) is different than the size of the book on the iDevice.

What's the difference between 'Connect to iTunes' and 'Connect to iDevice'?
Spoiler:

'Connect to iTunes' uses iTunes as the Reader device. Clicking the Reader icon (the iTunes logo) shows a list of books in the iTunes Library. After sending books from calibre to iTunes, you sync iTunes with your iDevice at your convenience. This is the recommended mode.
'Connect to iDevice' uses your iDevice as the Reader device. Clicking the Reader icon (an iPad) shows a list of books in the iBooks library on your iDevice. Sending books from calibre to your iDevice happens immediately, without requiring you to sync. This mode is more complex.
Users are encouraged to use the 'Connect to iTunes' mode, as it adapts to the way that you're already using iTunes. You don't need to be concerned with any of the iTunes preferences or optional settings. When you're ready to update the contents of your iDevice, sync as you normally would.
If you choose to use 'Connect to iDevice' mode, spend some time reading and understanding the significance of the various iTunes settings that will affect calibre interactions.


Known Issues
Spoiler:
  1. The driver currently sends comments from calibre to iTunes, however the automation interface to iTunes limits the transferred text to 256 characters. This is a limitation of the iTunes automation interface in both OSX and Windows.
  2. If you use calibre to delete a book that you purchased through the iBookstore (free or paid), iTunes may pop up a dialog asking you to confirm. This does not happen with books transferred from calibre.
  3. If you bring up a modal dialog in iTunes, for example Get Info to examine the book's metadata, the iDevice will appear to disconnect in calibre after a short time. As soon as you close the modal dialog in iTunes, the connection will be restored in calibre.
  4. (OSX only) If iTunes|DEVICES|iDevice|Summary|Options|Manually manage music and videos is checked, the automation interface will generate an error when trying to send artwork to the iDevice. This is as of iTunes 9.2, hopefully that bug will be fixed by Apple at some point.
  5. (Windows only) If you are unable to connect to iTunes, try launching calibre in Administrator mode.
  6. It is currently not possible to set the cover for PDFs via the automation interface. iTunes/iBooks uses the cover specified within the PDF file.
  7. When transferring PDF files, there is a period of several seconds per book when it appears that nothing is happening. What is happening is that calibre is updating the PDF's metadata before sending the book, but there is no user feedback. There is an existing bug report #5949 addressing this issue. If you are sending multiple PDFs, the cumulative time without user feedback can be substantial.
  8. 'Connect to iDevice' mode can only deal with one connected iDevice. When the driver loads, it confirms that there is only one iDevice connected. However, if you connect a second iDevice later, calibre won't know which device to communicate with. Using 'Connect to iTunes' avoids this problem.

Under the hood
Spoiler:
  • The driver has been tested with OS X 10.5 - 10.7 (Leopard, Snow Leopard, Lion), Windows XP, Windows 7, and a 3G iPad. With OS X, 10.5 or later is required.
  • You must have iTunes installed on your system, as calibre talks to the iDevice through iTunes. You should install the latest version of iTunes, 10.4 as of this writing. If in doubt, download the most recent version from apple.com. To check your installed version, click iTunes|About iTunes in the iTunes menu.
  • There will be no Linux support in this driver, as there is no Linux version of iTunes.
  • The driver sends only epubs and PDFs to iBooks via iTunes via a physical USB connection.
  • If you have a cover assigned in calibre, it will be used in iTunes and in iBooks as the book's cover, superseding any cover within the file. As of iTunes 9.2 and iBooks 1.1, this works only for epubs, not PDFs. The cover art provided in the PDF will be used by iTunes/iBooks.
  • Calibre uses an automation interface to send commands to iTunes. The automation interface for OSX is completely different than the automation interface for Windows. Some operations have problems in one environment but not the other. The driver attempts to recover gracefully from any errors when talking to iTunes through the automation interface.
  • When downloading calibre recipes, the driver changes the metadata before sending the book to iTunes. For example, if you download the NYTimes, the title will be shown as 'The New York Times', and the author will be shown as today's date, e.g. 'Friday, June 18, 2010'. Title sort is 'New York Times', author sort is 'New York Times 2010-06-18'. Periodicals are tagged with 'News' by default, which becomes the Category for the book in iBooks.
    If you are using recipes, be aware that Preferences|Interface|Automatically send downloaded news to ebook reader and Preferences|Interface|Delete news from library when it is automatically sent to reader should be set according to your preferences.
  • See Metadata Mapping and Plugboard Transformations section for current metadata mappings.
  • Metadata management: Preferences|Sending books to devices|Metadata management lists multiple options for how metadata is transferred to devices. The iTunes driver only transfers metadata when a book is sent to iTunes. The iTunes driver has no notion of collections. It doesn't matter what is selected in Metadata management - metadata is only transferred when books are sent to iTunes. If you want to update the metadata, send the book again.
  • iTunes file references: As of version 0.8.8, you have a choice of where iTunes will find books you've transferred. In iTunes Preferences|Advanced, 'Copy files to iTunes Media folder when adding to library' tells iTunes whether you want it to make a copy of added media (checked) or whether you want iTunes to simply reference an existing copy somewhere else in your system (unchecked). Whichever you choose, the similar setting in calibre's Preferences|Advanced|Plugins|Device interface plugins|Apple device interface customization dialog should be set the same:
    • When checked, the driver passes a pointer to a temporary copy of the file, which iTunes will copy to its Media folder.
    • When unchecked, the driver makes a local copy of transferred books in your calibre configuration directory. When deleting books from the connected iTunes device, the local copy is also deleted.


If you have problems ...

Spoiler:
  • (Windows users) Can't connect to iTunes
    Try running calibre as administrator.
  • Books are disappearing from iTunes
    If you have enabled/disabled the Apple device driver in Preferences, restart calibre.
    If you are connecting multiple iDevices to calibre, use the 'Connect to iTunes' method described at the beginning of this post. Connecting directly to the device is an advanced user mode for single iDevices.
  • Calibre doesn't recognize my iDevice
    Confirm that you have only one iDevice (iPad, iPhone, iPod) connected.
  • I don't want calibre to recognize my iDevice
    If your regular Reader is a device other than an iDevice (Sony, Kindle, Nook, etc) and you routinely connect an iPhone to your computer to charge or sync it with iTunes, you will want to disable your iDevice in calibre. In Preferences|Advanced|Plugins|Device Interface plugins select the Apple device interface plugin. Click the Enable/Disable button so that the icon is grayed out, then restart calibre.
  • Calibre doesn't crash, but it's not doing what I expect
    1. Confirm that you're up to date with the latest release of calibre.
    2. If you're using 'Connect to iDevice', try using the recommended 'Connect to iTunes' mode as described at the beginning of this post.
    3. Start calibre in debug mode. With iTunes running, open a command window then type:
      Code:
      calibre-debug -g >calibre.txt
    4. Repeat the steps to recreate the scenario. Exit calibre, create a ticket in the calibre bug database. Attach 'calibre.txt' to your bug report. Please provide as much relevant context as possible to help recreate the problem, including the steps you took prior to observing the problem, your OS, and the nationality of your iTunes installation.
  • Calibre crashes
    1. Confirm that you're up to date with the latest release.
    2. If you're using 'Connect to iDevice', try using the recommended 'Connect to iTunes' mode as described at the beginning of this post.
    3. If you're still crashing, launch calibre in debug mode. With iTunes running, launch calibre from a command window:
      Code:
      calibre-debug -g >calibre_crash.txt
    4. Repeat the steps to create the problem. After the crash, create a ticket in the calibre bug database. Attach 'calibre_crash.txt' to your bug report. Please provide as much relevant context as possible to help recreate the problem, including your OS and the nationality of your iTunes installation.
  • Everything's perfect except for this one missing feature I can't believe you forgot
    Go to calibre's project management site to create a feature request.

Please post comments, problem, suggestions regarding iDevice support in this subforum. Include your OS, the version of iTunes you're using, and the nationality of your installed iTunes.

Last edited by GRiker; 10-24-2013 at 08:22 AM. Reason: Mavericks incompatibility warning
GRiker is offline  
Old 07-01-2011, 08:22 AM   #2
GRiker
Comparer of the Ephemeris
GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.
 
Posts: 1,496
Karma: 424697
Join Date: Mar 2009
Device: iPad
Addendum: More about how iTunes and calibre share file access

Beginning with version 0.8.7, significant changes were made to calibre's database storage architecture in anticipation of supporting networked databases. All iDevice users should be aware of how this change affects books transferred from calibre to iTunes and iBooks.

Does this apply to me?
If you are using calibre to transfer ePubs or PDFs to iTunes and ultimately iBooks on an Apple iDevice (iPad, iPhone, iPod Touch) this applies to you.

What do I need to do?
You need to decide whether you want iTunes to store copies of transferred books, or if you want calibre to create a local copy of transferred books for iTunes to reference.
  • Open iTunes Preferences|Advanced
  • Choose a setting for Copy files to iTunes Media folder when adding to my library. If you already have existing content in iTunes (music, videos, etc), you should keep your current setting.
    • Checked: iTunes will make copies of transferred books in your iTunes Media folder
    • Unchecked: iTunes will reference copies of transferred books in your calibre configuration directory.
  • Open calibre Preferences|Plugins|Device Interface plugins. Select the Apple iTunes interface (it may be disabled, that's OK). Click Customize plugin.
  • Set 'Copy files to iTunes Media folder…' is enabled in iTunes Preferences|Advanced to match the setting you chose in iTunes Preferences|Advanced above.
    Important: Both checkboxes should be in the same state (checked or unchecked). Mixed settings may lead to an inability for iTunes to sync your books, or multiple local copies.

I really don't like reading technical explanations. May I stop reading now?
If you've followed the previous instruction, you're done. If you're concerned about why this change was implemented, or its implications, read on.

Why do I need to do this?
Changes to calibre's database storage architecture mean that it is no longer possible for a device driver to directly access calibre's local copy of the file, as one may not exist. This change ensures that a local copy of the transferred file will exist on your system, either in your iTunes Media folder, or a special 'iTunes storage' folder in your calibre configuration directory.

What about books previously transferred from calibre to iTunes?
Books transferred from calibre to iTunes prior to 0.8.7 still have valid paths to calibre's local database, so iTunes should still be able to sync them with your iDevice. If you make a change to a book previously transferred, you will need to resend it to iTunes.

Doesn't this mean that there will be extra copies of transferred books on my system? Why can't things be the way they used to be in the good old days? Grumble grumble grumble.
Calibre will eventually support networked databases as an option. In a networked database, there are no local copies of the calibre library. When a file is sent to iTunes, a local copy needs to be available for iTunes to be able to sync it with your iDevice.

I don't want extra copies of my books floating around on my system.
If you are concerned about storage space on your system, you can complete the transfer to your iDevice during the same calibre session, then remove the local copy:
  • Connect to iTunes by clicking the Connect/Share icon, then select the Connect to iTunes option.
  • Select the book(s) to transfer, then click the Send to Device icon.
  • Using iTunes, sync your iDevice to transfer the books to your iDevice.
  • Re-select the books(s) just transferred, click the down arrow next to the Remove books icon, then select Remove matching books from device. The selected books will removed from local storage, and from the iTunes database.

What's the proper way to delete books added to iTunes/iDevices?
Books should be removed from iTunes/iDevices using the same method you used to add them:
  • If you added the book to iTunes using calibre, delete it using calibre's Remove matching books from device command.
  • If you added the book directly to iTunes, remove it using iTunes.
  • If you added the book directly to iBooks on the iDevice (a download from the iBookstore, or using calibre's content server), delete the book directly in iBooks on the iDevice.

I have books listed in iTunes with a '!' prefix. What do I do?[LIST=1][*]In iTunes Preferences|Advanced, confirm that the setting for 'Copy files to iTunes Media folder when adding to library' matches the setting in calibre Preferences|Plugins|Device Interface plugins|Apple iTunes interface as described above.[*]Resend the books shown with a '!' prefix

Are there any ways to transfer books to iBooks that don't create a iTunes local copy?
  1. Install the Apple iDevice plugin. This plugin transfers books directly to iBooks on a connected iDevice without creating a copy in iTunes.
  2. Use calibre's content server and the iOS 'Open in...' feature.
  3. Mail the book to yourself, use the 'Open in...' feature.

Last edited by GRiker; 07-27-2013 at 07:15 AM. Reason: Revised plugin name
GRiker is offline  
Advert
Old 06-13-2012, 03:45 PM   #3
GRiker
Comparer of the Ephemeris
GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.
 
Posts: 1,496
Karma: 424697
Join Date: Mar 2009
Device: iPad
Exclamation Apple limiting inter-app communications in iTunes (OS X)

Beginning with iTunes 10.6.3 (OS X only), Apple implemented changes to iTunes' ability to respond to inter-app communications, causing calibre's 'Connect to iTunes' feature to fail. Some skilled programmers developed a workaround for the 'appscript' library that calibre uses to communicate with iTunes. This workaround reenables the 'Connect to iTunes' feature beginning with calibre 0.8.58. This is a temporary fix; Apple has made it clear that they intend to limit inter-app communications in OS X for security purposes.

If you are unable to use the 'Connect to iTunes' feature, update to calibre 0.8.58 and try again.

If there is some additional news to report, I will update this post.

Further reading:
To discuss this issue, please use this thread.

There is an existing calibre bug report here.

Last edited by GRiker; 06-27-2012 at 12:06 PM.
GRiker is offline  
Closed Thread

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Calibre 0.7.9 won't start HarryC Calibre 4 07-20-2010 04:45 PM
Can't start Calibre Cor Wessels Calibre 1 04-05-2010 07:48 AM
Calibre doesn't start slothrop Calibre 1 12-14-2009 09:23 PM
Calibre will not start - ever Photonboy Calibre 7 10-24-2009 02:04 AM
Calibre 0.4.89 won't start ould Calibre 3 10-02-2008 09:21 PM


All times are GMT -4. The time now is 04:42 AM.


MobileRead.com is a privately owned, operated and funded community.