feat: add a guided tour to the session menu

CHANGELOG.en-US.md

@@ -4,6 +4,7 @@ English (US) release notes, mirroring CHANGELOG.md (Brazilian Portuguese). Befor
 
 ## [Unreleased]
 ### What's new
+- Guided tour of the session menu: the first time the menu opens, it offers an optional tour that highlights each option and explains what it does, including the difference between **Back to the PC** (restores the desk and the app stays in the tray) and **Exit Console Mode** (restores and closes the app). To see it again, press Y (△) or F1 in the menu, or use Settings → Session menu tour. (#144)
 - Revamped FPS counter: the numbers sit on a dark rounded card (it can be turned off) in three sizes, Small, Medium and Large. You can pick the screen corner it shows in (or keep RTSS's position) and tune it all from the session menu itself: A on "FPS counter" opens the list with style, size, position, background, color and, in Custom, the items. New styles: FPS only, Compact (FPS plus CPU, GPU and RAM usage on one line) and Detailed (FPS, frame time and API, plus CPU clock, GPU clock and temperature, VRAM and RAM). In Custom, the PC items can be picked one by one too. The data comes from Windows and the graphics driver, nothing to install; anyone already on "Compact" keeps seeing just the FPS. (#146)
 
 ### Changes

CHANGELOG.md

@@ -4,6 +4,7 @@ Notas em português do Brasil; a versão em inglês (Estados Unidos) fica em `CH
 
 ## [Unreleased]
 ### Novidades
+- Tour guiado do menu da sessão: na primeira vez que o menu abre, ele oferece um tour opcional que destaca cada opção e explica o que ela faz, incluindo a diferença entre **Voltar ao PC** (restaura a mesa e o app fica na bandeja) e **Sair do Console Mode** (restaura e fecha o app). Para ver de novo, aperte Y (△) ou F1 no menu, ou use Ajustes → Tour do menu da sessão. (#144)
 - Contador de FPS repaginado: os números ficam num card escuro e arredondado (dá para desligar) em três tamanhos, Pequeno, Médio e Grande. Dá para escolher o canto da tela onde ele aparece (ou deixar a posição do RTSS) e ajustar tudo pelo próprio menu da sessão: A em "Contador de FPS" abre a lista com estilo, tamanho, posição, fundo, cor e, no Personalizado, os itens. Novos estilos: Apenas FPS, Compacto (FPS e uso de CPU, GPU e RAM numa linha) e Detalhado (FPS, tempo de quadro e API, mais clock da CPU, clock e temperatura da GPU, VRAM e RAM). No Personalizado, os itens do PC também podem ser escolhidos um a um. Os dados vêm do Windows e do driver de vídeo, sem instalar nada; quem já usava "Compacto" continua vendo só o FPS. (#146)
 
 ### Mudanças

docs/GUIDE.md

@@ -12,6 +12,8 @@ Details that don't fit in the [README](../README.md). 🇧🇷 [Guia em portugu
 
 You can also restore anytime from the tray (*Restore setup* / *Show window*). With black overlays, **ESC** dismisses the curtains.
 
+The session menu has two ways out. **Back to the PC** ends the session and puts screens, resolution, HDR, audio and the FPS limit back as they were; the app stays in the tray. **Exit Console Mode** does the same and then closes the app, so the controller shortcuts stop until you open it again. The first time the menu opens, it offers a tour that explains each option; to see it later, press **Y** (△ on PlayStation) or **F1** in the menu, or use **Settings → Session menu tour**.
+
 ## Settings in Console mode
 
 In **System → Controller**, choose the button layout: **Automatic**, **Xbox** or **PlayStation**. The preview and shortcut labels follow the choice, which is saved when you close the app. This changes the displayed symbols; the controller's inputs keep their existing mapping.

docs/GUIDE.pt-BR.md

@@ -12,6 +12,8 @@ Detalhes que não cabem no [README](../README.pt-BR.md). 🇺🇸 [Guide in Engl
 
 Também dá para restaurar a qualquer momento pela bandeja (*Restaurar setup* / *Mostrar janela*). Com cortinas pretas, **ESC** remove o overlay.
 
+No menu da sessão há duas saídas. **Voltar ao PC** encerra a sessão e devolve telas, resolução, HDR, áudio e limite de FPS ao que eram; o app continua na bandeja. **Sair do Console Mode** faz o mesmo e depois fecha o app, então os atalhos do controle param até você abri-lo de novo. Na primeira vez que o menu abre, ele oferece um tour que explica cada opção; para vê-lo depois, aperte **Y** (△ no PlayStation) ou **F1** no menu, ou use **Ajustes → Tour do menu da sessão**.
+
 ## Configurações no modo Console
 
 Em **Sistema → Controle**, escolha o layout dos botões: **Automático**, **Xbox** ou **PlayStation**. A prévia e os nomes dos atalhos acompanham a escolha, que fica salva ao fechar o app. Isso muda os símbolos exibidos; as entradas do controle mantêm o mapeamento existente.

docs/TESTING.md

@@ -157,6 +157,24 @@ Pré-condições: sessão ativa com Big Picture (ou jogo borderless) na tela; co
 - [ ] Jogo em **tela cheia exclusiva**: o menu não aparece por cima (limitação documentada); Select + Y não quebra nada. Resultado: ______
 - [ ] `start consolemode://menu` no cmd abre o menu; fora da sessão, não faz nada. Resultado: ______
 
+### Tour guiado do menu
+
+Pré-condição para o convite: `SessionMenuTourDone` ausente ou `false` no `config.json` da pasta de dados.
+
+- [ ] **Convite na primeira vez**: ao abrir o menu (sessão ou prévia), depois que as linhas terminam de entrar, aparece um cartão centralizado "Primeira vez neste menu?", com "Agora não" (B) e "Fazer o tour" (A, em foco). A dica do convite mostra o botão certo (Y no Xbox, △ no PlayStation). Resultado: ______
+- [ ] **Agora não** (ou B): o cartão some, o foco volta para "Voltar ao jogo" e o convite **não** aparece mais ao reabrir o menu (`SessionMenuTourDone: true` no config). Resultado: ______
+- [ ] **Fechar o menu com o convite aberto** (pelo atalho): o convite aparece de novo na próxima abertura. Resultado: ______
+- [ ] **Paradas**: A avança por Voltar ao jogo → Explorador de arquivos → Volume → Tela e som → FPS (só com RTSS e fora da prévia) → Janelas → Voltar ao PC (ou "Fechar menu" na prévia) → Sair do Console Mode. Cada parada escurece o resto do menu, contorna na cor de destaque só as linhas certas (resolução e áudio juntas e o HDR à parte quando as linhas de FPS estão entre eles) e mostra "n de N". Resultado: ______
+- [ ] **Balão**: fica à direita do painel lateral, na altura das linhas destacadas, sem sair da tela; na parada Janelas fica sobre o painel lateral. Os textos não ficam cortados a 1080p nem a 4K com escala. Resultado: ______
+- [ ] **Rolagem**: numa tela em que o painel lateral precisa rolar (1080p com escala de 125%+), as paradas Voltar ao PC e Sair do Console Mode rolam o painel até as linhas e o destaque acompanha. Resultado: ______
+- [ ] **Textos das saídas**: em sessão, "Voltar ao PC" explica que restaura e o app fica na bandeja, e "Sair do Console Mode" que também fecha o app; na prévia, "Fechar menu" diz que só fecha o menu. Resultado: ______
+- [ ] **Controle no tour**: A e → avançam, ← volta uma parada (nunca para o convite), B sai; nenhum botão aciona a opção destacada nem mexe no menu por trás (X não fecha janela, Y não reinicia o tour). Na última parada o botão diz "Entendi" e encerra. Resultado: ______
+- [ ] **Teclado e mouse no tour**: Enter/Espaço acionam o botão em foco no balão, Tab alterna entre os dois, ←/→ trocam de parada, Esc sai; clicar numa linha destacada não faz nada. Resultado: ______
+- [ ] **Ver de novo**: Y (△) ou F1 com o menu aberto inicia o tour direto, sem convite; a barra de dicas mostra "Y Tour". Com o seletor ou a confirmação de fechar janela aberta, Y não faz nada. Resultado: ______
+- [ ] **Select + Y não abre o tour**: com o atalho do menu em Select + Y, segurar o atalho para **fechar** o menu não mostra o tour antes de fechar. Resultado: ______
+- [ ] **Pelas Configurações**: Ajustes → "Tour do menu da sessão" → "Ver o tour" (desktop) e Sistema → "Tour do menu da sessão" (interface Console) abrem o menu em prévia já com o tour, sem convite. Resultado: ______
+- [ ] Ao sair do tour, o foco volta para a linha ou o card onde estava antes. Sem animações do Windows, o tour aparece e troca de parada sem movimento. Em alto contraste, o véu e o balão usam as cores do sistema. Resultado: ______
+
 ## 1d. Explorador de arquivos (ControlFS) no menu da sessão
 
 Pré-condição: ControlFS instalado (https://github.com/nextestudios/ControlFS), exceto nos itens de instalação pelo menu.

src/ConsoleMode/Models/Models.cs

@@ -36,6 +36,9 @@ public sealed class AppConfig
     /// <summary>The first-run tour was finished or skipped.</summary>
     public bool TourDone { get; set; }
 
+    /// <summary>The session menu's tour was taken, finished or declined: it is no longer offered when the menu opens.</summary>
+    public bool SessionMenuTourDone { get; set; }
+
     /// <summary>
     /// Game screen + mode the user confirmed they can see ("id|WxH@Hz"). A different setup
     /// asks for confirmation on the TV before launching, and rolls back if nobody answers.

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

@@ -349,5 +349,27 @@
   "RestoreSetup": "Restore setup",
   "Exit": "Exit",
   "ToggleOn": "On",
-  "ToggleOff": "Off"
+  "ToggleOff": "Off",
+  "SessionTourInviteTitle": "First time in this menu?",
+  "SessionTourInviteBody": "A quick tour shows what each option does, including the difference between Back to the PC and Exit Console Mode. To see it later, press {0} here in the menu.",
+  "SessionTourStart": "Take the tour",
+  "SessionTourNotNow": "Not now",
+  "SessionTourProgress": "{0} of {1}",
+  "SessionTourHint": "Tour",
+  "SessionTourBackToGameBody": "Closes this menu and hands the controller back to the game, just as it was. {0} does the same from anywhere in the menu.",
+  "SessionTourControlFsBody": "Opens ControlFS, a file explorer made for the controller, in full screen. If it isn't installed yet, the first press downloads and installs it.",
+  "SessionTourVolumeBody": "Press {0} to adjust the volume of the audio output: ◀ ▶ change it in steps of 5, {1} mutes it, and {0} or {2} finish.",
+  "SessionTourDisplayTitle": "Screen and sound",
+  "SessionTourDisplayBody": "Resolution, refresh rate, audio output and HDR of the game screen. Whatever you change here lasts for this session only: back at the PC, everything goes back to how it was.",
+  "SessionTourDisplayPreviewBody": "Resolution, refresh rate, audio output and HDR of the game screen. Outside a session, like now, whatever you change here stays until you change it again.",
+  "SessionTourFpsTitle": "FPS",
+  "SessionTourFpsBody": "The FPS limit caps the frame rate of your games and the counter shows the FPS in a corner of the screen, both through RivaTuner. Back at the PC, both are undone.",
+  "SessionTourWindowsBody": "The open programs, like an Alt + Tab that is always on screen. {0} brings a window to the front; {1} asks it to close, once you confirm.",
+  "SessionTourBackToPcBody": "Ends the session: screens, resolution, HDR, audio and the FPS limit go back to how they were, Big Picture closes and the TV turns off if you set that up. Console Mode stays open in the tray, ready for next time.",
+  "SessionTourCloseMenuBody": "Outside a session there is nothing to restore, so this button only closes the menu. During a session it becomes Back to the PC and puts screens, audio and resolution back as they were.",
+  "SessionTourExitBody": "Does everything Back to the PC does and also closes Console Mode: it leaves the tray and the controller shortcuts stop working until you open it again.",
+  "SessionTourExitPreviewBody": "Closes Console Mode completely: it leaves the tray and the controller shortcuts stop working until you open it again.",
+  "SessionTourCard": "Session menu tour",
+  "SessionTourDescription": "Explains each option of the menu over the game. Opens the menu as a preview, without starting a session.",
+  "ShowTour": "Show the tour"
 }

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

@@ -349,5 +349,27 @@
   "RestoreSetup": "Restaurar pantallas",
   "Exit": "Salir",
   "ToggleOn": "Activado",
-  "ToggleOff": "Desactivado"
+  "ToggleOff": "Desactivado",
+  "SessionTourInviteTitle": "¿Primera vez en este menú?",
+  "SessionTourInviteBody": "Un recorrido rápido muestra qué hace cada opción, incluida la diferencia entre Volver al PC y Salir de Console Mode. Para verlo más tarde, pulsa {0} aquí en el menú.",
+  "SessionTourStart": "Hacer el recorrido",
+  "SessionTourNotNow": "Ahora no",
+  "SessionTourProgress": "{0} de {1}",
+  "SessionTourHint": "Recorrido",
+  "SessionTourBackToGameBody": "Cierra este menú y devuelve el mando al juego, tal como estaba. {0} hace lo mismo desde cualquier punto del menú.",
+  "SessionTourControlFsBody": "Abre ControlFS, un explorador de archivos hecho para el mando, a pantalla completa. Si todavía no está instalado, la primera pulsación lo descarga e instala.",
+  "SessionTourVolumeBody": "Pulsa {0} para ajustar el volumen de la salida de audio: ◀ ▶ lo cambian de 5 en 5, {1} lo silencia y {0} o {2} terminan el ajuste.",
+  "SessionTourDisplayTitle": "Pantalla y sonido",
+  "SessionTourDisplayBody": "Resolución, frecuencia de actualización, salida de audio y HDR de la pantalla de juego. Lo que cambies aquí vale solo para esta sesión: al volver al PC, todo vuelve a ser como era.",
+  "SessionTourDisplayPreviewBody": "Resolución, frecuencia de actualización, salida de audio y HDR de la pantalla de juego. Fuera de una sesión, como ahora, lo que cambies aquí se queda así hasta que lo cambies de nuevo.",
+  "SessionTourFpsTitle": "FPS",
+  "SessionTourFpsBody": "El límite de FPS fija la tasa de fotogramas de los juegos y el contador muestra los FPS en una esquina de la pantalla, los dos mediante RivaTuner. Al volver al PC, los dos se deshacen.",
+  "SessionTourWindowsBody": "Los programas abiertos, como un Alt + Tab siempre en pantalla. {0} trae la ventana al frente; {1} le pide que se cierre, después de que lo confirmes.",
+  "SessionTourBackToPcBody": "Termina la sesión: pantallas, resolución, HDR, audio y límite de FPS vuelven a ser como eran, Big Picture se cierra y la TV se apaga, si lo configuraste. Console Mode sigue abierto en la bandeja, listo para la próxima.",
+  "SessionTourCloseMenuBody": "Fuera de una sesión no hay nada que restaurar, así que este botón solo cierra el menú. Durante una sesión se convierte en Volver al PC y devuelve pantallas, audio y resolución a como estaban.",
+  "SessionTourExitBody": "Hace todo lo que hace Volver al PC y, además, cierra Console Mode: sale de la bandeja y los atajos del mando dejan de funcionar hasta que lo abras de nuevo.",
+  "SessionTourExitPreviewBody": "Cierra Console Mode por completo: sale de la bandeja y los atajos del mando dejan de funcionar hasta que lo abras de nuevo.",
+  "SessionTourCard": "Recorrido del menú de sesión",
+  "SessionTourDescription": "Explica cada opción del menú sobre el juego. Abre el menú como vista previa, sin iniciar una sesión.",
+  "ShowTour": "Ver el recorrido"
 }

src/ConsoleMode/Resources/Strings.pt-BR.json

@@ -349,5 +349,27 @@
   "RestoreSetup": "Restaurar setup",
   "Exit": "Sair",
   "ToggleOn": "Ativado",
-  "ToggleOff": "Desativado"
+  "ToggleOff": "Desativado",
+  "SessionTourInviteTitle": "Primeira vez neste menu?",
+  "SessionTourInviteBody": "Um tour rápido mostra o que cada opção faz, incluindo a diferença entre Voltar ao PC e Sair do Console Mode. Para ver depois, aperte {0} aqui no menu.",
+  "SessionTourStart": "Fazer o tour",
+  "SessionTourNotNow": "Agora não",
+  "SessionTourProgress": "{0} de {1}",
+  "SessionTourHint": "Tour",
+  "SessionTourBackToGameBody": "Fecha este menu e devolve o controle ao jogo, do jeito que estava. O {0} faz o mesmo de qualquer ponto do menu.",
+  "SessionTourControlFsBody": "Abre o ControlFS, um explorador de arquivos feito para o controle, em tela cheia. Se ele ainda não estiver instalado, o primeiro clique baixa e instala.",
+  "SessionTourVolumeBody": "Aperte {0} para ajustar o volume da saída de áudio: ◀ ▶ mudam de 5 em 5, {1} deixa no mudo e {0} ou {2} terminam o ajuste.",
+  "SessionTourDisplayTitle": "Tela e som",
+  "SessionTourDisplayBody": "Resolução, taxa de atualização, saída de áudio e HDR da tela de jogo. O que você mudar aqui vale só para esta sessão: ao voltar ao PC, tudo volta a ser como era.",
+  "SessionTourDisplayPreviewBody": "Resolução, taxa de atualização, saída de áudio e HDR da tela de jogo. Fora de uma sessão, como agora, o que você mudar aqui fica assim até ser trocado de novo.",
+  "SessionTourFpsTitle": "FPS",
+  "SessionTourFpsBody": "O limite de FPS trava a taxa de quadros dos jogos e o contador mostra os FPS num canto da tela, os dois pelo RivaTuner. Ao voltar ao PC, os dois são desfeitos.",
+  "SessionTourWindowsBody": "Os programas abertos, como um Alt + Tab que fica sempre na tela. {0} traz a janela para a frente; {1} pede para ela fechar, depois de você confirmar.",
+  "SessionTourBackToPcBody": "Encerra a sessão: telas, resolução, HDR, áudio e limite de FPS voltam ao que eram antes, o Big Picture fecha e a TV desliga, se você configurou isso. O Console Mode continua aberto na bandeja, pronto para a próxima.",
+  "SessionTourCloseMenuBody": "Fora de uma sessão não há nada para restaurar, então este botão só fecha o menu. Durante uma sessão ele vira Voltar ao PC e devolve telas, áudio e resolução ao que eram.",
+  "SessionTourExitBody": "Faz tudo o que Voltar ao PC faz e, além disso, fecha o Console Mode: ele sai da bandeja e os atalhos do controle param de funcionar até você abri-lo de novo.",
+  "SessionTourExitPreviewBody": "Fecha o Console Mode por completo: ele sai da bandeja e os atalhos do controle param de funcionar até você abri-lo de novo.",
+  "SessionTourCard": "Tour do menu da sessão",
+  "SessionTourDescription": "Explica cada opção do menu sobre o jogo. Abre o menu numa prévia, sem iniciar uma sessão.",
+  "ShowTour": "Ver o tour"
 }

src/ConsoleMode/Services/LocalizationService.cs

@@ -269,6 +269,10 @@ internal void NotifyAll()
     public string TutorialCard => LocalizationService.Get(nameof(TutorialCard));
     public string TutorialDescription => LocalizationService.Get(nameof(TutorialDescription));
     public string SeeAgain => LocalizationService.Get(nameof(SeeAgain));
+    public string SessionTourCard => LocalizationService.Get(nameof(SessionTourCard));
+    public string SessionTourDescription => LocalizationService.Get(nameof(SessionTourDescription));
+    public string SessionTourHint => LocalizationService.Get(nameof(SessionTourHint));
+    public string ShowTour => LocalizationService.Get(nameof(ShowTour));
     public string OneClickCard => LocalizationService.Get(nameof(OneClickCard));
     public string OneClickDescription => LocalizationService.Get(nameof(OneClickDescription));
     public string CreateShortcut => LocalizationService.Get(nameof(CreateShortcut));