/CalibreFanFicManagement

Primary LanguagePython

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

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