feat(tv): turn the TV on and switch input over the network (Google TV / Android TV)

CHANGELOG.en-US.md

@@ -2,6 +2,10 @@
 
 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)
+
 ## [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,10 @@
 
 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)
+
 ## [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), 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), 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,25 @@ 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.
+
 ## Optional extras
 
 ### HDR

docs/GUIDE.pt-BR.md

@@ -23,6 +23,25 @@ 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.
+
 ## Extras opcionais
 
 ### HDR

docs/TESTING.md

@@ -105,6 +105,21 @@ 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: ______
+
 ## 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,41 @@ 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";
+
+    /// <summary>"none" | "androidTv".</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>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 +261,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,32 @@
   "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)",
+  "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.",

src/ConsoleMode/Resources/Strings.es-ES.json

@@ -96,6 +96,32 @@
   "TvConfirmationCard": "Confirmación en la TV",
   "TvConfirmationDescription": "La primera vez con una pantalla de juego nueva, la TV pide que confirmes que ves la imagen. Responde con ratón, teclado o mando (Xbox: A/B · PlayStation: ✕/○). Pruébalo aquí sin cambiar tus pantallas.",
   "TestNow": "Probar ahora",
+  "TvSection": "TV",
+  "TvControlCard": "Encender la TV y cambiar la entrada",
+  "TvProviderNone": "No controlarla",
+  "TvProviderAndroid": "Google TV / Android TV (red)",
+  "TvNoneDescription": "Al entrar en el modo consola, la app enciende la TV y cambia a la entrada del PC; al restaurar, puede ponerla en reposo.",
+  "TvAndroidDescription": "Por la red, sin instalar nada. En la TV: Ajustes → Sistema → Opciones de desarrollador → activa \"Depuración USB\" (o \"Depuración por red\"). La primera vez, acepta \"Permitir depuración\" en la TV.",
+  "TvHostCard": "Dirección de la TV",
+  "TvHostDescription": "IP de la TV en tu red (Ajustes → Red). Consejo: resérvala en el router para que no cambie.",
+  "TvMacCard": "Dirección MAC (opcional)",
+  "TvMacDescription": "Para despertar la TV del reposo profundo (Wake-on-LAN). Déjalo vacío si la TV responde apagada.",
+  "TvHdmiCard": "Entrada del PC",
+  "TvHdmiDescription": "Puerto HDMI de la TV donde está conectado el PC.",
+  "TvInputCommandCard": "Comando de la entrada (avanzado)",
+  "TvInputCommandDescription": "Solo si la TV ignora la tecla HDMI: un comando de shell de Android que cambia a la entrada del PC. Vacío = la tecla HDMI elegida arriba.",
+  "TvTurnOffCard": "Poner la TV en reposo al restaurar",
+  "TvTurnOffDescription": "Después de que vuelvan las pantallas del escritorio.",
+  "TvTestCard": "Probar la TV",
+  "TvTestDescription": "Enciende la TV y cambia a la entrada del PC ahora, sin tocar las pantallas. La primera vez, se empareja con la TV.",
+  "TvTesting": "Hablando con la TV… Si lo pide, acepta en la pantalla de la TV.",
+  "TvTestSuccess": "La TV respondió: debería estar encendida en la entrada del PC.",
+  "TvTestFailure": "No se pudo hablar con la TV: {0}",
+  "TvNotConfigured": "Elige cómo controlar la TV.",
+  "TvHostMissing": "Indica la dirección IP de la TV.",
+  "TvUnreachable": "La TV en {0} no respondió. Revisa la IP, que la TV esté en la misma red y que la depuración esté activada.",
+  "TvAdbNotAllowed": "La TV no autorizó este PC. Pulsa Probar de nuevo y elige \"Permitir siempre\" + \"Permitir\" en la TV.",
+  "TvAdbTlsUnsupported": "La TV solo acepta \"Depuración inalámbrica\" (emparejamiento con código). Activa \"Depuración USB\" / \"Depuración por red\" en Opciones de desarrollador.",
   "ControllerTestCard": "Probar mando",
   "ControllerTestDescription": "Muestra en vivo lo que Windows entrega de cada mando: origen, botones por índice, cruceta y sticks. Úsalo si el mando aparece pero no responde.",
   "ControllerTestSteamHint": "Steam abierto con soporte para PlayStation captura el mando y la aplicación no recibe nada. Cierra Steam (o desactiva el soporte para PlayStation en Steam Input) y prueba de nuevo.",