*** With Adobe Digital Editions 3.

0 and later, Adobe have introduced a new,

optional, DRM scheme. To avoid this new scheme, you should use Adobe Digital
Editions 2.0.1. Some books are required to use the new DRM scheme and so will not
download with ADE 2.0.1. If you still want such a book, you will need to use ADE
3.0 or later to download it, but you should remember that no tools to remove
Adobe's new DRM scheme exist as of October 2017.

Installation
------------
Open calibre's Preferences dialog. Click on the "Plugins" button. Next, click on
the button, "Load plugin from file". Navigate to the unzipped DeDRM_tools folder
and, in the folder "DeDRM_calibre_plugin", find the file "DeDRM_plugin.zip". Click
to select the file and select "Open". Click "Yes" in the "Are you sure?" dialog
box. Click the "OK" button in the "Success" dialog box.

Customization
-------------
You MUST add some key information for the following kinds of ebooks:
- Kindle ebooks from an E-Ink based Kindle (e.g. Voyage).
- Barnes & Noble ePubs other than those downloaded using NOOK Study
- Mobipocket ebooks
- eReader PDB books

You do not need to add any key information for eBooks

- downloaded using Kindle for Mac/PC
- downloaded using Adobe Digital Editions (v2.0.1)
- downloaded using NOOK Study
as the necessary keys are automatically retrieved from files on your computer.

To add needed key information for other books, highlight the plugin (DeDRM under
the "File type plugins" category) and click the "Customize Plugin" button.

The buttons in the configuration dialog will open individual configuration dialogs
that will allow you to enter the needed information, depending on the type and
source of your DRMed eBooks. Additional help on the information required is
available in each of the the dialogs vias the [?] help button.

If you have used previous versions of the various DeDRM plugins on this machine,
you may find that some of the configuration dialogs already contain the information
you entered through those previous plugins.

When you have finished entering your configuration information, you must click the
OK button to save it. If you click the Cancel button, all your changes in all the
configuration dialogs will be lost.

Tr

The alfcrypto library is by some_updates

The ePub encryption detection script is by Apprentice Alf, adapted from a script by
Paul Durrant
The ignoblekey script is by Apprentice Harper
The DeDRM plugin was based on plugins by DiapDealer and is maintained by Apprentice
Alf and Apprentice Harper

Many fixes, updates and enhancements to the scripts and applicatons have been made
by many other people. For more details, see the commments in the individual
scripts.

Linux Systems Only

==================

Instructions for installing Wine, Kindle for PC, Adobe Digital Editions, Python and
PyCrypto
-----------------------------------------------------------------------------------
---------

These instructions have been tested with Wine 1.4 on Ubuntu but may now be a bit
out of date..

1. First download the software you're going to to have to install.

a. Adobe Digital Editions 1.7.x from http://helpx.adobe.com/digital-
editions/kb/cant-install-digital-editions.html
(Adobe Digital Editions 2.x doesn't work with Wine.)
b. Python 2.7.X for Windows (x86) from
https://www.python.org/ftp/python/2.7.13/python-2.7.13.msi
c. PyCrypto 2.1 for 32bit Windows and Python 2.7 from
http://www.voidspace.org.uk/python/modules.shtml#pycrypto
(PyCrypto downloads as a zip file. You will need to unzip it.)
2. Install Wine for 32-bit x86. (e.g. on Ubuntu, Open the Ubuntu Software Center,
search for Wine, and install "Wine Windows Program Loader".)
2a. [update] Kindle for PC now requires Windows 7, so in the following setups,
choose any option for Windows 7, not Windows XP.
3. Run "Configure Wine", which will set up the default 'wineprefix'
4. Navigate to "Install an application" and install Kindle. Alternatively, run
`winetricks kindle`
5. Install Adobe Digital Editions. Accept all defaults and register with your
Adobe ID.
6. Install Python 2.7.x using `msiexec /i python-2.7.8.msi`. Accept all defaults.
7. Install PyCrypto 2.1. Accept all defaults.
8. Unzip DeDRM_plugin.zip and move kindlekey.py to somewhere in drive_c, such as
~/.wine/drive_c/DeDRM/libraryfiles/kindlekey.py.
9. Run `wine 'C:\Python27/python.exe' 'C:\DeDRM/libraryfiles/kindlekey.py'`, or
wherever you copied kindlekey.py to.
10. Import the resulting key file to the Calibre plugin through the Kindle for
Mac/PC ebooks option.

Instructions for getting Kindle for PC and Adobe Digital Editions default
decryption keys
-----------------------------------------------------------------------------------
------

If everything has been installed in wine as above, the keys will be retrieved
automatically.

If you have a more complex wine installation, you may enter the appropriate
WINEPREFIX in the configuration dialogs for Kindle for PC and Adobe Digital
Editions. You can also test that you have entered the WINEPREFIX correctly by
trying to add the default keys to the preferences by clicking on the green plus
button in the configuration dialogs.