acsm-calibre-plugin/README.md

38 lines
2.9 KiB
Markdown
Raw Normal View History

# Calibre ACSM plugin (Linux only)
2021-09-20 19:18:12 +06:00
This is a Linux-only Calibre plugin that allows you to turn ACSM files into EPUBs without the need for ADE.
It's based on libgourou by Grégory Soutadé (http://indefero.soutade.fr/p/libgourou/).
## Note
The source code in this repository currently doesn't work because it's being updated. If you want to check the currently working source, check out the Release, the plugin source is included in the ZIP, and there's also an additional tar.xz with the libgourou source.
## Plans for the future
Right now this plugin is for Linux only, as it's using libgourou by Grégory Soutadé which only supports Linux.
I am currently reimplementing this library in Python so it will work on all operating systems in the future. Current state of that implementation is that account authorization works, so all that's now missing is the actual Fulfillment. And potentially allowing anonymous accounts in the future.
This Python implementation isn't useable to normal end-users right now, so if you're on Linux please use the released plugin instead of the raw source code, and if you're on Windows or on MacOS please wait for the native Python version of this plugin.
2021-09-20 19:18:12 +06:00
## Setup
You need to have the following packages installed to use this plugin (Debian Bullseye / Ubuntu 20.04):
make, g++, libssl-dev, pkg-config, qtbase5-dev, libzip-dev
Import the calibre plugin into Calibre, open the plugin settings, then click "Compile" to compile the library into a useable binary.
Once that's done (takes a couple seconds), click "Link to ADE account" and enter your ADE account credentials.
NOTE: This software is not approved by Adobe. I am not responsible if Adobe detects that you're using nonstandard software and bans your account. I suggest using a new, unused Adobe ID for this plugin, and combine that with a certain other Calibre Plugin (Alf) to immediately make the epubs "useable" so it's not a big deal if the account does get banned.
Do not complain to me if Adobe bans your main ADE account - you have been warned.
Once you've successfully linked your ADE account, click on "Export account activation data" and save the ZIP file somewhere safe. You'll need this to restore your activation after a re-install without wasting one of your six possible account activations.
After that, click on "Export account encryption key" and save the DER file somewhere safe, too. (This is the key file for Alf).
## 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.