fimfic2epub


!fimfic2epub logo

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. If you're on an Arch Linux-based system you can install it from the Arch User Repository.

Screenshot of the web extension

Features
--------
* The generated ebook is in modern EPUB3 format with fallbacks for older EPUB2 reading systems
* Improved styling and formatting of content compared to Fimfiction's export options
* Cover image can be changed from an image file or url
* Downloads and embeds artwork from the story inside the EPUB file, including YouTube thumbnails, for optimal offline reading and archiving (optional)
* Rating, tags, status, story description and more info are available on the title page
* The table of contents page includes chapter modification dates and word counts
* Option to put all author notes in an index at the end of the ebook
* Option to not add a title heading for chapters (in case the story has its own)
* Tweak paragraph style from double-spaced to indented (similar to book typesetting, may not look good on every story)
* Emoji, icon and webp support (webp images gets converted to png)
* Calculate the Flesch reading ease value of the story
* Customize metadata of the generated ebook, such as title, author, subjects and description
* Command line tool with same features as the web extension

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

Usage (web 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. On Arch Linux-based systems you can install it from the AUR like this: yay -S fimfic2epub (replace yay with your favorite AUR-helper)

You can then run the tool it like this:

$ fimfic2epub []

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

``
Usage: fimfic2epub [options] [filename]

Tool to generate improved EPUB ebooks from Fimfiction stories

Options:

-V, --version output the version number
-d, --dir Directory to store ebook in. Is prepended to filename
-t, --title Set the title of the story
-a, --author Set the author of the story
-T, --typogrify Enable typographic fixes (smart quotes, dashes, ellipsis, ordinal)
-c, --no-comments-link Don't add link to online comments
-H, --no-headings Don't add headings to chapters (includes chapter title, duration and word count)
-W, --no-chapter-word-count Don't add word count to chapter headings
-D, --no-chapter-duration Don't add time to read to chapter headings
-b, --no-bars Don't add chapter bars to show reading progress
-r, --no-reading-ease Don't calculate Flesch reading ease
-e, --no-external Don't embed external resources, such as images (breaks EPUB spec)
-n, --no-notes Don't include author notes
-i, --notes-index Create an index with all author notes at the end of the ebook
-p, --paragraphs