View Single Post
Old 05-29-2010, 07:30 AM   #117
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
iPad driver included in 0.6.96 (beta version 0.2)

As of 0.6.96b, calibre supports the iPad in both OSX and Windows. You can use Send to device to transfer epubs directly to your connected iPad via iTunes.

This is a beta release of the iPad driver with the following caveats:
  • This is a beta release of the driver built on top of a beta release of calibre. It has not been exhaustively tested, but I've been using it with no data loss. I don't expect it will put scratches on your iPad screen, but if it does, you were warned.
  • The driver was tested with OSX 10.6 (Snow Leopard), Windows 7, and a 3G iPad.
  • You must have iTunes installed on your system, as calibre talks to the iPad through iTunes. You should install the latest version of iTunes, which is 9.1.1.(12) as of this writing. If in doubt, download the most recent version from apple.com. Fyi, 9.1.1.(11) was the last version pushed out by Apple's automatic software upgrade system, to get 9.1.1.(12) you currently need to manually download it. 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 transfers only epubs to iBooks via iTunes. PDFs transfers are not supported, nor are any of the 3rd party ereader apps ... only epubs to be read in iBooks.
  • 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 defined within the epub.
  • There is a bug in the current version of iBooks (1.0.1) when updating a book that's previously been added to iBooks. If you change the cover art in calibre, then send the updated book to the iPad, the original cover will still be shown in some iBooks browser views instead of the updated cover. The only fix that I've found is to reinstall iBooks on the iPad. Apparently iBooks is caching covers and not properly updating them, even though iTunes correctly shows the updated cover. Minor annoyance.
  • iPhone and iPod Touch will be supported when iBooks is available for them, probably when version 4.0 OS is released.

Using iPad as a Reader with Calibre
  • I suggest syncing your iPad with iTunes before connecting your iPad to calibre for the first time. Making sure that you're up to date with syncing will make transfers go more quickly.
  • In iTunes Preferences|Advanced, check Keep iTunes Media Folder organized and Copy files to iTunes Media Folder when adding to Library. You may not be currently be using these settings, but these settings are how the device driver's been tested. The second item 'Copy files ...', is mandatory, because calibre generates a temporary copy of the exported epub when sending it to iTunes. The permanent copy must be stored in iTunes, because the temporary copy provided by calibre is ... temporary.
  • In iTunes, with your iPad connected, select your iPad in the Devices section. In Summary|Options, uncheck Manually manage music and videos.
  • Launch calibre. When a connected iPad is detected, calibre will launch iTunes minimized if it's not already running.
  • Set Preferences|General|Preferred output format to 'EPUB', and Preferences|Conversion|Page Setup|Output profile to 'iPad'.
  • The first time you connect your iPad to calibre, calibre will be caching metadata and thumbnails as it scans iTunes and iBooks, which will make subsequent connections much faster.
  • The iPad 'Reader' icon will be shown next to the 'Library' icon, indicating that calibre is talking to the iPad. Click it to see books on your iPad.
  • To copy books from calibre to your iPad , select the book(s) to transfer from your Library, then click Send to device.
  • iTunes/iBooks supports a single Category tag. 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.
  • Recipes and catalogs may be downloaded to the iPad.
  • While calibre is running, it's best to do all iPad-related actions through calibre rather than iTunes. Minimizing iTunes while calibre is running will reduce the temptatation to interfere.
  • 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 iPad will continue after calibre is done with its part. Watch the screen on the iPad to know when the sync is done.
  • Unlike some other readers, the iPad may be used while connected to the computer. This means that you can open your downloaded books in iBooks after the syncing is complete while the iPad is still connected to calibre. You don't need to eject the iPad until you want to disconnect the iPad from your computer.
  • You can copy books from your iPad 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 iPad. Also, be aware that iTunes makes copies of purchased books during sync operations, so there's really no need to create a separate backup copy of your iBooks purchases in calibre.
  • iBooks stores epubs on the iPad in uncompressed form for performance reasons. As a result, you will notice that the size of the book shown in calibre's Library window (and iTunes) is smaller than the size of the book on the iPad.
  • iTunes is not shut down upon exiting calibre. I'll leave that to you.

Known Issues
  • 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 automation interface, and there's nothing that I can do about it. I'll leave the truncated transfer enabled for now, but if there are too many bug reports I'll turn it off.
  • If you use calibre to delete a book that you purchased through the iBookstore (free or paid), iTunes will pop up a dialog asking you to confirm. This does not happen with books transferred from calibre.
  • If you bring up a modal dialog in iTunes, for example 'Get Info' to examine the book's metadata, the iPad 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.
  • If you Remove books on your iPad, they will still be shown as On Device (i.e., checked) in the main Library window. This is a known issue with calibre and will be resolved.
  • If your iPad does not show as a connected device, I'll need to know its USB device id. Post the output from this command:
    Code:
    calibre-debug -d
    In particular, I need to see the portion describing your connected iPad. It should look similar to this:
    Code:
    ['0x5acL',
      '0x129aL',
      '0x1L',
      u'Apple Inc.',
      u'iPad',
      u'2f75d15ef9386376e10064d7a5701f47b2128aeb']]

G

Last edited by GRiker; 06-01-2010 at 02:36 PM.
GRiker is offline   Reply With Quote