<h3>Foradditionalhelpreadthe<ahref="http://apprenticealf.wordpress.com/2011/01/17/frequently-asked-questions-about-the-drm-removal-tools/"target="_blank">FAQ</a>on<ahref="http://apprenticealf.wordpress.com"target="_blank">ApprenticeAlf's Blog</a> and ask questions in the comments section of the <a href="http://apprenticealf.wordpress.com/2012/09/10/drm-removal-tools-for-ebooks/" target="_blank">first post</a>.</h3>
<p>ThispluginismeanttodecryptBarnes&NobleePubsthatareprotectedwithAdobe's Adept encryption. It is meant to function without having to install any dependencies... other than having calibre installed, of course. It will still work if you have Python and PyCrypto already installed, but they aren'tnecessary.</p>
<p>Thishelpfileisalwaysavailablefromwithintheplugin's customization dialog in calibre (when installed, of course). The "Plugin Help" link can be found in the upper-right portion of the customization dialog.</p>
<p>Gotocalibre's Preferences page. Do **NOT** select "Get plugins to enhance calibre" as this is reserved for "official" calibre plugins, instead select "Change calibre behavior". Under "Advanced" click on the Plugins button. Use the "Load plugin from file" button to select the plugin'szipfile(ignobleepub_v02.3_plugin.zip)andclickthe'Add'button.Click'Yes'inthethe"Are you sure?"dialog.ClickOKinthe"Success"dialog.<b><u>Nowrestartcalibre</u></b>.</p>
<p>Uponfirstinstallingtheplugin(orupgradingfromaversionearlierthan0.2.0),thepluginwillbeunconfigured.UntilyoucreateatleastoneB&Nkey—ormigrateyourexistingkey(s)/datafromanearlierversionoftheplugin—thepluginwillnotfunction.Whenunconfigured(nosavedkeys)...anerrormessagewilloccurwheneverePubsareimportedtocalibre.Toeliminatetheerrormessage,opentheplugin's customization dialog and create/import/migrate a key (or disable/uninstall the plugin). You can get to the plugin'scustomizationdialogbyopeningcalibre's Preferences dialog, and clicking Plugins (under the Advanced section). Once in the Plugin Preferences, expand the "File type plugins" section and look for the "Ignoble Epub DeDRM" plugin. Highlight that plugin and click the "Customize plugin" button.</p>
<p>Ifyouareupgradingfromanearlierversionofthispluginandhaveprovidedyourname(s)andcreditcardnumber(s)aspartoftheoldplugin's customization string, you will be prompted to migrate this data to the plugin'snew,moresecure,keystoragemethodwhenyouopenthecustomizationdialogforthefirsttime.IfyouchooseNOTtomigratethatdata,youwillbepromptedtosavethatdataasatextfileinalocationofyourchoosing.Eitherway,thispluginwillnolongerbestoringnamesandcreditcardnumbersinplainsight(oranywhereforthatmatter)onyourcomputerorincalibre.Ifyoudon't choose to migrate OR save the data, that data will be lost. You have been warned!!</p>
<p>Uponconfiguringforthefirsttime,youmayalsobeaskedifyouwishtoimportyourexisting*.b64keyfiles(ifyouusethem)totheplugin's new key storage method. The new plugin no longer looks for keyfiles in calibre'sconfigurationdirectory,soit's highly recommended that you import any existing keyfiles when prompted ... but you <i>always</i> have the ability to import existing keyfiles anytime you might need/want to.</p>
<pstyle="margin-left: 1.0em">Ontheright-handsideoftheplugin's customization dialog, you will see a button with an icon that looks like a green plus sign (+). Clicking this button will open a new dialog for entering the necessary data to generate a new key.</p>
<ulstyle="margin-left: 2.0em;">
<li><b>UniqueKeyName:</b>thisisauniquenameyouchoosetohelpyouidentifythekeyafterit's created. This name will show in the list of configured keys. Choose something that will help you remember the data (name, cc#) it was created with.</i>
<listyle="margin-top: 0.5em;"><b>YourName:</b>YournameassetinyourBarnes&Nobleaccount,MyAccountpage,directlyunderPERSONALINFORMATION.Itisusuallyjustyourfirstnameandlastnameseparatedbyaspace.Thisnamewillnotbestoredanywhereonyourcomputerorincalibre.Itwillonlybeusedinthecreationoftheone-wayhash/keythat's stored in the preferences.</i>
<listyle="margin-top: 0.5em;"><b>CreditCard#:</b> this is the default credit card number that was on file with Barnes & Noble at the time of download of the ebook to be de-DRMed. Nothing fancy here; no dashes or spaces ... just the 16 (15 for American Express) digits. Again... this number will not be stored anywhere on your computer or in calibre. It will only be used in the creation of the one-way hash/key that's stored in the preferences.</i>
<pstyle="margin-left: 1.0em;">Ontheright-handsideoftheplugin's customization dialog, you will see a button with an icon that looks like a red "X". Clicking this button will delete the highlighted key in the list. You will be prompted once to be sure that'swhatyoutrulymeantodo.Oncegone,it's permanently gone.</p>
<pstyle="margin-left: 1.0em;">Ontheright-handsideoftheplugin's customization dialog, you will see a button with an icon that looks like a computer'shard-drive.Usethisbuttontoexportthehighlightedkeytoafile(*.b64).Usedforbackuppurposesortomigratekeydatatoothercomputers/calibreinstallations.Thedialogwillpromptyouforaplacetosavethefile.</p>
<pstyle="margin-left: 1.0em;">Atthebottom-leftoftheplugin's customization dialog, you will see a button labeled "Import Existing Keyfiles". Use this button to import existing *.b64 keyfiles. Used for migrating keyfiles from older versions of the plugin (or keys generated with the original I <3 Cabbages script), or moving keyfiles from computer to computer, or restoring a backup. Some very basic validation is done to try to avoid overwriting already configured keys with incoming, imported keyfiles with the same base file name, but I'msurethatcouldbebrokenifsomeonetriedhard.Justtakecarewhenimporting.</p>
<pstyle="margin-top: 0.5em;">Ifyoufindthatit's not working for you (imported Barnes & Noble epubs still have DRM), you can save a lot of time and trouble by trying to add the epub to Calibre with the command line tools. This will print out a lot of helpful debugging info that can be copied into any online help requests. I'mgoingtoaskyoutodoitfirst,anyway,soyoumightaswellgetusedtoit.;)</p>
<p>Openacommandprompt(terminal)andchangetothedirectorywheretheebookyou're trying to import resides. Then type the command "calibredb add your_ebook.epub" **. Don'ttypethequotesandobviouslychangethe'your_ebook.epub'towhateverthefilenameofyourbookis.Copytheresultingoutputandpasteitintoanyonlinehelprequestyoumake.</p>
<p>Anotherwaytodebug(perhapseasierifyou're not all that comfortable with command-line stuff) is to launch calibre in debug mode. Open a command prompt (terminal) and type "calibre-debug -g" (again without the quotes). Calibre will launch, and you can can add the problem book(s) using the normal gui method. The debug info will be output to the original command prompt (terminal window). Copy the resulting output and paste it into any online help request you make.</p>
<p> </p>
<p>**Note:theMacversionofCalibredoesn't install the command line tools by default. If you go to the 'Preferences' page and click on the miscellaneous button, you'llseetheoptiontoinstallthecommandlinetools.</p>