Dan Fixes Dot Blog

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Setting up Calibre for the easy ebook life ======
Calibre is free ebook management software that can convert any ebook format to any other ebook format.  It was made not by a corporation but by a community of voracious readers and librarian-sorts, and it doesn't care at all what Amazon or Barnes & Noble would prefer you do with the ebooks you bought and paid for.  It eats bullshit for breakfast.  Let's get it set up.

Important note: these instructions are for people who have a Sony PRS-505 ereader, because [[oldtech:prs505|I bought a big stack of them off eBay and have been distributing them to my friends]], but the information in here is broadly applicable to most ereaders.


===== Step 0: fix your file manager =====
Default Windows and Mac behaviour is to hide filename extensions, so that book.epub and book.pdf and book.doc and book.exe and book.horriblevirus all look the same.  Damn near every how-to-do-a-thing-on-your-computer guide will begin with how to fix this nonsense, and this guide is no exception, so here we go:

=== In Windows 10 ===
Launch File Explorer (windows key + E), then click on the "View" tab and check the "File Name Extensions" box.

=== In Windows 11 ===
Launch File Explorer (windows key + E), then click View > Show > File Name Extensions.

=== On a Mac ===
Open Finder, choose Finder > Settings, then click Advanced.  Select "Show all filename extensions."

=== On Linux ===
You don't have to do anything, but try not to be smug about it, Mister Smuggy Smugsson



===== Step 1: Download and install Calibre =====

Leave your ereader disconnected for now, and go to calibre-ebook.com, hit Download, and download Calibre.

On Windows this will be a .msi file.  Double-click it once downloaded, and the Calibre installation dialogue appears.

If you're on Linux, heed the instruction not to use your built-in package manager (no really, heed it), and follow the instructions for Linux.

Once installation has started, the GNU public license appears.  Click "I accept the terms in the license agreement."  Read it if you want or skip it, whatever, I'm not your boss.  Click on Install, there's no need to click Advanced.

If Windows pops up a thingy asking if you meant to do that thing that you just did, tell it Yes.

Installation will happen pretty quick.  Click Finish, and Calibre launches.



===== Step 2: First time Calibre setup =====

Calibre's first-time setup (Welcome, Wizard!) asks for your language and where you want it to keep its library data.  Choose an **empty** folder on your hard drive, or leave the option at default (this'll be something like "Calibre Library" in your home folder).  Click on Next.

**Beware:** if you already have a folder full of ebooks, **don't tell Calibre where it is.**  This is not what Calibre is asking for, here.  Choose an **empty** folder.  Calibre is going to make **copies** of your ebooks, inside this folder, and fiddle with them.  If you already have a collection of ebooks, you don't want Calibre fiddling with it!

When Calibre asks you to choose your e-book device, choose SONY from the left, and on the right, choose "All other SONY devices."  Click on Next.

Calibre rewards you with a hearty message of congratulations for pressing two buttons, and invites you to click Finish.  Click Finish.

Calibre opens up!  But we're not done yet.  We're gonna install a couple of plugins to help make new ebooks work on vintage ereaders.



===== Step 3: Plugin installation =====

Click on Preferences.  A new dialogue appears.  Towards the bottom left, under "Advanced," you'll find Plugins.  Click that.

A new dialogue appears.  At the bottom left, click "Get new plugins."  Using the "Filter by name" text input in the top right, find and install, one by one, the following plugins.  This is done by clicking on their list entry and pressing Install, and then pressing Yes in the following warning dialogue.  After installing each plugin, Calibre will ask if you want to restart; to save time, just press OK, and we'll restart Calibre just once after we've installed the following plugins:

  * "Bulk Image Resizer Plugin" by Artur Kupiec
  * "Resize Cover" by Grant Drake.  This one will pop up a message asking which toolbar to add the plugin to; you can leave the options as default ("The main toolbar" and "The main toolbar when a device is connected") and just click OK.

Now it's time to restart Calibre (just X out the program and then open it again from the Start menu).



===== Step 4: Big easy buttons =====

After Calibre has restarted, our two necessary plugins are installed.  Now we'll give ourselves big easy-to-hit buttons for each step of the ebook conversion process, so that we can do all this without having to think too much, such as we might do at midnight when we're tired and need things to be Simple Damn It.

Go to Prefences, then "Toolbars & Menus" (top of the list towards the middle, under "Interface").  You'll see a drop-down saying "Click to choose toolbar or menu to customize."  Click there, then choose "The main toolbar."

Two lists appear - on the right is a vertically-sorted representation of the current collections of massive buttons running across the top of Calibre, and on the left is a huge and intimidating list of every damn thing that Calibre can do, but fortunately we don't have to worry about that.

Clicking the green rightward-facing arrow moves a button from the massive intimidating feature list into our current toolbar.  Clicking the blue leftward-facing arrow removes the toolbar button and places it back in the massive intimidating list.

In the list on the left, scroll down until you see "Polish Books."  Click on it to highlight it, and then click the green rightward-facing arrow.  Over on the right, you'll now be seeing the tail-end of the toolbar list, with "Polish Books" at the end.

Go all the way back to the drop-down list at the top of this window, where you selected the toolbar you wanted to change, which now says "The main toolbar."  Click on that, and choose "The main toolbar when a device is connected."  And just like before, find "Polish books" in the list on the left, and use the green right-facing arrow to add the Polish Books button to the toolbar.

Click Apply and we're done.



===== Last setup step: First-time plugin configuration =====

The "Resize Cover" plugin needs to be told how big our PRS-505 screen is.  There's a small downward-facing arrow just to the right of the big Resize Cover button on the top toolbar.  Click that, and then in the dropdown menu select "Customize Plugin."

Our PRS-505 has a screen that's 600 pixels wide by 800 tall - but there's a little bar at the bottom of each screen that shows your reading position, and for the absolute best results we want to account for the pixels used up by that little bar.  So we will tell the Resize Cover plugin that we want our covers to measure 600 pixels wide, by 768 tall.  Double-click on the numbers below Width and Height and set Width to 600 and Height to 768.  "Keep aspect ratio" and "Only shrink larger images" should both be checked.  Hit OK to save these settings.

**The Bullshit Removal Machine is now ready to remove bullshit!**

Proceed to the next bit, [[oldtech:calibre:decrapifyandsend|Decrapify and Send]].