Infrared Control Guide
Set up infrared (IR) control on your Astrion Remote. Control TVs, set-top boxes, and other IR devices directly from the TV Card using the Astrion Home Integration.
Overview
Starting with firmware V1.2.0, the Astrion Remote supports local infrared (IR) control through the built-in IR transmitter. This allows you to control TVs, set-top boxes, audio equipment, and other IR-enabled devices directly from your Astrion Remote — even without a network connection.
The IR feature is accessed through the TV Card, which can be bound to Astrion IR entities, Harmony HUB entities, or media player entities. For devices not in the built-in IR database, you can also add custom IR codes using a simple format.
💡 Tip: IR control requires the Astrion Home Integration to be installed in Home Assistant. This integration bridges your Astrion Remote's IR transmitter with your TV Card configuration.
IR Development History — From Community Request to V1.2.0
The journey to IR support on Astrion Remote was driven by community feedback. Here's the story of how a user request became a core feature.
Community Calls for IR & BT Support
User Mathias_belevid highlights the need for IR and Bluetooth support on the Astrion Remote.
User: Mathias_belevid · Topic: #72 · IR/BT Support Request
Official Commitment: IR Support is Coming
After community discussion and internal planning, the Sanytron team commits to delivering IR functionality within 1-2 months.
Tim_Chan (Dev Engineer) · Topic: #72 · IR Development Commitment
HA100 as UI Terminal, HA200 as Universal Controller
Sanytron clarifies product strategy: HA100 is the premium UI terminal for HA ecosystem, while HA200 will deliver full universal remote capabilities including Bluetooth HID and a dedicated hub.
Sanytron Team · Topic: #72 · Product Strategy Communication
Infrared Research Shows Promising Results
Early testing results on set-top boxes demonstrate stable and reliable IR control performance. IR is formally incorporated into the Astrion development roadmap.
Charles · Topic: #179 · IR Research Update
V1.2.0 — IR Control Goes Live!
Local IR control is officially released with firmware V1.2.0. Includes TV Card support for Astrion IR entities, Harmony HUB entities, and custom IR codes. Astrion Home Integration launched in parallel.
✅ The most requested feature is now available!
Community Responds — Next Steps Identified
Following the release, users provided feedback on OTA update issues and integration installation. The team is actively addressing these to improve the experience.
Chykan_Hunter · Topic: #72 · Feature Enhancement Suggestion
✅ Community-Driven Development: IR control on Astrion Remote is a testament to the power of community feedback. From the initial user request in January 2026 to the V1.2.0 release in June, the journey showcases how Sanytron listens, responds, and delivers.
Prerequisites
Before you begin, make sure you have the following:
- Astrion Remote firmware V1.2.0 or newer
- RosCard updated to V1.2.0 or newer
- Home Assistant running with HACS installed
- Astrion Home Integration installed via HACS
- Your Astrion Remote connected to the same Home Assistant instance
⚠️ Important: IR control requires the Astrion Home Integration. Without this integration, the IR entity will not be available in your TV Card configuration.
Step 1 — Install Astrion Home Integration
The Astrion Home Integration connects your Astrion Remote's IR transmitter to Home Assistant, making the IR entity available for binding in the TV Card.
1.1 Add Repository to HACS
In Home Assistant, open HACS → click the menu (⋮) → Custom repositories.
- Repository URL:
https://github.com/yyqclhy/Astrion-integration - Category:
Integration
Click Add to save the repository.
1.2 Install the Integration
In HACS, search for Astrion Home Integration, click
Download, and restart Home Assistant
when prompted.
1.3 Add the Integration
After restart, go to Settings → Devices & Services and click Add Integration. Search for Astrion and select Astrion Home.
1.4 Select Your Remote Gateway
The system will search for Astrion Remote gateways connected to your
Home Assistant instance. Select your remote gateway by matching the
serial number (SN) — you can find the SN in your
Astrion Remote's About page.
If no gateway is found, ensure your Astrion Remote is properly connected to Home Assistant.
1.5 Configure the Remote
Select the remote you want to configure and click Set up.
Follow the on-screen instructions to complete the configuration.
📌 Note: Currently, the IR database supports multiple device types, but only TV and media_player devices are available for addition. Additional device types will be added in future updates.
Step 2 — Bind IR Entity to TV Card
Once the Astrion Home Integration is installed, you can bind the IR entity to your TV Card for infrared control.
Binding an Astrion IR Entity
2.1 Open TV Card Configuration
In Home Assistant, open the dashboard containing your TV Card and click Edit to open the card configuration.
2.2 Select IR Entity
In the Button Mapping section, search for and select the Astrion IR entity provided by the Astrion Home Integration.
Choose the IR code value for the button you are configuring — for example, if you are adding an Apple TV remote, select the corresponding IR codes for each button.
2.3 Save and Refresh
After configuring all buttons, click Save to apply the changes. On your Astrion Remote, pull down from the top of the screen and tap Refresh to load the updated TV Card.
Binding a Harmony HUB Entity
Starting with V1.2.0, the TV Card also supports binding to Harmony HUB entities, allowing you to control Harmony HUB devices directly from your Astrion Remote.
Prerequisites
- Your Harmony HUB must be successfully added to Home Assistant
- The Harmony HUB must be online and accessible
Configuration Steps
1 Select Harmony HUB
Open your TV Card configuration. In the Button Mapping section, select Harmony HUB and choose either select mode or remote mode based on your needs.
2 remote Mode
If you select remote mode, choose the pre-configured remote content from your Harmony HUB and select the button mapping function.
3 select Mode
If you select select mode, you can directly choose from the pre-configured script content available in your Harmony HUB.
4 Save and Refresh
Complete all button configurations, click Save, and refresh your Astrion Remote to apply the changes.
Binding a Media Player Entity
Starting with V1.2.0, the TV Card can also be bound to a media player entity
(media_player). This creates a dual-page experience on your Astrion Remote:
- Page 1 — TV Controls: Directional keys (Up/Down/Left/Right), OK, and other TV controls
- Page 2 — Media Controls: Play/Pause, Next/Previous track, and media playback controls
Typical Use Case — Apple TV
Bind both the Apple TV remote entity and the Apple TV media player entity to the same TV Card. Swipe left and right on the Astrion Remote to switch between TV controls and media playback controls seamlessly.
Configuration Steps
1 Add TV Card
Add a TV Card to your dashboard as usual.
2 Bind Media Player Entity
In the TV Card configuration, locate the Media Player field
and select your media player entity (e.g., media_player.apple_tv).
3 Configure Button Mappings
Configure your button mappings for both TV controls and media controls. The card will automatically create two pages.
4 Save and Refresh
Save the configuration and refresh your Astrion Remote.
Custom IR Codes
For devices not in the built-in IR database, the TV Card supports custom IR codes. This allows you to control virtually any IR-enabled device.
Understanding the IR Code Format
The custom IR format supported by the TV Card is:
Example:
Parameter Breakdown
- 38000 — IR carrier frequency in Hz (38kHz). For most consumer electronics (TVs, set-top boxes, audio equipment), the carrier frequency is typically 38000 Hz (38kHz).
- 8973 — First pulse duration (microseconds)
- 4497 — First gap duration (microseconds)
- 560, 556... — Subsequent pulse/gap durations (microseconds)
How to Add Custom IR Codes
1 Open TV Card Configuration
Open your TV Card configuration in Home Assistant.
2 Select IR Entity
Select the IR entity provided by the Astrion Home Integration.
3 Choose Custom IR Code
In the button mapping dropdown, select Custom IR Code.
4 Paste Your IR Code
Paste your IR code string using the format described above.
5 Save and Sync
Save the configuration and synchronize the card with your Astrion Remote.
💡 Tip: If your IR analysis tool shows a frequency other than 38000 Hz,
use that value instead. For example, if your tool shows 36000 Hz with
pulses 8961, 4491, 560, 560..., your custom code would be:
36000,8961,4491,560,560,...
TV Card Features in V1.2.0
The V1.2.0 update introduced several enhancements to the TV Card for improved IR control and user experience.
Custom Background
Import custom images for your TV Card background
Optimized Naming
Improved source list naming (formerly called "Signal Source")
Media Player Binding
Bind media entities for dual-page TV + media controls
Harmony HUB Support
Bind Harmony HUB entities with select/remote modes
Astrion IR Support
Bind Astrion IR entities for local IR control
Troubleshooting
IR Entity Not Showing in TV Card
- Verify the Astrion Home Integration is installed correctly.
- Ensure your Astrion Remote is running firmware V1.2.0 or newer.
- Check that RosCard is updated to V1.2.0 or newer.
- Restart Home Assistant after installing the integration.
No Response After Pressing Button
- Verify the frequency value is included at the beginning of the code.
- Ensure values are separated by commas only — no spaces or extra characters.
- Confirm the selected IR entity is the correct one for your remote.
- Check that the target device supports IR control and is within range of the transmitter.
- Verify the IR code format matches the required structure.
Harmony HUB Not Detected
- Ensure your Harmony HUB is successfully added to Home Assistant.
- Verify the Harmony HUB is online and accessible.
- Check that the Harmony integration is properly configured in Home Assistant.
Custom IR Code Not Working
- Double-check the IR code format — it must start with the frequency value.
- Verify that the pulse/gap durations are in microseconds (μs).
- Ensure the target device is within line-of-sight of the Astrion Remote's IR transmitter.
Media Player Controls Not Showing
- Ensure you have bound a media player entity to the TV Card.
- Verify the media player entity is available in Home Assistant.
- Check that the media player supports playback controls (play/pause, next/previous).
🔧 Still Not Working? Please create a forum post and include: your IR code, the device model you're trying to control, and any error messages. Our engineering team will be happy to help analyze the issue.
Related resources
Need help with IR setup?
Our support team and community are here to assist you.