Creating a new issue

[GRiker]

Before creating a new issue, check these common problems:

• If you are trying to install or update the plugin, disconnect all iDevices first.
• After installing the iOS reader applications plugin, restart calibre.
• Confirm that you do not have the plugin Apple iDevice interface installed. This was an older version of the iOS reader applications plugin which is now obsolete. Open Preferences|Advanced|Plugins, then open the Device Interface plugins list. Remove the Apple iDevice interface plugin if it is installed. Note that there is a similarly-named plugin Apple iTunes interface, which is a built-in plugin which cannot be removed.
• Confirm that you have only one iDevice connected when starting calibre. For example, you are using your iPad as a reader but you're charging your iPhone through a USB port at the same time.
• Confirm that you have no other reader devices connected (Kindle, Nook, Kobo…).
• If you're trying to use the plugin with Marvin, confirm that you have only one version of Marvin installed on your iDevice, and it is the active application, with the calibre connector running.
• If your iDevice is connected through a USB hub, try connecting directly to your computer.
• Confirm that your iDevice is visible in iTunes. If not, try a different USB cable.
• Try resetting your iDevice. Hold the Home button and the Power button together until you see the Apple logo, then release both buttons.

When creating a new issue, please include:

• The version of calibre you are using
• Calibre's language setting (available in Preferences | Interface | Look and Feel | Choose language)
• Your operating system, and 32- or 64-bit, if applicable. For example:
  • Windows 7, 64-bit
  • OS X 10.8.4
  • Ubuntu 12.04 32-bit
• The version of iTunes installed on your system (OS X and Windows).
• The version of the plugin installed
• The preferred reader application selected in the configuration dialog
• A description of your iDevice including cellular technology/provider, if applicable
• A description of the problem
• The specific steps to recreate the problem

Remember to create a new issue, not a comment to this issue.

I may ask you for a debug log. Here's how to provide debug information:

• Open the configuration dialog for the plugin.
• Enable the checkbox Enable debugging for iDevices.
• Disable the checkbox Enable debugging for libiMobileDevice.
• Click OK.
• OS X only: Open Preferences | Advanced | Miscellaneous, click Install command line tools. (You only need to do this once on your system. The command line tools will still be installed after updating calibre.)
• Accept all changes, exit calibre.
• Open a terminal or command window on your computer, then type
  calibre-debug -g > debug_log.txt. The file debug_log.txt will be created in your current directory.
• Repeat the steps necessary to cause the problem, then close calibre.
• Paste the contents of debug_log.txt into a new comment in your issue.