Astrion Light Card Guide | RosCard Configuration for Home Assistant Astrion Light Card Guide | RosCard Configuration for Home Assistant
Skip to Content
Light Card 5 min read RosCard YAML

RosCard Light Card Guide

Configure the RosCard Light Card to manage your lighting entities directly from your Astrion Remote. Control brightness, color temperature, RGB colors, and light groups.

Last updated: July 2026 Requires: RosCard installed Light entities

Overview

The RosCard Light Card provides a dedicated interface for controlling lighting entities from your Astrion Remote. It supports individual lights, light groups, brightness adjustment, color temperature, and RGB color selection.

💡 Tip: Enable Independent Display for any Light Card you want to appear as a full-screen, dedicated view on your Astrion Remote.

Features

💡

Brightness Control

Adjust brightness from 0% to 100% with a smooth slider

🎨

Color Temperature

Warm to cool white adjustment for compatible lights

🌈

RGB Color

Full color selection for RGB-capable lights

📋

Light Groups

Control multiple lights together as a single entity

🔄

Independent Display

Full-screen dedicated view on your Astrion Remote

Step-by-Step Configuration

1 Open Dashboard Editor

In Home Assistant, navigate to the dashboard you want to use for your Astrion Remote. Click Edit Dashboard in the top-right corner.

2 Add Light Card

Click Add Card and search for "Light (ROS)" or "custom:aiks-light-card". Select it to add the card to your dashboard.

3 Configure Entities

Add your light entities to the card. You can add multiple lights to a single card for grouped control.

Example Configuration:

type: custom:aiks-light-card entities: - entity_id: light.living_room_main uuid: 20d80393-3d1d-4618-8d27-542973799be3 independent_display: false alias: "Main Lights" - entity_id: light.living_room_lamp uuid: 3d43a7c3-1957-4bcf-a34c-911aac62189d independent_display: false alias: "Table Lamp" icon_path: /local/community/RosCard/icon_img/icon_light.png

4 Enable Independent Display

For any card you want to appear as a full-screen view on your Astrion Remote, enable Independent Display. This is particularly useful for room-specific lighting controls.

type: custom:aiks-light-card entities: - entity_id: light.bedroom uuid: 8fd848c5-78a1-41dc-bbf7-43b965bfe463 independent_display: true alias: "Bedroom Lights"

5 Save and Refresh

Click Save to apply your configuration. On your Astrion Remote, pull down from the top of the home screen and tap Refresh to load the new card.

⚠️ Important: If your Light Card doesn't appear on the remote after saving, make sure you've refreshed the remote's view. If issues persist, verify that the entity IDs are correct and the entities exist in Home Assistant.

YAML Reference

Full Parameter List

type: custom:aiks-light-card entities: - entity_id: light.entity_id # Required: Home Assistant light entity uuid: string # Required: Unique identifier independent_display: true/false # Full-screen mode on remote alias: "Custom Name" # Display name on remote icon_path: /local/path/to/icon.png # Custom icon path

Parameter Details

  • entity_id — The Home Assistant entity ID for the light (e.g., light.living_room).
  • uuid — A unique identifier for the card. Generated automatically when you add the card.
  • independent_display — When true, the card appears as a full-screen dedicated view on the remote.
  • alias — A custom display name shown on the remote instead of the entity ID.
  • icon_path — Path to a custom icon image in the Home Assistant /local/ directory.

💡 Tip: Custom icons should be placed in /local/community/RosCard/icon_img/ and referenced as /local/community/RosCard/icon_img/icon_light.png.

Troubleshooting

Light Card Not Showing on Astrion Remote

  • Refresh the remote: Pull down from the top of the home screen and tap Refresh.
  • Verify entity exists: Make sure the light entity is available in Home Assistant.
  • Check YAML format: Ensure your configuration uses the correct syntax and indentation.
  • Update RosCard: If you're running an older version, update RosCard via HACS.

Light Controls Not Responding

  • Check entity status: Verify the light is available and not unavailable in Home Assistant.
  • Test in Home Assistant: Try controlling the light directly from the Home Assistant UI to rule out connection issues.
  • Rebind entities: If the card was working before and stopped, try removing and re-adding the entity.

Independent Display Not Working

  • Ensure independent_display is set to true for the specific entity.
  • Only one card with independent_display: true will show as the dedicated view per dashboard.
  • Refresh the remote after saving changes.

🔧 Note: After updating RosCard to a new version, you may need to resave all your Light Cards to refresh the binding. This is a known requirement for version updates.

Related resources

RosCard Overview Climate Card Guide TV Card Guide Scene Card Guide RosCard GitHub Community Forum

Need help with Light Card?

Our support team and community are here to assist you.

WhatsApp Email Ask the Community
← Back to RosCard Overview Next: Climate Card Guide →
 ​