Using Bookpedia, SQLite, Book+ and PowerShell to Organize Your e-Book Collection

This setup is so unlikely, I doubt anyone on the ‘net will be looking for this solution but: if you’re an eBook loving Windows developer who uses a Macbook Pro for your primary workstation, this may appeal to you.

My Macbook Pro runs Windows 7 within Parallels. It’s fast and slick and I <3 it. My eBook reader of choice is the Book+ iPad App. I recently switched from GoodReader to Book+ because of its support for Smart Folders. And I back this all up to SugarSync which I picked for the price, privacy policy and Book+ integration.

My eBook organizer is Bookpedia. If you’re unfamiliar with this (MacOS only) program, it’s basically a really advanced eBook library/organizer. What I love most about it is that it easily populates your eBook’s metadata using various web services – including Amazon! – then stores it all to a SQLite database.

My eBook collection looked nice enough in Bookpedia: Initially, I dragged ebooks onto the dock to import, named them properly and populated their metadata using Amazon. The problem was that my files were all over the place and practically unsyncable with SugarSync and ultimately, Book+. Look how awesome:

I’m only a perfectionist when it comes to some things, and ebook organization is one of them. I want my eBooks’ naming convention to be as obvious as possible: Amazon’s full book title – Publisher – ISBN. I finallly accomplished this using a number of tools and a few hours of coding. Here’s my setup:

  • Windows 7 in Parallels with Z: mapped to my Home directory on my Mac.
  • Amazon developer account
  • eBooks that are scattered all over my home directory but organized nicely in BookPedia using data
  • SQLite Studio for Windows
  • Desired single directory destination: ~/Books in Mac or Z:\Books in Windows

First thing you wanna do is make a backup of your Bookpedia database.

cp ~/Library/Application\ Support/Bookpedia/Database.bookpd ~/Library/Application\ Support/Bookpedia/backup.bookpd

Next, load it up into SQLite. Databases -> Add Database -> Z:\Library\Application Support\Bookpedia\backup.bookpd.

    title     TEXT,
    filename    TEXT,
    pubdate TEXT,
    publisher TEXT,
    isbn TEXT,
    asin TEXT

insert into export
select a.ztitle, b.zurl, strftime('%Y',date(zreleasedate,'unixepoch'))+31 as pubdate, 
a.zpublisher, a.zisbn, a.zasin
from zentry a join zlink b on a.z_pk = b.zentry
--where b.zurl not like '%YOUR MAC DESTINATION DIR%'

This script creates a new table because that’s the only way SQLiteStudio exports data into tsv (tab separated values, which I generally prefer to CSVs) format. Once the table is created, I use a right click to export the it to C:\bookpedia.tsv, making sure to check the “column names as first row” option and ensuring the output is ascii encoded.

Now that we’ve got our TSV file, we’ll run it against the PowerShell script below. Copy this code and save it as whatever.ps1

# winbasedir = Parallels mapped drive
$winbasedir = "Z:\"
$windestination = "Z:\books\"
$macusername = "chrissylemaire"
$csvfile = "C:\newstructure.csv"
$macdir = "file:///Users/$macusername/"

# import csv file that contains two columns, directory and filename
$csv = Import-Csv "c:\bookpedia.tsv" -Delimiter "`t" 
$newcsv = @() 

foreach ($item in $csv)
  if ($item.filename) {
    $source = $item.filename.Replace($macdir,$winbasedir)
    $source = $source.Replace("/","\")
    $extension = $source.substring($source.length - 4, 4)
    $title = $item.title

    # Set the file's new name. In my case, I wanted Book Title - Year - Publisher - ISBN
    if ($item.pubdate) { $title = $title + " - " + $item.pubdate} 
    if ($item.publisher) { $title = $title + " - " + $item.publisher}  
    if ($item.isbn) { $title = $title + " - " + $item.isbn }

    # No clue why GetInvalidFilenameChars doesn't do this right...
    # Copy-Item will not allow the characters below
    $newname = $title.Replace(":"," -") 
    $newname = $newname.Replace("  "," ")
    $newname = $newname.Replace("\","-")
    $newname = $newname.Replace("/","-")
    $newname = $newname.Replace("?","") # ascii encoding changes weird chars to "?"
    $newname = $newname.Replace("[","") 
    $newname = $newname.Replace("]","")
    $newname = $newname.Replace("*","-")
    $target = $windestination+$newname+$extension

    if ((test-path($source)) -and !(test-path($target)))
      Copy-Item -path $source -destination $target -whatif

      # If the copy succeeded, add it to a CSV file that 
      # Bookpedia will use to import the new clean structure
      if (test-path($target))
        $newline = New-Object System.Object
        $mactarget = $target.Replace($windestination,$macdir+"Books/")
        $mactarget = $mactarget.Replace("\","/")
        Add-Member -inputobject $newline -name link -value $mactarget -MemberType NoteProperty
        Add-Member -inputobject $newline -name title -value $item.title.Replace("?","") -MemberType NoteProperty
        Add-Member -inputobject $newline -name isbn -value $item.isbn -MemberType NoteProperty
        Add-Member -inputobject $newline -name asin -value $item.asin -MemberType NoteProperty
        $newcsv += $newline

$newcsv | export-csv $csvfile -noType -Force
mv $csvfile $winbasedir -Force

One thing to note: I did write this script so that it can be run multiple times. So each time you’ve got a batch of books that need to be cleaned up, you can just run it again without destroying your library.

So once the script has finished running, the fruits of its labor will look something beautiful like this:

Now that we’ve got the files copied (I don’t recommend moving them, just in case something happens) and the new csv import file has been created, we’ll open it in Bookpedia. First, though, I made another backup of this Bookpedia database then deleted my library. Now it’s time to import the “clean” collection. Bookpedia -> File -> Import Collection.

The columns will automatically map properly because the script and Bookpedia are awesome like that.

Now Bookpedia has enough information to populate the metadata. As I said before, I chose the Amazon option for this.

So now I use SugarSync to sync up that Books directory and then use Book+ to keep that directory in sync on my iPad. What’s super great about Book+, too, are the Smart Folders. Say SugarSync syncs a new PowerShell book, it will automatically appear in my PowerShell Smart Folder. Whaaaat!

Ladies and Gentlemen… the prodigiousness:

Anyone wanna rewrite this in AppleScript for me?

Chrissy is a Cloud and Datacenter Management & Data Platform MVP who has worked in IT for over 20 years. She is the creator of the popular SQL PowerShell module dbatools, holds a master's degree in Systems Engineering and is coauthor of Learn dbatools in a Month of Lunches. Chrissy is certified in SQL Server, Linux, SharePoint and network security. You can follow her on Twitter at @cl.

Posted in OS X & iPhone, PowerShell