You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/guides/tv.md
+25Lines changed: 25 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,6 +35,31 @@ For older TVs without a "Game" picture mode, use RetroArch's `Settings` → `Lat
35
35
36
36
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.
37
37
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
+
38
63
## Frame rate fluctuations
39
64
40
65
### Frame rate fluctuations fix: Use RetroArch Synchronization features
0 commit comments