Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Software > Calibre > Plugins

Notices

Reply
 
Thread Tools Search this Thread
Old 11-27-2015, 11:18 AM   #1
jackie_w
Wizard
jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.
 
Posts: 3,494
Karma: 5609022
Join Date: Sep 2009
Location: UK
Device: Sony PRS-350, Kobo Glo/AuraHD/Aura6"/AuraH2O/GloHD
[GUI Plugin] ScrambleEbook: Getting help with copyrighted books

In case you're wondering 'Why on earth would anyone want to scramble their ebooks?' read on ...

Purpose:
This plugin will read an un-DRM'd ebook file (EPUB/KEPUB/AZW3) and create an external copy with scrambled content.

The aim is to create a book sufficiently obscured to allow a full upload to the MobileRead (MR) forums without breach of copyright. It should make it easier for MR members to request and offer help with problematic ebooks.

The book can be either:
  • in your calibre library
  • on an ereader device whose contents are visible to calibre

N.B: This plugin has been sanctioned by the MR Moderator Team who were instrumental in setting the rules about what must be scrambled and what can remain intact for upload to be permissible. The rules are subject to change if circumstances change.


Background:
No-one likes to see an MR member, especially a brand-new member, being issued with a severe warning from a Moderator because they uploaded a copyrighted book to the forum due to ignorance and desperation for help rather than malicious intent.

In addition, I have seen the frustration which can occur on both sides, when a knowledgeable user tries to talk a novice user through the non-trivial process of creating a short extract of their problematic book which won't fall foul of MR copyright considerations.

Anyone interested can read more in this thread Scrambling copyright ebooks to help troubleshoot problems ??? .


Testing: In theory the plugin should work equally well on Windows, MacOSX and Linux. However, neither myself nor the other beta-testers had a Mac to test it with.


How to install: Preferences - Get plugins to enhance calibre Select Scramble Ebook then press Install


Configuration: None


How to use:
  1. Select a single non-DRM'd book in calibre. Either from:
    • the Library view
    • the Device view of a USB-attached device
  2. Select ScrambleEbook from whichever calibre toolbar/menu you added it to
  3. Press the Scramble now button. You will see a brief description of what was done in the large box, top-left.
    (See attached image, ScrambleEbook.jpg, below)
  4. When scrambling has finished, press the Preview content button to view Original and Scrambled content side-by-side.
    (See attached image, Preview.jpg, below)
    This step is optional, but advisable, just to double-check that the text is well-and-truly obscured.
  5. Press Save scrambled book & Exit. You will be prompted to choose the directory/folder name where the scrambled copy of the book will be saved.
    Please note that AZW3 books take a little longer to process than EPUBs because of the necessary AZW3 repacking.
  6. Create your MobileRead post explaining what problems you are seeing with the original book and attach the newly-created scrambled ebook file.
  7. Hope for a speedy response from a willing and more-knowledgeable helper

Limitations:
  1. The selected ebook file must have a filetype of one of the following:
    • .epub
    • .azw3
    • .kepub
    • .kepub.epub (USB-attached Kobo only)
  2. There are some languages for which the scrambling algorithm is not effective.
    This currently includes: Chinese, Japanese, Korean, Arabic, but there will be others.

    The rule-of-thumb about which languages are 'safe' is that if both of the following are true then it's safe:
    • ALL alpha chars of ALL alphabets used in the book have 2 different unicode versions, an uppercase and a lowercase
    • All numeric chars used in the book are standard 0-9
    You are encouraged to use the included 'Preview content' button to double-check that copyrighted content has been properly obscured before posting to MobileRead.

Acknowledgements:
Thanks to RbnJrg, BetterRed and eschwartz for beta-testing and, as always, to kovidgoyal for help with all things calibre-code-related.

How is the book scrambled?
MR default settings are:
Spoiler:
  • Book content:
    - alpha chars - replaced with random choice a-z
    - digits 0-9 - scrambled to another digit
    - UPPER/lower case retained. Paragraphs look "realistic" but meaningless.
  • Hyperlink anchors: Any which do not contain any alpha chars are unchanged
  • TOC ncx: alpha chars replaced with random choice a-z, digits 0-9 unchanged
  • Punctuation, spaces: unchanged
  • Images:
    - .jpg .gif .png (including cover image) : all replaced with dummy image of same dimensions/filetype
    - .svg : all replaced with dummy .svg image
  • Embedded fonts:
    - non-obfuscated fonts removed
    - obfuscated fonts unchanged
  • OPF file: some descriptive metadata text removed (description, calibre-specific items)
  • CSS files: unchanged


Version History:
Spoiler:

Version 0.0.4 - 27 Nov 2015
Initial release
Attached Thumbnails
Click image for larger version

Name:	ScrambleEbook.jpg
Views:	242
Size:	39.3 KB
ID:	144115   Click image for larger version

Name:	Preview.jpg
Views:	192
Size:	232.1 KB
ID:	144116  
Attached Files
File Type: zip ScrambleEbook_v0-0-4.zip (110.0 KB, 9960 views)

Last edited by jackie_w; 11-27-2015 at 01:28 PM. Reason: plugin now part of calibre official list
jackie_w is offline   Reply With Quote
Old 11-27-2015, 11:19 AM   #2
jackie_w
Wizard
jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.
 
Posts: 3,494
Karma: 5609022
Join Date: Sep 2009
Location: UK
Device: Sony PRS-350, Kobo Glo/AuraHD/Aura6"/AuraH2O/GloHD
Reserved in case anything needs more detailed explanation.
jackie_w is offline   Reply With Quote
Old 11-27-2015, 02:12 PM   #3
eschwartz
Irrational Optimist
eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.
 
eschwartz's Avatar
 
Posts: 18,122
Karma: 72218367
Join Date: Nov 2012
Location: The Beaten Path, USA, Roundworld, This Side of Infinity
Device: Kindle Touch fw5.3.7 (Wifi only)
Excellent work!

I've included this in my quick-fire template for responding to inadvertent copyright-infringing uploaders.
eschwartz is online now   Reply With Quote
Old 11-27-2015, 02:39 PM   #4
jackie_w
Wizard
jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.
 
Posts: 3,494
Karma: 5609022
Join Date: Sep 2009
Location: UK
Device: Sony PRS-350, Kobo Glo/AuraHD/Aura6"/AuraH2O/GloHD
Quote:
Originally Posted by eschwartz View Post
Excellent work!

I've included this in my quick-fire template for responding to inadvertent copyright-infringing uploaders.
Thank you That should help.
jackie_w is offline   Reply With Quote
Reply

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
[GUI Plugin] KindleUnpack - The Plugin DiapDealer Plugins 362 04-25-2016 05:19 PM
How to get a list of books corresponding to the selected tag in the GUI plugin? esvorontsov Development 6 09-29-2015 10:06 AM
[GUI Plugin] DjVuMaker - converts Postscript books to Djvu TheWizard Plugins 4 03-22-2015 04:03 AM
[GUI Plugin] Plugin Updater **Deprecated** kiwidude Plugins 159 06-19-2011 12:27 PM


All times are GMT -4. The time now is 12:06 AM.


MobileRead.com is a privately owned, operated and funded community.