From 114c4988c0c75918c37dbd681274286d5aeec578 Mon Sep 17 00:00:00 2001 From: Jonah Weissman Date: Thu, 19 Jul 2018 20:00:25 -0400 Subject: [PATCH] Create CLI instructions --- CLI_INSTRUCTIONS.md | 47 +++++++++++++++++++++++++++++++++++++++++++++ FAQs.md | 2 ++ 2 files changed, 49 insertions(+) create mode 100644 CLI_INSTRUCTIONS.md diff --git a/CLI_INSTRUCTIONS.md b/CLI_INSTRUCTIONS.md new file mode 100644 index 0000000..7d9a83d --- /dev/null +++ b/CLI_INSTRUCTIONS.md @@ -0,0 +1,47 @@ +# Command Line Interface Installation Instructions + +If you're not a fan of GUIs, but you still want to take DRM off of your +ebooks, then this guide is for you. + +This guide assumes you are on Linux, but it may very well work on other +platforms. + +## Step-by-step Tutorial + +#### Install Calibre + - Follow [Calibre's installation instructions](https://calibre-ebook.com/download_linux) + +#### Install plugins + - Download the DeDRM `.zip` archive from DeDRM_tools' + [latest release](https://github.com/apprenticeharper/DeDRM_tools/releases/latest). + Then unzip it. + - Add the DeDRM plugin to Calibre: + ``` + cd *the unzipped DeDRM_tools folder* + calibre-customize --add DeDRM_calibre_plugin/DeDRM_plugin.zip + ``` + - Add the Obok plugin: + ``` + calibre-customize --add Obok_calibre_plugin/obok_plugin.zip + ``` + +#### Enter your keys + - Figure out what format DeDRM wants your key in by looking in + [the code that handles that](src/prefs.py). + - For Kindle eInk devices, DeDRM expects you to put a list of serial + numbers in the `serials` field: `"serials": ["012345689abcdef"]` or + `"serials": ["1111111111111111", "2222222222222222"]`. + - Now add your keys to `$CALIBRE_CONFIG_DIRECTORY/plugins/dedrm.json`. + +#### Import your books + - Make a library folder + ``` + mkdir library + ``` + - Add your book(s) with this command: + ``` + calibredb add /path/to/book.format --with-library=library + ``` + +The DRM should be removed from your book, which you can find in the `library` +folder. diff --git a/FAQs.md b/FAQs.md index d27a6dd..cf3dc38 100644 --- a/FAQs.md +++ b/FAQs.md @@ -180,6 +180,8 @@ The Macintosh DeDRM application creates a log file on your desktop every time it ## I cannot solve my problem with the Windows DeDRM application, and now I need to ‘post a log’. How do I do that? The Windows DeDRM application creates a log file in your home directory (C:\Users\[username]) every time it is run. After unsuccessfully removing DRM from one ebook, copy the contents of the log file (it is a simple text file) and paste it into your comment at Apprentice Alf's blog or in a new issue at Apprentice Harper's github repository. +## Is there a way to use the DeDRM tools from the command line? +See the [command line interface (CLI) instructions](CLI_INSTRUCTIONS.md). # General Questions