Readarr, from your phone.
Cupola is a free, open-source app for Readarr on iPhone, iPad, Android and Mac. It connects straight to your own Readarr, with no account.
What Cupola does with Readarr
- Author pages with every book and where it stands
- Search, monitor and delete
- Adding authors is left out: Readarr is retired and its metadata service no longer answers
Control: Manage. Signs in with: API key.
How well it is tested
Partly verified: Cupola's screens have read a real Readarr, but its actions have not been tried on one yet. If you run Readarr, tell us how it goes.
Connect Readarr
Before you start. Readarr development has stopped upstream. Existing instances keep working against its last released API, but expect no new server-side fixes.
- Its address, with the port:
http://192.168.1.20:8787by default, or your reverse proxy's address. More on addresses. - The API key, in Readarr's web interface: Settings → General → API Key.
- Test it before you save. If it fails, Cupola tells you why.
Away from home, Cupola uses your VPN or reverse proxy: how that works.
Also in Media
Questions
Is there a Readarr app for iPhone and Android?
Yes: Cupola, free and open source, connects to Readarr directly. It is a public TestFlight beta on iPhone, iPad and Mac, and an APK on Android. See install.
Where do I find the Readarr API key?
In Readarr's own web interface: Settings → General → API Key.
How do I manage my home server from my phone when I am away?
With the route you already have: a VPN such as WireGuard or Tailscale, or a reverse proxy. Give a connection a second address for when you are out, and Cupola uses whichever one answers.
My services are behind a reverse proxy with a self-signed certificate. Will it work?
Yes. Cupola asks once before trusting a certificate, then pins it to that host. Cloudflare Access tokens, proxy passwords and custom headers work too.