CalibreFanFicManagement

A commandline utility to fill my own needs for managing fanfic on Calibre.

Currently, there is one command, download, which is adapted from AutomatedFanFic. It will scrape bookmarks from a user's AO3 account, download the works as epub files and add them to a calibre library.

Planned:

• mass editing of calibre tags for fanfics
• deduplicating AO3 bookmarks in cases where I have both a series and individual works bookmarked
• statistics about bookmarked/downloaded fics
• import from page with list of urls, e.g. collection or author page
• import all works from author

Usage

If you want to save bookmarks in a calibre library, you will need to install the calibre CLI.

• Clone this repository and cd into the CalibreFanFicManagement directory
• git submodule update --init
• pip install -r requirements.txt
• If needed, copy config.ini.dist to config.ini and fill in
• Copy FanFicFare example config to personal.ini and fill in necessary fields
  • NB: if you want to include images in your downloaded fanfics, you must set include_images: true in personal.ini. See the FanFicFare docs for more details.
• python fanficmanagement.py download -C config.ini
• For help: python fanficmanagement.py -h

Resources

• Calibre CLI
• FanFicFare
• Unofficial ao3 client and my fork with custom changes
• AutomatedFanFic

Requirements

I want to:

• import fics from my AO3 bookmarks into Calibre
• convert AO3 tags into Calibre tags by appending 'ao3.' to them, e.g.

`Hurt/Comfort` -> `ao3.Hurt/Comfort`

• see a progress bar while importing
• do the tag conversion both while importing and as a batch operation on existing fanfics in Calibre
• get aggregate metadata about fics in my Calibre library, e.g.

100 stories and 100,000 total words in fandom Vampire Chronicles

• find out whether I have bookmarks for stories that are part of a series that is also bookmarked