This project aims to easily and quickly turn any Web Fiction into an eBook for your eReader.
You need Python 3 and uv.
Clone the repository and install dependencies:
uv sync
After installation, you can use the scraper:
uv run webfictionscraper.py --help
Run the scraper using a fiction config file:
webfictionscraper run <CONFIG_NAME>
For all available options, use the --help
flag.
Alternatively, you can start the interactive mode:
webfictionscraper interactive
Download one, multiple, or all configs from the config repository.
List them with webfictionscraper list-configs --remote
.
Then download them with webfictionscraper download-config [NAME]
.
Or download them all with webfictionscraper download-config --all
.
Alternatively, start the interactive mode with webfictionscraper interactive
and select Download config(s).
Create your own config file. For examples and documentation, see the config repository.
The scraper can automatically generate configs for fictions on poplar sites like RoyalRoad or FictionPress with the
webfictionscraper generate-config [URL]
command.
Alternatively, start the interactive mode with webfictionscraper interactive
and select Generate config.