]> xmof Git - DeDRM.git/commitdiff
Create CLI instructions
authorJonah Weissman <jonahrweissman@gmail.com>
Fri, 20 Jul 2018 00:00:25 +0000 (20:00 -0400)
committerJonah Weissman <jonahrweissman@gmail.com>
Wed, 29 Aug 2018 19:01:13 +0000 (15:01 -0400)
CLI_INSTRUCTIONS.md [new file with mode: 0644]
FAQs.md

diff --git a/CLI_INSTRUCTIONS.md b/CLI_INSTRUCTIONS.md
new file mode 100644 (file)
index 0000000..7d9a83d
--- /dev/null
@@ -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 d27a6dd5a0b6e83ed67feeb37c4886b1546c9c00..cf3dc388be2b39c40abff87a256caf857febbe24 100644 (file)
--- 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