Download

What is this?

A way to easily read fics downloaded from AO3 both on your computer and your phone. Along with the ability to see what other fics you have downloaded with the same tag.

Features:

  • Tag index
  • Dark and light mode
  • Usable on phone

Possible future features:

  • Sorting fics by alphabetical order
  • Making the dark mode look less shit on the index page
  • Turning authors into indexed tags
  • Hit count
  • Choosing between one page per chapter or all in one page

Unplanned Features:

  • Downloading fics in the interface
  • Text search

Install Guide:

Download the shota omegaverse fiction of your choice from AO3's HTML download option.

Add your htmls downloaded from AO3 to the config.json. I would recommend using a more advanced text editor then notepad for better indentation support like notepad++ or vscodium. Your original fics can be saved pretty much anywhere your computer, it shouldn't matter.

Make sure your slashes are correct and you have a comma at the end of every line but the last one.

Now install python. I use 3.10.11 but as long as it's a recent-ish python3 version you should probably be fine. Make sure to choose the option to install pip and to add to path.

Now open up a command prompt in the directory with the config file and converter.py

I use venv to keep my global python clean but this is optional.
If you also want to use venv then run python -m venv venv and then venv\scripts\activate. You'll need to activate your venv every time you want to run converter.py

Everything after this is the same whether or not you use venv. If you are using venv, make sure it's activated when you use pip and run the converter.

Run pip install bs4 jinja2 and then run python converter.py in the command line.
Hopefully you will have no errors whatsoever.

Now you can open a new command prompt in the site folder and run python -m http.server 8000
Then open http://127.0.0.1:8000/ in your browser of choice.

You only need to run converter.py again when adding new fics to your config, you can also run converter.py while the server is running and it'll update on refresh.

There are a variety of options for getting this on your phone. I use tailscale. Tailscale works for both android and ios but I've only ever used it on android.
Install Tailscale on your phone and your computer. Replace the "127.0.0.1" part of http://127.0.0.1:8000/ with the address or name of the computer as seen on your tailscale dashboard. Use that as the web address for your phone's browser.

Screenshots:

Edit

Pub: 29 Mar 2025 09:02 UTC

Edit: 29 Mar 2025 09:55 UTC

Views: 103