RosCard Configuration

What is RosCard?

RosCard is a collection of advanced UI cards designed for seamless integration between Home Assistant and the Astrion ecosystem. It enables dynamic, state-aware control interfaces optimized for remotes, wall panels, and touch dashboards.

Without RosCard, your Astrion Remote cannot communicate with or control any devices in your Home Assistant ecosystem. RosCard serves as the communication bridge between your Astrion Remote hardware and your Home Assistant instance.

Design Philosophy

RosCard follows a Home Assistant–native architecture:

• Home Assistant = Brain — all automation logic remains centralized
• RosCard = Interaction Layer — handles UI and state-aware controls
• Astrion Remote = Interface — delivers the user experience

This ensures consistent device state, multi-room synchronization, and automation reliability.

💡 Key Insight: RosCard is configuration only — it generates card layouts and entity bindings. All control logic remains inside Home Assistant. This means you can modify your dashboard without affecting your automations.

Installation

Prerequisites

• Home Assistant 2024.x or newer (latest recommended)
• Astrion Remote firmware ≥ 1.1.1
• HACS (Home Assistant Community Store) installed

Method 1 — HACS (Recommended)

1 Open HACS

In Home Assistant, navigate to HACS → Frontend.

2 Add Custom Repository

Click the menu (⋮) → Custom repositories. Enter:

• Repository URL: https://github.com/yyqclhy/RosCard
• Category: Dashboard

Method 2 — Manual Installation

• Copy the /roscard folder into: /config/www/
• Add resource in Dashboard: /local/roscard/roscard.js
• Restart Home Assistant

Card Types

RosCard provides a variety of card types optimized for the Astrion Remote's 3.1-inch display.

All RosCard Cards — Complete Index

RosCard supports 10 card types. Below is the complete list — click any card name to view its dedicated configuration guide.

Configuration Examples

TV Card

The TV Card allows you to control your TV and media devices directly from the Astrion Remote.

type: custom:ros-tv-card
entity: media_player.living_room_tv
media_player: media_player.shield
power_on:
  service: script.tv_power_on
power_off:
  service: script.tv_power_off

Key Features:

• Multi-device routing — control TV and AVR from one card
• Script binding support — trigger automations with button presses
• Directional & long-press controls

Scene & Script Card

Execute Home Assistant scenes and scripts directly from your Astrion Remote. Perfect for activity-style automation workflows.

type: custom:ros-scene-card
entity: scene.movie_mode

Activity-Based Workflows (Harmony-Style Control)

RosCard supports activity-based workflows using Home Assistant scripts, Universal Media Player Input Select helpers, and automations.

Typical Activity Flow:

• Turn on TV
• Turn on AVR
• Select source
• Route volume control
• Update remote context

Long Press Support

Astrion Remote supports long press on: Up/Down/Left/Right, Channel +/−, and Volume +/−. Users can bind scripts to long presses to implement fast forward, rewind, skip actions, or custom automation triggers.

Troubleshooting

Cards Not Showing on Astrion Remote

• Refresh the remote: If you connected the Astrion before creating the card, the remote will not update automatically. After the view has been created, select "Refresh" on the remote.
• Change the default home name: Modify the default home name, then refresh the remote.
• Update firmware: This issue has been resolved in version 1.0.31 — upgrade to the latest version.

RosCard Not Showing in HACS

• Verify the repository URL is correct: https://github.com/yyqclhy/RosCard
• Ensure you selected Dashboard as the category
• Refresh HACS (press F5) after adding the repository

Remote Shows "No Connection" After RosCard Install

• Verify both devices are on the same Wi-Fi network
• Check that your Home Assistant server is running
• Try restarting the remote and your HA server