Home Assistant

Orion integrates with Home Assistant in both directions: push a notification the moment a followed episode, movie, or game releases, expose sensors for dashboard cards, and let HA mark things watched or trigger a sync.

There are two ways to wire this up:

Native integration (recommended): hemiproductions/orion-homeassistant, installed via HACS. Add it from HA’s Settings → Devices & Services → Add Integration → Orion, paste in your Orion URL + API token, and it creates the sensors, button, and services for you — no YAML required. See that repo’s README for setup.
Manual (no HACS): hand-write a webhook automation and REST sensor against Orion’s HTTP API, described below.

Both approaches use the same Orion endpoints, authenticated with your personal API token (Orion’s Settings page).

1. Webhook notification (push to your phone)

In Home Assistant, create a webhook-triggered automation: Settings → Automations → Create Automation → skip → add trigger → Webhook, then switch to YAML mode:

alias: Orion – new release
trigger:
  - platform: webhook
    webhook_id: orion-release
    allowed_methods: [POST]
    local_only: false
action:
  - service: notify.mobile_app_<your_phone>
    data:
      title: >
        {% set icon = {"episode": "📺", "movie": "🎬", "game": "🎮"} %}
        {{ icon[trigger.json.type] }} {{ trigger.json.title }}
      message: "{{ trigger.json.subtitle }}"
      data:
        image: "{{ trigger.json.poster }}"
        tag: "{{ trigger.json.item_key }}"
mode: queued

Find your webhook’s full URL under the automation’s trigger, or construct it yourself: https://<your-ha-instance>/api/webhook/orion-release. Set it as your Orion webhook URL (see Webhooks for payload details and current availability). Orion checks for new releases every 30 minutes.

2. Reading data: a watch-list sensor

GET /api/machine/summary is the consolidated feed — one request returns counts, the next episode up, your watch list, and this week’s schedule. Example REST sensor:

sensor:
  - platform: rest
    name: Orion Today
    resource: "https://orionmedia.app/api/machine/summary?token=<your_api_token>"
    value_template: "{{ value_json.counts.airingToday }}"
    json_attributes:
      - next
      - upNext
      - today
      - week
    scan_interval: 900

And a dashboard card that lists the week from it:

type: markdown
content: >
  {% for item in state_attr('sensor.orion_today', 'week') %}
  - **{{ item.show }}** {{ item.episode }} — {{ item.air_date }}
  {% endfor %}

3. Writing back: mark watched, trigger a sync

The token-authed write endpoints let an automation or dashboard button change Orion state directly — this is what the native integration’s orion.mark_watched service and button.orion_sync call under the hood:

POST /api/machine/watched — mark an episode/movie/game watched or unwatched
POST /api/machine/follow — follow/unfollow or archive
POST /api/machine/sync — immediate catalog refresh + notification check

Payload shapes are in the endpoint reference.

The HA Companion App can place any sensor (including sensor.orion_today) in an Android widget: long-press the home screen → Widgets → Home Assistant → Sensor/Template. That said, Orion’s own native widgets are richer — posters, theming, and tap-to-open — if you have the Orion app installed.

Home Assistant

1. Webhook notification (push to your phone)

2. Reading data: a watch-list sensor

3. Writing back: mark watched, trigger a sync

4. Android home-screen widget via HA