Skip to main content

A fiction downloader, capable of retrieving works of fiction from the net and saving them in afew common file formats.

Project description

fiction-dl (1.1.1)

fiction-dl is a command-line utility used for downloading works of fiction from the web, formatting them and storing them in a few common file formats. It requires a Python interpreter installed, version 3.8 or higher.

I've created it mostly as an exercise in Python - the good old FanFicFare serves the same purpose and has a much longer list of supported sites. It can also update already downloaded stories, not to mention that it can be used as a Calibre plug-in just as well as a command-line tool! But with all that said, fiction-dl does have some adventages over FFF:

  • It supports some sites FFF doesn't (Reddit).
  • It can generate ODT and PDF files.
  • It applies some typographic corrections to downloaded texts.
  • It has much more verbose output.


Downloading stories

fiction-dl is capable of downloading stories from following sites:

Original Fiction

Formatting stories

Downloaded stories can be saved in following file formats:

(Creating PDF output files requires LibreOffice installed on the machine.)

Embedding images

The application can download images found in story content and embed them in output files.

Typographic corrections

fiction-dl can apply basic typographic corrections to the content of downloaded stories.


You can install fiction-dl using pip:

pip install --upgrade fiction-dl

(If the package's already installed, this command will also update it.)


To download a story from a URL, simply type:

fiction-dl URL

In order to download multiple stories, create a text file and place the URLs in it, each one in a separate line. Then type:

fiction-dl YourFilesName

fiction-dl offers a few options - you can view them using following command:

fiction-dl -h


GNU GPL 3. The text of the license is provided in the Docs/License.txt file.


All changelogs can be found in the Docs/Changelogs directory.



You can generate code documentation using Doxygen; the relevant configuration file is Docs/Docs.doxygen. Generated files will appear in the Docs/Code Documentation directory.


Launching the Integration Test can be done by entering the Tests directory and executing the following code:

python "Integration Test"

In order to launch unit tests, enter the Tests directory and execute:

python "Unit"

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fiction-dl-1.1.1.tar.gz (51.2 kB view hashes)

Uploaded Source

Built Distribution

fiction_dl-1.1.1-py3-none-any.whl (95.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page