1# Add cover images to EPUBs from AO3
2
3This tool lets you add an auto-generated cover image to an EPUB file you’ve downloaded from AO3.
4This makes it easy to find your favourite fic if you’re scrolling a grid view.
5
6<img src="screenshot.png">
7
8To understand the motivation behind this tool and how it works, you can read my [accompanying blog post](https://alexwlchan.net/2025/ao3-epub-covers/).
9
10## Development
11
12To run tests:
13
141.  Start a local web server in this folder (e.g. `python3 -m http.server 4343`)
152.  Open the file `tests.html` as served by that web server
16
17This will run unit tests in the browser using QUnit.
18This is because the app runs in the browser, and certain things (e.g. `<canvas>`) are much easier to test in a real browser environment than anywhere else.
19You need to use an HTTP server rather than opening the file because it needs to fetch some ZIP files, and that doesn't work over `file://`.
20
21## Deployment
22
23Run the `deploy.py` script.
24This will compile the app into a single JavaScript file, then upload it to my web server.