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

RosCard Switch Card Guide

Configure the RosCard Switch Card to control switches, relays, outlets, and toggle devices directly from your Astrion Remote. Get real-time status feedback with a clean, tap-friendly interface.

Last updated: July 2026 Requires: RosCard installed Switch entities

Overview

The RosCard Switch Card provides a dedicated interface for controlling switch, relay, and outlet entities from your Astrion Remote. It offers a clean, tap-friendly interface with real-time status feedback — perfect for controlling smart plugs, lights, relays, and any on/off device in your Home Assistant ecosystem.

The Switch Card is one of the most versatile RosCard components, as it works with any Home Assistant switch entity, including virtual switches created via helpers or integrations.

💡 Tip: Enable Independent Display for any Switch Card you want to appear as a full-screen, dedicated view on your Astrion Remote — perfect for controlling multiple switches in a room or zone.

Features

🔘

Toggle Control

Tap to toggle switches on/off with instant feedback

📊

Real-Time Status

Visual indicators show current state — on/off at a glance

📋

Multiple Switches

Control multiple switch entities from a single card

🎨

Custom Icons & Labels

Personalize each switch with custom names and icons

📱

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 Switch Card

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

3 Configure Switch Entities

Add your switch entities to the card. The Switch Card works with any Home Assistant switch entity.

Example Configuration:

type: custom:aiks-switch-card entities: - entity_id: switch.ipano_relay_1_2 uuid: 9a19a877-9772-4d04-8672-9589862dfbf6 alias: "Lamp" - entity_id: switch.ipano_relay_2_2 uuid: a63535bb-756a-48a7-bf19-b295ef6970dc alias: "Fan" - entity_id: switch.outdoor_lights uuid: 8fd848c5-78a1-41dc-bbf7-43b965bfe463 alias: "Outdoor Lights"

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 switch control.

type: custom:aiks-switch-card entities: - entity_id: switch.bedroom_lamp uuid: 20d80393-3d1d-4618-8d27-542973799be3 independent_display: true alias: "Bedroom Lamp"

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: The Switch Card only works with switch entities. If you're trying to control a light, use the Light Card instead for full brightness and color control.

YAML Reference

Full Parameter List

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

Parameter Details

  • entity_id — The Home Assistant entity ID for the switch (e.g., switch.living_room_lamp).
  • 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.

Supported Entity Types

  • Switch: Standard Home Assistant switch entities
  • Relay: Smart relay and contactor controls
  • Outlet: Smart plugs and power outlets
  • Helper: Virtual switches created via Home Assistant helpers
  • Integration: Any entity with entity_id starting with switch.

💡 Tip: The Switch Card automatically updates its visual state when the switch status changes in Home Assistant, providing real-time feedback on your Astrion Remote.

Troubleshooting

Switch 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 switch 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.

Switch Not Toggling

  • Check entity status: Verify the switch is available and not unavailable in Home Assistant.
  • Test in Home Assistant: Try toggling the switch directly from the Home Assistant UI to rule out connection issues.
  • Verify entity type: Ensure the entity is a valid switch entity.
  • Check permissions: Make sure the Astrion Remote token has permission to control the switch.

Status Not Updating

  • Verify the switch entity supports state reporting (some integrations may not provide reliable state feedback).
  • Refresh the remote view to force a state update.
  • Check that your Home Assistant server is running and accessible.

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 Switch Cards to refresh the binding. This is a known requirement for version updates.

Related resources

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

Need help with Switch Card?

Our support team and community are here to assist you.

WhatsApp Email Ask the Community
← Back to Media Player Card Guide Next: Cover Card Guide →
 ​