Skip to content

Commit bd759e8

Browse files
authored
Merge pull request #1151 from davidhedlund/patch-34
Update tv.md: Add a HDMI-CEC Remote Control Pass-Through section
2 parents bf17c78 + 7c28156 commit bd759e8

1 file changed

Lines changed: 25 additions & 0 deletions

File tree

‎docs/guides/tv.md‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,31 @@ For older TVs without a "Game" picture mode, use RetroArch's `Settings` → `Lat
3535

3636
Shaders and overlays in RetroArch may be used instead of TV picture modes to apply authentic retro display effects and decorative elements directly to the emulated image, bypassing the hardware-dependent post-processing in non-Game picture modes that introduces input lag.
3737

38+
## HDMI-CEC Remote Control Pass-Through
39+
40+
> Note: This section is for Digital Media Players only. TV remotes cannot operate on PCs at all; even basic navigation commands will not function, as standard computer graphics cards do not support HDMI-CEC communication.
41+
42+
Most modern Smart TVs include built-in HDMI-CEC hardware. To use it, you just need to turn on **HDMI-CEC Remote Control Pass-Through** in your TV’s settings (the exact name changes depending on the brand).
43+
44+
### Supported Buttons via HDMI-CEC
45+
46+
Enabling this feature allows you to use your TV remote to control your Digital Media Player. Depending on your TV brand, the buttons will typically function as follows:
47+
48+
* **Basic Navigation:** The physical **Arrows, OK, Back, and Exit** buttons.
49+
* **The Menu/Options Button:** Often labeled as **`...`** or **`123`**, this button brings up the TV's on-screen overlay. It adds a virtual **"HOME"** shortcut specifically for your digital media player.
50+
- **Note:** This virtual shortcut is necessary because the physical **HOME** button on your remote is hardwired directly to the TV's own operating system and cannot communicate with your streaming device.
51+
52+
### The Problem: RetroArch Lockout
53+
54+
While standard navigation keys **Arrows, OK, Back, and Exit** work flawlessly in regular apps, they fail inside RetroArch. Because the app lacks a configuration profile for your specific TV remote, it cannot map the inputs correctly—frequently triggering a `Virtual (0/0) not configured, using fallback` error. Consequently, if your Bluetooth controller disconnects, you are left completely stranded; the remote's **Arrows and OK** buttons cannot be used to navigate to **Main Menu → Quit**, and the **Back** or **Exit** buttons will fail to return you to the dashboard of the Digital Media Player.
55+
56+
#### The Workaround
57+
58+
1. **Open the TV Menu:** Press your TV remote's Menu button to bring up the on-screen digital overlay.
59+
2. **Trigger the Virtual Home Button:** Select the virtual **"HOME"** shortcut from that overlay. This sends a command through the HDMI cable, forcing RetroArch to close and bringing you straight back to your streaming device's main dashboard.
60+
3. **Reconnect Your Controller:** Now that you are back on the main dashboard, your TV remote's arrow keys and OK button will work normally again. Use them to navigate to your device's Bluetooth settings and re-pair your gamepad.
61+
4. **Resume Playing:** Once your controller is connected, simply relaunch RetroArch and get back to your game.
62+
3863
## Frame rate fluctuations
3964

4065
### Frame rate fluctuations fix: Use RetroArch Synchronization features

0 commit comments

Comments
 (0)