Home Assistant Integration Overview

Integration Architecture

Astrion Remote is not a traditional universal remote — it's a physical interaction terminal designed specifically for Home Assistant. All automation logic, device states, and scene definitions remain in Home Assistant, while Astrion provides a tactile, dedicated interface.

This architecture gives you maximum flexibility — all logic stays in Home Assistant, while Astrion provides a fast, reliable, and focused control interface.

Core Features

Quick Start Guide

Prerequisites

• Home Assistant running (Core 2023.1 or newer)
• HACS (Home Assistant Community Store) installed
• Astrion Remote powered on and connected to Wi-Fi
• Both devices on the same local network

Integration Steps

Deep Dive: Physical Button Mapping

Astrion Remote's physical buttons can be mapped in two ways, giving you maximum flexibility:

1. TV Card Button Mapping

Within a TV Card, physical buttons follow the card's mapping. This allows you to have context-aware buttons — for example, the volume buttons control your AVR when watching TV, and control your soundbar when listening to music.

2. Global Shortcut Configuration

For buttons outside any specific card, you can configure global shortcuts in Settings → Shortcut Configuration. These shortcuts work anywhere on the remote.

Deep Dive: Activities & Scripts

Astrion Remote supports Harmony-style activities using Home Assistant scripts. This is the most powerful way to create multi-device workflows.

How It Works

• Create a Home Assistant script that sequences multiple actions
• Bind the script to a physical button or screen button on your TV Card
• One press triggers the entire sequence — turn on TV, switch input, dim lights, close blinds

Example: Movie Night Script

alias: "Movie Night"
sequence:
  - service: remote.send_command
    target: { entity_id: remote.living_room_tv }
    data: { command: "POWER" }
  - service: remote.send_command
    target: { entity_id: remote.living_room_avr }
    data: { command: "POWER" }
  - service: media_player.select_source
    target: { entity_id: media_player.living_room_tv }
    data: { source: "HDMI 1" }
  - service: light.turn_on
    target: { entity_id: light.living_room }
    data: { brightness: 25 }

Learn more about Activities →

Deep Dive: Local IR Control

Starting with V1.2.0, Astrion Remote supports local infrared control through the built-in IR transmitter.

Requirements

• Astrion Remote firmware V1.2.0 or newer
• Astrion Home Integration installed in Home Assistant
• RosCard V1.2.0 or newer

Supported Devices

• TVs (most brands)
• Set-top boxes
• Audio equipment
• Devices with custom IR codes

Full IR control guide →

Deep Dive: Advanced Customization

For advanced users, Astrion Remote supports sideloading third-party applications via ADB (Android Debug Bridge). This unlocks powerful customization options.

How to Enable ADB

• Go to Settings → System → About
• Tap Software Version 7 times to enable Developer Mode
• Connect your remote to a computer via USB-C
• Use ADB commands to install applications

Recommended Apps

• Fully Kiosk Browser — Run full HA dashboards as standalone apps
• KeyMapper — Advanced physical button mapping (launch apps, trigger HA actions)
• Floating Apps — Create overlay controls for quick access

Version History

Key software versions and their Home Assistant integration features:

• V1.4.0 (July 2026) — Custom physical button mapping (TV Card); improved device discovery
• V1.2.0 (June 2026) — Local IR control; Harmony HUB integration; media player binding
• V1.1.1 (May 2026) — TV Card script binding; Scene & Script Card
• V1.1.0 (April 2026) — Automatic HA reconnection; domain-based login

Full firmware update guide →

Troubleshooting

Remote Shows "No Connection"

• Verify both devices are on the same Wi-Fi network
• Check that your Home Assistant server is running
• Re-scan the QR code or verify your token is still valid

Cards Not Showing on Remote

• Pull down from the top of the screen and tap Refresh
• Ensure RosCard is installed and configured correctly
• Check that entities exist and are properly bound

Physical Buttons Not Responding

• Check your TV Card button mapping configuration
• Verify global shortcuts in Settings → Shortcut Configuration
• Try rebinding the button

Script Not Triggering

• Verify the script exists in Home Assistant and is enabled
• Check that the script's entity_id is correctly entered in the button mapping
• Test the script directly from Home Assistant to ensure it works