feat(tv): USB-CEC route (Pulse-Eight adapter through libCEC's cec-client)

CHANGELOG.en-US.md

@@ -2,6 +2,11 @@
 
 English (US) release notes, mirroring CHANGELOG.md (Brazilian Portuguese). Before publishing a version, add a `## [VERSION]` section to **both** files: the workflow publishes the section matching the tag from each one and fails if either is missing.
 
+## [Unreleased]
+### What's new
+- Settings → TV: console mode turns the TV on and switches it to the PC's HDMI input, and can put it in standby on restore. First route: Google TV / Android TV over the network (ADB), nothing to install on the PC. (#93)
+- TV control through a Pulse-Eight USB-CEC adapter (libCEC): powers on, switches input and puts any HDMI-CEC TV in standby. (#96)
+
 ## [1.5.0]
 ### What's new
 - Console interface: a full-screen, controller-first home and Settings, driven by the D-pad/stick and A/B with Xbox and PlayStation pads. Automatic mode picks it whenever a controller is connected. (#41, #42, #47)

CHANGELOG.md

@@ -2,6 +2,11 @@
 
 Notas em português do Brasil; a versão em inglês (Estados Unidos) fica em `CHANGELOG.en-US.md`. Antes de publicar uma versão, adicione uma seção `## [VERSÃO]` com o changelog daquela versão **nos dois arquivos**. O workflow publica as duas seções correspondentes à tag na mesma release e falha se faltar alguma.
 
+## [Unreleased]
+### Novidades
+- Ajustes → TV: o modo console liga a TV e troca para a entrada HDMI do PC, e pode colocá-la em espera ao restaurar. Primeiro caminho: Google TV / Android TV pela rede (ADB), sem instalar nada no PC. (#93)
+- Controle da TV por adaptador USB-CEC da Pulse-Eight (libCEC): liga, troca a entrada e coloca em espera qualquer TV com HDMI-CEC. (#96)
+
 ## [1.5.0]
 ### Novidades
 - Interface Console: tela inicial e Ajustes em tela cheia, pensados para o controle (direcional/analógico, A/B) com controles Xbox e PlayStation. O modo Automático escolhe essa interface sempre que há um controle conectado. (#41, #42, #47)

README.md

@@ -40,6 +40,7 @@ Prefer the couch? With the app in the tray, hold the controller's Home button an
 - Hide the other screens by **disconnecting** them, **black overlays** or **DDC/CI**
 - Per-screen **resolution and refresh rate**, **HDR**, **VRR** and an **FPS limit** (RTSS) while you play
 - Audio goes to the TV (or any output) and comes back afterwards
+- [Turns the TV on and switches it to the PC's input](docs/GUIDE.md#tv-control) (Google TV / Android TV over the network, or any TV through a USB-CEC adapter), and can put it in standby afterwards
 - Launches **Steam Big Picture**, **Playnite fullscreen** or **Xbox** mode
 - Two interfaces: **Desktop** (mouse) and **Console** (full screen, Xbox and PlayStation pads)
 - Automation with `consolemode://start` / `stop` / `menu` links (Stream Deck, scripts) and a [local control API](docs/GUIDE.md#local-control-api)

README.pt-BR.md

@@ -40,6 +40,7 @@ Prefere o sofá? Com o app na bandeja, segure o botão Home do controle e ele co
 - Esconde as outras telas **desconectando**, com **cortinas pretas** ou por **DDC/CI**
 - **Resolução e Hz** por tela, **HDR**, **VRR** e **limite de FPS** (RTSS) enquanto você joga
 - O áudio vai para a TV (ou qualquer saída) e volta depois
+- [Liga a TV e troca para a entrada do PC](docs/GUIDE.pt-BR.md#controle-da-tv) (Google TV / Android TV pela rede, ou qualquer TV por um adaptador USB-CEC), e pode colocá-la em espera no fim
 - Abre **Steam Big Picture**, **Playnite em tela cheia** ou o **Modo Xbox**
 - Duas interfaces: **Desktop** (mouse) e **Console** (tela cheia, controles Xbox e PlayStation)
 - Automação com os links `consolemode://start` / `stop` / `menu` (Stream Deck, scripts) e uma [API de controle local](docs/GUIDE.pt-BR.md#api-de-controle-local)

docs/GUIDE.md

@@ -23,6 +23,35 @@ You can also restore anytime from the tray (*Restore setup* / *Show window*). Wi
 
 `start`, `stop` and `show` do exactly what the matching `consolemode://` link does, then reply once the app has settled (`ok:false` with an `error` if console mode didn't start or the restore didn't finish). `status` only reads. Only the signed-in user and LocalSystem can connect; nothing is exposed to the network.
 
+## TV control
+
+Settings → **TV** can turn the TV on and switch it to the PC's HDMI input when console mode starts, and optionally put it back in standby after the desk is restored. A TV that doesn't answer never blocks console mode: the app logs it and waits for the game screen as usual.
+
+Most PC graphics cards can't send HDMI-CEC, so the app talks to the TV over the network instead:
+
+### Google TV / Android TV
+
+TCL, Sony, Hisense, Philips and other TVs running Google TV or Android TV, through ADB (the Android debugging protocol). Nothing to install on the PC.
+
+1. On the TV: **Settings → System → About**, press **Android TV OS build** 7 times to unlock Developer options.
+2. **Settings → System → Developer options**: turn on **USB debugging** (on some TVs, **Network debugging** / **ADB over network**).
+3. In Console Mode, pick *Google TV / Android TV*, enter the TV's IP (Settings → Network on the TV; reserve it in your router) and the HDMI input the PC uses.
+4. Press **Test now**. The TV asks "Allow debugging from this computer?": tick **Always allow** and press **Allow**.
+
+Waking uses the Android wake-up key, then the **HDMI 1-4** key. If your TV ignores that key, set **Input command** to any Android shell command that opens the PC's input. If the TV drops off the network in standby, fill in its **MAC address** so the app sends Wake-on-LAN first (the TV's "Wake on network" / "Wake on Wi-Fi" option must be on).
+
+"Wireless debugging" with a pairing code (Android 11+ phones) is a different, TLS-wrapped protocol and isn't supported: use USB / network debugging.
+
+### USB-CEC adapter (Pulse-Eight)
+
+Works with **any TV with HDMI-CEC** (Samsung Anynet+, Sony Bravia Sync, LG SimpLink…), with no network setup, through a [Pulse-Eight USB-CEC adapter](https://www.pulse-eight.com/p/104/usb-hdmi-cec-adapter) placed on the HDMI cable between the PC and the TV.
+
+1. Install **libCEC** from Pulse-Eight; it brings `cec-client.exe` (found automatically in `Program Files (x86)\Pulse-Eight\USB-CEC Adapter`, or on the PATH).
+2. Turn CEC on in the TV's settings.
+3. In Console Mode, pick *USB-CEC adapter* and the TV's HDMI input the PC is on. Press **Test now**.
+
+On start, the app runs `cec-client -s -t p -p <input>` with `on 0` (power on) and then `as` (Active Source, so the TV switches to that input); on restore, `standby 0`. Each command takes a few seconds while the adapter opens.
+
 ## Optional extras
 
 ### HDR

docs/GUIDE.pt-BR.md

@@ -23,6 +23,35 @@ Os links `consolemode://` não dão resposta. Ferramentas que precisam de uma 
 
 `start`, `stop` e `show` fazem o mesmo que o link `consolemode://` correspondente e respondem quando o app terminou (`ok:false` com `error` se o modo console não entrou ou a restauração não terminou). `status` só consulta. Só o usuário logado e o LocalSystem conseguem conectar; nada fica exposto na rede.
 
+## Controle da TV
+
+Ajustes → **TV** pode ligar a TV e trocar para a entrada HDMI do PC quando o modo console começa e, se você quiser, colocá-la em espera depois que a mesa volta. Uma TV que não responde nunca trava o modo console: o app registra no log e espera a tela de jogo como sempre.
+
+A maioria das placas de vídeo de PC não envia HDMI-CEC, então o app fala com a TV pela rede:
+
+### Google TV / Android TV
+
+TVs TCL, Sony, Hisense, Philips e outras com Google TV ou Android TV, via ADB (o protocolo de depuração do Android). Nada para instalar no PC.
+
+1. Na TV: **Configurações → Sistema → Sobre**, aperte **Build do Android TV OS** 7 vezes para liberar as Opções do desenvolvedor.
+2. **Configurações → Sistema → Opções do desenvolvedor**: ative **Depuração USB** (em algumas TVs, **Depuração pela rede** / **ADB pela rede**).
+3. No Console Mode, escolha *Google TV / Android TV*, informe o IP da TV (Configurações → Rede na TV; reserve esse IP no roteador) e a entrada HDMI do PC.
+4. Aperte **Testar agora**. A TV pergunta "Permitir depuração deste computador?": marque **Sempre permitir** e aperte **Permitir**.
+
+Para acordar, o app usa a tecla de despertar do Android e depois a tecla **HDMI 1-4**. Se a sua TV ignorar essa tecla, preencha **Comando da entrada** com qualquer comando de shell do Android que abra a entrada do PC. Se a TV sai da rede em espera, informe o **endereço MAC** para o app mandar Wake-on-LAN antes (a opção "Ligar pela rede" / "Wake on Wi-Fi" da TV precisa estar ativa).
+
+A "Depuração sem fio" com código de pareamento (Android 11+ em celulares) é outro protocolo, com TLS, e não é suportada: use a depuração USB / pela rede.
+
+### Adaptador USB-CEC (Pulse-Eight)
+
+Funciona com **qualquer TV com HDMI-CEC** (Samsung Anynet+, Sony Bravia Sync, LG SimpLink…), sem configurar rede, por um [adaptador USB-CEC da Pulse-Eight](https://www.pulse-eight.com/p/104/usb-hdmi-cec-adapter) colocado no cabo HDMI entre o PC e a TV.
+
+1. Instale o **libCEC** da Pulse-Eight; ele traz o `cec-client.exe` (encontrado sozinho em `Program Files (x86)\Pulse-Eight\USB-CEC Adapter` ou no PATH).
+2. Ative o CEC nas configurações da TV.
+3. No Console Mode, escolha *Adaptador USB-CEC* e a entrada HDMI da TV onde o PC está. Aperte **Testar agora**.
+
+Ao começar, o app roda `cec-client -s -t p -p <entrada>` com `on 0` (liga) e depois `as` (Active Source, para a TV trocar para essa entrada); ao restaurar, `standby 0`. Cada comando leva alguns segundos enquanto o adaptador abre.
+
 ## Extras opcionais
 
 ### HDR

docs/TESTING.md

@@ -105,6 +105,31 @@ Pré-condições: Ajustes → Interface = **Automático** (padrão).
 - [ ] "Copiar diagnóstico" cola dispositivos + amostra; o `consolemode.log` tem a linha `Controles: …` de abertura com o DualSense listado. Resultado: ______
 - [ ] Desconectar e reconectar durante o teste: a lista atualiza e a leitura continua. Resultado: ______
 
+## 3c. Controle da TV: Google TV / Android TV (issue #75)
+
+Pré-condições: TV Google TV / Android TV na mesma rede do PC, com **Depuração USB** (ou "Depuração pela rede") ativada nas Opções do desenvolvedor; Ajustes → TV → *Google TV / Android TV* com o IP e a entrada HDMI do PC.
+
+- [ ] **Testar agora** na primeira vez: a TV pede "Permitir depuração"; com "Sempre permitir" + "Permitir", a TV acorda e vai para a entrada do PC. O status mostra sucesso. Resultado: ______
+- [ ] **Testar agora** de novo: não pede mais permissão; com a TV em espera, ela liga e troca a entrada. Resultado: ______
+- [ ] Recusar o pedido na TV (ou esperar 60 s): o status explica que a TV não autorizou este PC. Resultado: ______
+- [ ] IP errado / TV fora da rede: o status diz que a TV não respondeu, em poucos segundos. Resultado: ______
+- [ ] **Jogar agora** com a TV em espera: ela liga, troca para o PC e o modo console segue normal. O log tem `TV: ligar (androidTv) ok`. Resultado: ______
+- [ ] Com a TV desligada da tomada: o modo console não trava; o log tem `TV: ligar ... falhou` e o fluxo segue (a TV não aparece, o app avisa como antes). Resultado: ______
+- [ ] TV que some da rede em espera + **MAC** preenchido: o log mostra `enviando Wake-on-LAN` e a TV liga (com "Ligar pela rede" ativo na TV). Resultado: ______
+- [ ] **Colocar a TV em espera ao restaurar** ligado: ao sair do Big Picture, a mesa volta e depois a TV entra em espera. Desligado (padrão): a TV continua ligada. Resultado: ______
+- [ ] TV que ignora a tecla HDMI: preencher **Comando da entrada** faz a troca funcionar. Resultado: ______
+- [ ] Escolher "Não controlar": os campos somem e nada é enviado à TV. Resultado: ______
+
+## 3f. Controle da TV: adaptador USB-CEC (issue #75)
+
+Pré-condições: adaptador Pulse-Eight USB-CEC entre o PC e a TV, libCEC instalado, CEC ativo na TV; Ajustes → TV → *Adaptador USB-CEC* com a entrada HDMI do PC.
+
+- [ ] O card "cec-client" mostra o caminho encontrado; sem libCEC, mostra que não encontrou. Resultado: ______
+- [ ] **Testar agora** com a TV em espera: ela liga e troca para a entrada do PC. Resultado: ______
+- [ ] Adaptador desconectado do USB: o status diz que o adaptador não foi encontrado. Resultado: ______
+- [ ] **Jogar agora**: a TV liga antes das telas mudarem; o log tem `TV: cec-client "on 0" → 0` e `"as" → 0`. Resultado: ______
+- [ ] "Colocar a TV em espera ao restaurar": `standby 0` depois que a mesa volta. Resultado: ______
+
 ## 4. Regressões
 
 - [ ] Interface Desktop: mapa de telas, `Segmented`, chips, tour de 3 passos e Ajustes continuam como antes. Resultado: ______

src/ConsoleMode/Models/Models.cs

@@ -51,11 +51,45 @@ public sealed class AppConfig
     /// <summary>A version the user chose to skip; newer ones are still announced.</summary>
     public string SkippedUpdateVersion { get; set; } = "";
 
+    /// <summary>Turning the TV on / to the PC's input when console mode starts (issue #75).</summary>
+    public TvControlConfig Tv { get; set; } = new();
+
     [JsonIgnore]
     public string SetupKey =>
         $"{FocusMonitor}|{(MonitorModes.TryGetValue(FocusMonitor, out var mode) ? mode.Key : "current")}";
 }
 
+public sealed class TvControlConfig
+{
+    public const string None = "none";
+    public const string AndroidTv = "androidTv";
+    public const string Cec = "cec";
+
+    /// <summary>"none" | "androidTv" | "cec".</summary>
+    public string Provider { get; set; } = None;
+
+    /// <summary>The TV's IP address or host name, optionally with ":port".</summary>
+    public string Host { get; set; } = "";
+
+    /// <summary>For Wake-on-LAN when the TV is in deep standby; empty = don't send it.</summary>
+    public string MacAddress { get; set; } = "";
+
+    /// <summary>HDMI input the PC is plugged into (1-4).</summary>
+    public int HdmiInput { get; set; } = 1;
+
+    /// <summary>Android TV: shell command that switches to the PC's input, for TVs that ignore the HDMI key codes.</summary>
+    public string InputCommand { get; set; } = "";
+
+    /// <summary>USB-CEC: cec-client.exe (or its folder); empty = libCEC's install folder, then PATH.</summary>
+    public string CecClientPath { get; set; } = "";
+
+    /// <summary>Put the TV in standby after the desk is restored. Off by default.</summary>
+    public bool TurnOffOnRestore { get; set; }
+
+    [JsonIgnore]
+    public bool IsEnabled => !string.IsNullOrWhiteSpace(Provider) && Provider != None;
+}
+
 public sealed class SavedDisplayMode
 {
     public int Width { get; set; }
@@ -231,6 +265,8 @@ public sealed class ScreenRect
 public sealed class ConsoleRuntimeState
 {
     public bool IsActive { get; set; }
+    /// <summary>TV control used for this session, for the optional standby on restore.</summary>
+    public TvControlConfig? Tv { get; set; }
     public bool ShouldExit { get; set; }
     public bool RestoreInProgress { get; set; }
     public bool SteamMoved { get; set; }

src/ConsoleMode/Resources/Strings.en-US.json

@@ -96,6 +96,40 @@
   "TvConfirmationCard": "TV confirmation",
   "TvConfirmationDescription": "The first time you use a new gaming display, the TV asks you to confirm that you can see the image. Respond with a mouse, keyboard, or controller (Xbox: A/B · PlayStation: ✕/○). Test it here without changing your displays.",
   "TestNow": "Test now",
+  "TvSection": "TV",
+  "TvControlCard": "Turn the TV on and switch input",
+  "TvProviderNone": "Don't control it",
+  "TvProviderAndroid": "Google TV / Android TV (network)",
+  "TvProviderCec": "USB-CEC adapter (Pulse-Eight)",
+  "TvCecDescription": "HDMI-CEC through a Pulse-Eight adapter on the HDMI cable: works with any CEC TV (Anynet+, Bravia Sync, SimpLink…). Install Pulse-Eight's libCEC.",
+  "TvCecClientCard": "cec-client",
+  "TvCecClientFound": "Using {0}. Enter another path only if you have more than one install.",
+  "TvCecClientMissing": "cec-client.exe not found. Install libCEC (pulse-eight.com) or enter its path.",
+  "TvCecNoAdapter": "cec-client couldn't find the USB-CEC adapter. Check its USB cable and that it sits between the PC and the TV.",
+  "TvCecNoAnswer": "cec-client didn't answer in time.",
+  "TvCecFailed": "cec-client exited with error {0}.",
+  "TvNoneDescription": "When console mode starts, the app turns the TV on and switches it to the PC's input; on restore it can put it in standby.",
+  "TvAndroidDescription": "Over the network, nothing to install. On the TV: Settings → System → Developer options → turn on \"USB debugging\" (or \"Network debugging\"). The first time, accept \"Allow debugging\" on the TV.",
+  "TvHostCard": "TV address",
+  "TvHostDescription": "The TV's IP on your network (Settings → Network). Tip: reserve it in your router so it doesn't change.",
+  "TvMacCard": "MAC address (optional)",
+  "TvMacDescription": "To wake the TV from deep standby (Wake-on-LAN). Leave it empty if the TV answers while off.",
+  "TvHdmiCard": "PC input",
+  "TvHdmiDescription": "The TV's HDMI port the PC is plugged into.",
+  "TvInputCommandCard": "Input command (advanced)",
+  "TvInputCommandDescription": "Only if the TV ignores the HDMI key: an Android shell command that switches to the PC's input. Empty = the HDMI key chosen above.",
+  "TvTurnOffCard": "Put the TV in standby on restore",
+  "TvTurnOffDescription": "After the desk screens are back.",
+  "TvTestCard": "Test the TV",
+  "TvTestDescription": "Turns the TV on and switches to the PC's input now, without touching the screens. The first time, it pairs with the TV.",
+  "TvTesting": "Talking to the TV… If it asks, accept on the TV screen.",
+  "TvTestSuccess": "The TV answered: it should now be on, on the PC's input.",
+  "TvTestFailure": "Could not talk to the TV: {0}",
+  "TvNotConfigured": "Choose how to control the TV.",
+  "TvHostMissing": "Enter the TV's IP address.",
+  "TvUnreachable": "The TV at {0} didn't answer. Check the IP, that the TV is on the same network and that debugging is on.",
+  "TvAdbNotAllowed": "The TV didn't allow this PC. Press Test again and choose \"Always allow\" + \"Allow\" on the TV.",
+  "TvAdbTlsUnsupported": "The TV only accepts \"Wireless debugging\" (pairing with a code). Turn on \"USB debugging\" / \"Network debugging\" in Developer options.",
   "ControllerTestCard": "Test controller",
   "ControllerTestDescription": "Shows live what Windows delivers from each controller: source, buttons by index, D-pad and sticks. Use it when a pad shows up but does nothing.",
   "ControllerTestSteamHint": "Steam running with PlayStation support captures the pad and the app gets nothing. Close Steam (or turn off PlayStation support in Steam Input) and test again.",