PDF2Nook

PDF2Nook is a Ruby-based CLI tool designed to convert regular PDF files and make them more readable on Barnes & Nobel Simple Touch Nook reader and maybe some other small 6-inch e-ink readers…

What PDF2Nook actually does

What it looks like

Not readable PDF page in portrait mode:

Converted to two more readable pages in landscape mode with preservation of key bindings:

Dependencies

Under the hood PDF2Nook uses a bunch of tools and libraries to work with PDF and to make all this kind of magic, so it has some dependencies:

Installation

To install PDF2Nook just run: [sudo] gem install pdf2nook

In addition, if you had any problems with building native extension for RMagick, try installing the following stuff (tested on Ubuntu) and reattempt PDF2Nook installation after that:

sudo apt-get install ruby2.0
sudo apt-get install librmagick-ruby libmagickcore-dev libmagickwand-dev
sudo gem install rmagick

or following on OS X:

brew install imagemagick
brew install ghostscript
brew install coreutils    # important!

or using GUI: ImageMagick installer for Mac OS X

Usage

pdf2nook [OPTIONS] PATH

Parameters:
    PATH                          PDF file path to convert it

Options:
    -c, --colors COLORS           output grayscale colors count (default: 16)
    --rotate                      set this flag if you set up your bottom buttons to flip pages forward
    --cleanup                     set this flag if you want to clear tmp files after converting
    -h, --help                    print help

Examples

Known issues

Here I want to note the known problems. Some of them I will try to fix in the future, but some of them do not seem so problematic, to complicate the code because of them and invent bicycles…

Help and contribution

As you can see, English and even Ruby are not my native languages :) So I understand that here I might have a ton of mistakes and stylistic problems. I will be very grateful to get any assistance with typo and grammar correction in README. And it will make it even happier if I get your help with improvement of code quality for the output pdfs. So feel free to make Pull requests and/or bug report issues.

Contributing to pdf2nook

Special thanks

Copyright © 2014 Serge Bedzhyk. See LICENSE.txt for further details.