bookmobile
==========

exquisitecorp

------------------------------------------------------------------------

An attempt at building my own offline article collector. In progress.
[]()

You can not select more than 25 topics Topics must start with a letter
or number, can include dashes ('-') and can be up to 35 characters long.

![](https://tildegit.org/avatars/6b068f4f161a778ab36bcdb68fa37302?size=48 "exquisitecorp")
[**lee2sman**](https://tildegit.org/exquisitecorp)
[c2cae799b9](https://tildegit.org/exquisitecorp/bookmobile/commit/c2cae799b9416a604e05a1004291ff5831a9a8d9)
[switched backend to readability-cli rather than roll my
own](https://tildegit.org/exquisitecorp/bookmobile/commit/c2cae799b9416a604e05a1004291ff5831a9a8d9)

3 minutes ago

[lib](https://tildegit.org/exquisitecorp/bookmobile/src/branch/master/lib "lib")

[add
comments](https://tildegit.org/exquisitecorp/bookmobile/commit/84532321282d4c7b54994e7bc05692420893b805 "add comments")

2 hours ago

[themes](https://tildegit.org/exquisitecorp/bookmobile/src/branch/master/themes "themes")

[initial
commit](https://tildegit.org/exquisitecorp/bookmobile/commit/fd4e58e425482442be67465cb48838e157c3407e "initial commit")

2 hours ago

[README.md](https://tildegit.org/exquisitecorp/bookmobile/src/branch/master/README.md "README.md")

[update
README.md](https://tildegit.org/exquisitecorp/bookmobile/commit/24a34721d653d45e75bf35b14cd4e01b9f6470b5 "update README.md")

6 minutes ago

[bookmobile.fish](https://tildegit.org/exquisitecorp/bookmobile/src/branch/master/bookmobile.fish "bookmobile.fish")

[switched backend to readability-cli rather than roll my
own](https://tildegit.org/exquisitecorp/bookmobile/commit/c2cae799b9416a604e05a1004291ff5831a9a8d9 "switched backend to readability-cli rather than roll my own")

3 minutes ago

Simple command line script to download articles for offline viewing as
markdown, simplified clean HTML and epub.

This is a fishscript (shell) gluing together pandoc and a Node.js
package that implements the Firefox reader view. It uses a NPM package
that uses Mozilla's own reability javascript. If that's not the right
solution for you, jump down to the alternatives section at the end.

### Dependencies

-   fish
-   Pandoc
-   Node.js / NPM

Note: you must have the following sub-directories: originals/ reader/
epubs/ markdown/

### Install

    npm install readability-cli
    git clone https://tildegit.org/exquisitecorp/bookmobile.git
    cd bookmobile
    chmod +x bookmobile.fish

### Usage

    ./bookmobile.fish URL

Output:

A simplified HTML document will be saved to originals. A reader view
with chosen (or default) theme will be saved to reader/. An epub in
epubs/ and a markdown file to markdown sub-directory.

### To change themes

The themes subdirectory contains several custom simple themes for
rendering a nice reader view. You can edit these or add your own custom
theme to this folder. Change the theme selection in line 3 of the
bookmobile.fish file.

### Alternatives

Currently there are a number of CLI programs that are ports of the
Readability project. These may serve your needs better.

A partial listing can be found
[here](https://github.com/masukomi/arc90-readability#readability-10)
