mirrors/acsm-calibre-plugin
mirrors/acsm-calibre-plugin
1
0
Fork 0
mirror of https://github.com/Leseratte10/acsm-calibre-plugin.git synced 2024-11-16 11:46:10 +06:00
Code Issues Projects Releases Wiki Activity
3a4652a462
acsm-calibre-plugin/README.md
Florian Bach 3a4652a462 Working Python version (v0.0.3)
2021-09-25 16:24:03 +02:00

3.0 KiB
Raw Blame History

Calibre ACSM plugin

This is a Calibre plugin that allows you to turn ACSM files into EPUBs without the need for ADE. It is a full Python reimplementation of libgourou by Grégory Soutadé (http://indefero.soutade.fr/p/libgourou/).

Setup

  1. Download the plugin and import it into Calibre
  2. Open the plugin settings, it should say "Not authorized for any ADE ID"
  3. Click the "Link to ADE account" button
  4. Enter your AdobeID and password, then wait a couple seconds for the success message.
  5. The settings window should now say "Authorized with ADE ID X on device Y".
  6. Click the "Export account activation data" and "Export account encryption key" buttons to export / backup your keys. Do not skip this step. The first file (ZIP) can be used to re-authorize Calibre after a reset / reinstall without using up one of your Adobe authorizations. The second file (DER) can be imported into Alf.
  7. Download an EPUB ACSM file from Adobe's test library and see if you can import it into Calibre: https://www.adobe.com/de/solutions/ebook/digital-editions/sample-ebook-library.html

IMPORTANT:

  • I would suggest creating a new dummy AdobeID to use for Calibre so just in case Adobe detects this and bans you, you don't lose your main AdobeID.
  • Combined with that I suggest importing the DER file into the Alf plugin to make sure that losing your AdobeID doesn't also mean you'll lose access to all your eBooks. See the section "Combining with Alf" below.
  • This plugin doesn't yet work with PDFs. Importing an ACSM file for a PDF book will just result in the ACSM file being imported, it won't be converted into a PDF.
  • This software is not approved by Adobe. I am not responsible if Adobe detects that you're using nonstandard software and bans your account. Do not complain to me if Adobe bans your main ADE account - you have been warned.

Combining with Alf

In order to combine this plugin with Alf, you'll need to go to Alf's settings and import the DER file you've just exported from this plugin.

Also, there's a small code change needed to Alf's plugin to make it work together with this one. Open up the __init__.py file in Alf's ZIP file and search for "file_types". You'll find a list of supported file types. Add "acsm" to that list, save the file, put it back into the ZIP file, then re-import the Alf plugin into Calibre. This is needed due to a bug in Calibre - even though this plugin converts the ACSM file into an EPUB on import, Alf still "thinks" it's an ACSM file and doesn't do anything with it. By forcing Alf to accept ACSM files it will work correctly (since it'll then notice that it's actually an EPUB).

To-Do list for the future?

There's a bunch of features that could still be added, but most of them aren't implemented in libgourou either, so I don't know if or when I'll be able to add these:

  • Support for anonymous Adobe IDs
  • Support for un-authorizing a machine
  • Support to re-import a backed-up authorization after a reinstallation (right now you can only do that manually)
  • Support for PDFs
  • ...