AO3 OPDSAll guides

Setup guide

KOReader

KOReader has a built-in OPDS client with dedicated username and password fields per catalog, so authentication is a native part of adding the feed — no extra tricks needed.

Setting up the catalog

  1. 1

    Open the file browser menu

    From KOReader's home screen (the File Browser), open the top menu, then tap the magnifying glass (🔍) icon.

  2. 2

    Open "OPDS catalog"

    Tap OPDS catalog in the menu that appears. This opens the list of catalogs you've added.

  3. 3

    Add a new catalog

    Tap the + icon to add a new catalog, then fill in a display name and the Catalog URL:

    https://ao3-opds.abelmuak.com/opds/v1

    KOReader reads Atom/XML (OPDS 1.2), so use the /opds/v1 address.

  4. 4

    Browse and download

    Tap the catalog name to browse recent works, and tap an entry to download its epub.

Adding authentication (optional)

If you want to see restricted or mature AO3 works, add your AO3 credentials directly to the catalog entry.

  1. 1

    Edit the catalog entry

    When adding (or editing) the https://ao3-opds.abelmuak.com/opds/v1 catalog, the same dialog includes optional Username and Password fields below the URL.

  2. 2

    Enter your AO3 credentials

    Fill in your AO3 username and password there, then save the catalog.

Note: those fields send a standard HTTP Basic Auth header with every request to that catalog. Only use this on a device you trust, and prefer an https:// URL if your server supports it, so the credentials aren't sent in plain text over the network.
← All guides