Home screen widgets

The Android app ships two widgets:

• Upcoming is a scrollable list of your full watch list (aired episodes you haven’t watched yet) plus a Coming this week section of episodes airing in the next 7 days. Tapping a row opens that show in the app.
• Up Next is a compact 4×1 strip of what’s airing soon, for when you want a glance without giving up half a screen.

Both refresh automatically about every 15 minutes, and the Upcoming widget has a refresh icon in its header for an immediate update.

Add a widget

1. Long press an empty spot on your home screen → Widgets → Orion.
2. Drag Upcoming or Up Next onto the screen.
3. The configuration screen opens. Enter:
   • Server URL: https://orionmedia.app
   • API token: copy it from Orion’s Settings → For developers → API token (what’s this?)
4. Tap Test connection to confirm the URL and token work, then Save.

Tip

The first widget you configure also signs the app itself in for release notifications. No separate setup needed.

Theming

Each widget is themed independently from its config screen:

• Background color and transparency
• Header and accent color with its own transparency
• Text color
• Corner radius
• Item size: compact, normal, or large (smaller rows fit more items, larger rows show more detail)
• Toggles for episode posters and the “Coming this week” section

Colors are entered as #RRGGBB hex values, transparency as a percentage.

Reconfiguring

Android only shows a widget’s configuration screen when it’s first placed. To change the server URL, token, or theme, remove the widget and add it again.

Troubleshooting

• Empty widget or “check connection” message: recheck the server URL and API token (regenerating the token in Settings invalidates the old one, see Authentication). Then add the widget again with the new token.
• Stale data: tap the refresh icon in the Upcoming widget’s header. Android also pauses background refresh for apps you haven’t opened in a while, so opening the Orion app wakes it back up.