Plex, from your phone.

Cupola is a free, open-source app for Plex on iPhone, iPad, Android and Mac. It connects straight to your own Plex, with no account.

What Cupola does with Plex

  • The same session-first board, driven by Plex's own semantics: libraries, on deck, devices, playlists
  • Stop a session

Control: Read + stop. Signs in with: Token.

How well it is tested

Partly verified: Cupola's screens have read a real Plex, but its actions have not been tried on one yet. If you run Plex, tell us how it goes.

Connect Plex

Before you start. It must be a long-lived device token: one beginning "eyJ" expires in 7 days and Cupola cannot renew it without contacting plex.tv.

  1. Its address, with the port: http://192.168.1.20:32400 by default, or your reverse proxy's address. More on addresses.
  2. The token, in Plex's web interface: any item → Get Info → View XML → copy X-Plex-Token.
  3. 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 Stream

Questions

Is there a Plex app for iPhone and Android?

Yes: Cupola, free and open source, connects to Plex directly. It is a public TestFlight beta on iPhone, iPad and Mac, and an APK on Android. See install.

Where do I find the Plex token?

In Plex's own web interface: any item → Get Info → View XML → copy X-Plex-Token.

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.

Get Cupola

Free and open source. It works with the services you already run.

iPhone and iPad

TestFlight beta, from Apple

Android

APK from GitHub releases