NVIDIA Shield TV Integration
Integrate your NVIDIA Shield TV with the Astrion Remote for one‑button control of movies, games, and more. This guide covers Home Assistant setup, macro configuration, and custom Activities for your Shield.
Overview
NVIDIA Shield TV is a powerful Android TV media player that works great with the Astrion Remote. By integrating Shield TV into your Home Assistant setup, you can control it alongside your other devices — lights, TV, sound system — all from a single remote.
What you'll achieve:
- 🎬 Movie Mode — Lights dim + TV on + Shield wakes + app launches
- 🎮 Game Mode — Game scene + TV on + Shield wakes + game app launches
- 💤 All Off — Shield off + TV off + lights off
📌 Prerequisites:
• NVIDIA Shield TV set up and connected to your network
• Home Assistant instance with Astrion integration installed
• Astrion Remote firmware v1.4.0 or newer
• ROSCard v1.4.0 or newer
Step 1 — Add NVIDIA Shield TV to Home Assistant
1.1 Add the Android TV Integration
In Home Assistant: Settings → Devices & Services → Add Integration → search for Android TV (or NVIDIA Shield if shown separately).
1.2 Enter IP Address and Pair
Enter your Shield TV's IP address. A pairing prompt will appear on your TV screen — accept it to complete pairing.
1.3 Find Your Shield Entity ID
After setup, you'll see a media player entity like:
media_player.nvidia_shieldmedia_player.shield_tvmedia_player.living_room_shield
Record this entity ID — you'll need it for your macros.
1.4 Test Before You Begin
Before touching Astrion, test that:
- You can power on/off the Shield from Home Assistant
- You can launch apps (YouTube, Netflix, Plex) from Home Assistant
- You can control playback (play/pause) from Home Assistant
✅ Ready to proceed? Once your Shield works in Home Assistant, you're ready to integrate it with your Astrion Remote.
Step 2 — Choose Your Control Path
You have two ways to integrate Shield TV into your Astrion setup. Choose the approach that best fits your usage.
Option A — Shield as Main TV Source
You watch everything through Shield (apps, games, streaming) and use the Samsung TV only as a display. Shield is your primary media player.
- All actions route through Shield
- TV handles power + input selection only
- Shield controls playback and apps
Option B — Separate Macros for Shield & TV Apps
You also use the Samsung TV's built-in apps. Create separate macros for Shield mode and TV apps mode.
- Button 1: Movie (Shield)
- Button 2: Normal TV (Samsung apps)
- Button 1 Long Press: Game (Shield)
💡 Tip: You can mix both approaches! Use Shield for some buttons and Samsung apps for others. The Astrion Remote supports up to 8 custom physical buttons per device context.
Step 3 — Create Shield Macros
Here are ready‑to‑use macro templates for controlling your Shield TV. Replace the placeholder entity IDs with your actual ones.
Placeholder Entities:
media_player.SAMSUNG_TV_ENTITY— Your Samsung TV entitymedia_player.SHIELD_ENTITY— Your Shield TV entitylight.HUE_GROUP_ENTITY— Your Hue room/zone groupscene.movie_night,scene.tv_normal,scene.all_off— Your scenes
Macro 1: "Movie (Shield)" — Button 1
Macro 2: "Game (Shield)" — Button 1 Long Press
Macro 3: "All Off" — Button 3
💡 App Launch Tips:
• Netflix: androidtv://app/com.netflix.ninja
• YouTube: androidtv://app/com.google.android.youtube.tv
• Plex: androidtv://app/com.plexapp.android
• Steam Link: androidtv://app/com.valvesoftware.steamlink
• Kodi: androidtv://app/org.xbmc.kodi
Step 4 — Create Activities for Shield
Activities combine your Shield macros with custom screen layouts optimized for each use case.
| Activity | Actions | Layout |
|---|---|---|
| Shield Movie | Movie (Shield) macro | TV Card bound to Shield + minimal lights |
| Shield Games | Game (Shield) macro | Shield TV Card + gaming scene buttons |
| Off | All Off macro | Simple off screen or home screen |
💡 Layout Tip: For Shield Movie, bind the TV Card
to your Shield's media player entity (media_player.SHIELD_ENTITY)
so you can control playback directly from the remote screen.
Step 5 — Sync to Your Astrion Remote
1 Save All Macros and Activities
Ensure all configurations are saved in Home Assistant and the Astrion app.
2 Open Remotios / Sync
On your Astrion Remote, open the Remotios / Sync function.
3 Select Your Dashboard
Select the dashboard you want to sync (e.g., "Astrion Pro").
4 Complete the Sync
Click Sync and wait for the configuration to transfer.
5 Test Your Shield Controls
Test each button and activity:
- 🎬 Button 1 → Movie scene + TV on + Shield wakes + Netflix opens
- 🎮 Button 1 (Long Press) → Game scene + TV on + Shield wakes + Steam Link opens
- 💤 Button 3 → Shield off + TV off + lights off
✅ All Done! Your NVIDIA Shield TV is now fully integrated with your Astrion Remote. Enjoy one‑button control of your entire entertainment system.
Troubleshooting
Shield Entity Not Found
- Check that the Android TV integration is installed
- Verify the Shield is on the same network as Home Assistant
- Try restarting Home Assistant and the Shield
TV Doesn't Switch Input
- Check the source name in the
select_sourceaction - Verify the HDMI port matches where Shield is connected
- Test the TV's source list in Home Assistant
App Doesn't Launch
- Verify the app package name is correct
- Check that
media_player.play_mediais supported for your Shield - Consider using
androidtv.adb_commandas an alternative
Shield Doesn't Wake
- Check that CEC is enabled on both TV and Shield
- Try the
media_player.turn_onservice with the Shield entity - Verify the Shield's power settings in the Shield UI
🔧 Still Not Working? Please create a forum post and include:
• Your Shield model and firmware version
• Your Home Assistant version
• The entity IDs you're using
• Any error messages from the logs