fimfic2epub

This is a tool to generate better EPUB ebooks from fimfiction stories. It's also a Chrome/Firefox extension, replacing the default EPUB download option with this tool.

Screenshot of the Chrome extension

Demo

You can have a look at what a generated EPUB looks like here. It was generated from the story Summer Island.

Usage (browser extension)

You can download the Chome extension from Chrome Web Store and Firefox Add-ons

Installation & usage (command line)

You can install the tool by running npm install -g fimfic2epub. You can then run it like this:

$ fimfic2epub <story id/url> [<optional filename>]

By default the EPUB will be saved in the current working directory with the filename Title by Author.epub. Run fimfic2epub --help to see a list of all flags.

Examples

Download with automatic filename:
$ fimfic2epub --paragraphs indented --reading-ease 289663
$ fimfic2epub https://www.fimfiction.net/story/289663/summer-island

Download and save to a specified dir/filename:
$ fimfic2epub 289663 path/to/file.epub
$ fimfic2epub --dir path/to/my/dir 289663 ebook_%id%.epub # %id% gets replaced by the story id

Building

Make sure Node.js is installed. After you've cloned this repository, run npm install and npm run build to build it. This project uses gulp. Run npm run dev for a quicker development build. You can add watch to both for automatic rebuilding.

Development

Make sure gulp is installed.

When working on the code and testing it in a web browser as an extension, you can run gulp in watch mode: gulp watch. This will lint code and build it when you save. To build, just run gulp or npm run build. To lint, run gulp lint and to clean, run gulp clean.