Skip to main content

Local mirror for Internet fiction sites

Project description

ffmirror is a program to create and maintain a local mirror of stories on fiction-publishing sites. It has functionality for downloading stories similar to FanFicFare or other projects, but the differentiating factor is support for creating a local database that maintains downloaded metadata and can automatically update authors that are followed.

ffmirror has two currently maintained script entry points:

  • ffdl is a simple one-story file downloader. It takes a single URL and writes an HTML file story.
  • ffdb is the manager for local fanfic site mirrors. These maintain a local copy of metadata for a set of followed users alongside copies of all their stories.

The remaining entry points, ffadd, ffup, ffcache are designed for an older format of mirror, and are now deprecated.

ffmirror can be installed via PyPI: pip install ffmirror

To create a mirror, enter an empty directory and issue:

$ ffdb init

This initializes the SQLite database that tracks metadata. You can now add authors by issuing:

$ ffdb add $AUTHOR_URL

Adding an author will immediately download all their stories into the mirror. Stories are stored under top-level directories per author.

Updating the mirror will recheck all authors that have been added and download any new or updated stories. To update the mirror, issue:

$ ffdb update

You can update only one author by issuing:

$ ffdb update $AUTHOR_DIR

where AUTHOR_DIR is the directory with that author’s stories.

Project details


Download files

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

Files for ffmirror, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size ffmirror-0.3.1-py3-none-any.whl (26.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size ffmirror-0.3.1.tar.gz (22.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page