Media Player Card 5 min read RosCard YAML

RosCard Media Player Card Guide

Configure the RosCard Media Player Card to control music, video, and media playback directly from your Astrion Remote. Supports Android TV, Apple TV, Sonos, Spotify, and all Home Assistant media_player entities.

Last updated: July 2026 Requires: RosCard installed Media player entities

Overview

The RosCard Media Player Card provides a dedicated interface for controlling music, video, and media playback from your Astrion Remote. It supports all Home Assistant media_player entities, including Android TV, Apple TV, Sonos, Spotify, Kodi, and more.

The Media Player Card includes full playback controls — play, pause, stop, volume, track skipping, and source selection — all optimized for the Astrion Remote's 3.1-inch touchscreen.

💡 Tip: Enable Independent Display for any Media Player Card you want to appear as a full-screen, dedicated music or video control view on your Astrion Remote.

Features

▶️

Playback Control

Play, pause, stop, next, and previous track controls

🔊

Volume Control

Volume slider with up/down controls and mute toggle

🔄

Source Selection

Switch between audio sources and input selections

🎵

Playlist & Queue

Browse and select playlists from supported media players

📱

Android TV & Apple TV

Specialized controls for TV and set-top box media players

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 Media Player Card

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

3 Configure Media Player Entity

Add your media player entity to the card. The Media Player Card works with any Home Assistant media_player entity.

Standard Media Player Configuration:

type: custom:aiks-media-player-card entities: - entity_id: media_player.living_room_speaker uuid: 226fb064-f366-43b6-a487-e81f8c336cef independent_display: true alias: "Living Room"

4 Android TV vs Apple TV Configuration

Android TV: Select the remote entity for full control.

type: custom:aiks-media-player-card entities: - entity_id: media_player.android_tv uuid: 4930e7ed-df20-4bb3-bcc2-6f5c0e9180a5 remoteId: remote.android_tv_192_168_2_121 independent_display: true alias: "Living Room TV"

Apple TV: Select both media_player and remote entities.

type: custom:aiks-media-player-card entities: - entity_id: media_player.apple_tv uuid: 3d43a7c3-1957-4bcf-a34c-911aac62189d remoteId: remote.apple_tv_living_room independent_display: true alias: "Apple TV"

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: For Android TV, you must select the remote entity in addition to the media_player entity for full control. For Apple TV, select both media_player and remote entities.

YAML Reference

Full Parameter List

type: custom:aiks-media-player-card entities: - entity_id: media_player.entity_id # Required: Media player entity uuid: string # Required: Unique identifier remoteId: string # Optional: Remote entity for TV controls 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 media player (e.g., media_player.living_room).
uuid — A unique identifier for the card. Generated automatically when you add the card.
remoteId — For TV-type devices, the remote entity ID (e.g., remote.android_tv_192_168_2_121).
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 Media Player Types

Music: Sonos, Spotify, Apple Music, Tidal, Roon, Squeezebox
Video: Android TV, Apple TV, Kodi, Plex, Emby, Jellyfin
General: Any Home Assistant media_player entity

💡 Tip: The Media Player Card automatically adjusts its controls based on the capabilities of your media player entity. For example, if your media player supports playlist browsing, the card will display a playlist button.

Troubleshooting

Media Player 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 media player 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.

Playback Controls Not Responding

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

Android TV/Apple TV Controls Not Working

Ensure you've configured the remoteId parameter correctly.
Verify the remote entity exists in Home Assistant and is available.
Check that the remote entity supports the commands you're trying to send.
For Apple TV, make sure both media_player and remote entities are configured.

No Sound or Volume Control

Verify the media player supports volume control (some entities may have fixed volume).
Check the entity's supported features in Home Assistant Developer Tools.
Some media players require volume to be controlled via the remote entity rather than the media player entity.

🔧 Note: After updating RosCard to a new version, you may need to resave all your Media Player 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 RosCard GitHub Community Forum

Need help with Media Player Card?

Our support team and community are here to assist you.

WhatsApp Email Ask the Community

← Back to Scene Card Guide Next: Switch Card Guide →