Xbox Cloud Gaming app for PS5 Homebrew
Roadmap — PSBox Cloud Gaming
Planejamento e visão de futuro do projeto PSBox Cloud Gaming, priorizado por valor para o usuário no console PlayStation 5 (e ecossistema PlayStation).
Status: Em andamento (next), Planejado (planned), Futuro (later), Descartado (dropped).
Última atualização: 07/11/2026 (release estável v1.6.3 / correções de engasgos de streaming no PS5, cache v3, 20 dicas de launching e diagnósticos reativos).
🐛 Bugs Prioritários & Correções Imediatas (High-Priority Fixes)
1. Falso Positivo de "46 Novos Jogos" & Otimização do Tempo de Splash Screen — done (v1.5.5)
- Sintoma Resolvido: Notificação repetida de "46 novos jogos" e retenção desnecessária do usuário na tela de splash foram completamente eliminadas.
- Implementação:
- Persistência integral de todos os produtos resolvidos do catálogo em
library_cache.jsone rastreamento deknownProducts_. - Liberação instantânea da Splash Screen (
showHome()) imediatamente após o login, executando osyncDelta()de forma não-bloqueante em background com spinner discreto. - Cálculo de
newCountrestrito estritamente a novos jogos que ingressaram no Game Pass em relação aos conhecidos no cache anterior.
- Persistência integral de todos os produtos resolvidos do catálogo em
2. Cursor do Mouse Duplicado na Build Desktop — done (v1.5.5)
- Sintoma Resolvido: Exibição simultânea do cursor do sistema operacional e do cursor vetorial de software corrigida no Linux / Steam Deck / Windows.
- Implementação: Ocultação do cursor de hardware do SO via
SDL_HideCursor()na inicialização da janela emshell_desktop.cpp.
3. Falha na Atualização Automática do Catálogo do Xbox Game Pass (Exige Refresh Manual) — done (v1.5.5)
- Sintoma Resolvido: Estantes de catálogo ("Novidades", "Mais populares", etc.) agora atualizam automaticamente no boot sem intervenção manual.
- Implementação: O
syncDelta()consulta e sincroniza automaticamente os feeds SIGL atualizados (kRecentlyAdded,kMostPopular,kFreeToPlay,kLeavingSoon) e refresca as linhas correspondentes emlayout_.
4. Otimização de Microfone Opus (10 ms) e Latência de Áudio — done (v1.6.0) (#187)
- Implementação: Pacotes de microfone com framing de 10 ms (cortando a latência de envio pela metade para ~10.5 ms) com métricas de temporização no log.
5. Estabilidade de Stream e Fila Adaptativa de Áudio — done (v1.6.0) (#317)
- Implementação: ~75% menos quadros pulados; fila de áudio adaptativa (alvo de 40–100 ms; de ~98 para ~60 ms em média nos testes com Fortnite) que volta suave depois de uma falha; espera por pacotes reenviados que acompanha o ping; e registro no log de onde a transmissão trava por mais de 5 s.
6. Cotas de Tempo de Nuvem e Avisos em Jogo — done (v1.6.0) (#342)
- Implementação: Suporte a limites de tempo mensal de nuvem (parser de horas restantes e totais, exibição na barra superior centralizada, avisos a 15m/5m e tela amigável com QR Code).
7. Diagnóstico "Verificar meu login" Inoperante (Modal Aberto sem Execução) — done (v1.6.3)
- Sintoma Resolvido: Modal abria em branco sem disparar os testes nem renderizar o feedback de progresso dos estágios de validação.
- Implementação:
- Inicialização reativa imediata dos 6 estágios de validação (
signInCheck_.stages) com spinners de carregamento emopenTester(). - Fila não-bloqueante à prova de descartes com retry loop em
app_core.cpppara o comandokCheckSignIn. - Preservação estrita de 100% da lógica e apresentação originais em
worker_diagnostics.cppeapp_ui_settings.cpp.
- Inicialização reativa imediata dos 6 estágios de validação (
8. Diagnóstico "Teste de rede" Inoperante (Modal Estático em "UDP / STUN (NAT)") — done (v1.6.3)
- Sintoma Resolvido: Modal abria estático exibindo apenas o cabeçalho UDP/STUN sem realizar medições de RTT e jitter para as regiões dos datacenters.
- Implementação:
- Inicialização reativa imediata das regiões (
networkTest_.regions) com indicadores de sondagem ativa (...). - Retry loop seguro para o comando
kNetworkTestemapp_core.cppeliminando descartes durante transições do worker. - Sondas STUN RFC 5389 operando com total integridade e reportando latências instantaneamente à UI.
- Inicialização reativa imediata das regiões (
9. Problemas de Mapeamento de Input OneFamily no PS4 nas Opções 2, 3 e 4 (#369) — investigating (prioridade máxima)
- Sintoma Reportado: Feedback de usuários na build de PS4 (issue #369) reportando falhas com o driver OneFamily integrado: quando o controle está configurado como Opção 1, tudo opera perfeitamente. No entanto, ao selecionar as Opções 2, 3 ou 4, alguns jogos apresentam anomalias e perda de reconhecimento de inputs/botões (comprovado em testes com Remnant II). Ao retornar para a Opção 1, o controle volta ao funcionamento normal.
- Investigação & Correção:
- Auditar as rotinas de multiplexação de portas, índices de dispositivos e tabelas de mapeamento HID em
src/input/pad_usb_ps4.cpp,src/input/pad_usb.cppesrc/input/pad_usb_hid.cpp. - Verificar se as configurações das opções 2, 3 e 4 introduzem divergências no parsing de relatórios de entrada (input reports), no tratamento de botões compartilhados ou na leitura de múltiplos slots via
libSceUsbd. - Corrigir o tratamento de estados e validar a consistência de leitura de botões e eixos em todos os modos suportados.
- Auditar as rotinas de multiplexação de portas, índices de dispositivos e tabelas de mapeamento HID em
🚀 Em Andamento e Próximos Passos (Now & Next)
1. Port Nativo para PlayStation 4 (PSBox Cloud Gaming - PS4) — done (v1.5.5)
Port dedicado e otimizado para consoles PlayStation 4 com jailbreak (firmwares 9.00 / 11.00):
- Pacote e Identidade Isolados: Pacote PKG independente (
PSBX00001.pkg) comTitleIDpróprio, evitando qualquer interferência ou colisão com a versão de PS5 (PPSA99810). - Conectividade WebRTC: Stack ICE, STUN e handshake DTLS adaptados com compatibilidade FreeBSD/Orbis libc++ (
ETIMEDOUT=60), handshake de certificados MbedTLS e canais de dados SCTP. - Pipeline de Vídeo e Áudio: Decodificação H.264 por hardware via
libSceVideodec2em Direct Memory Onion/Garlic, renderizador 2D por software com 4 threads SIMD SSE4.2 (cópia zero de overlay viashared_ptr) e saída de áudio DMA com dreno limpo. - Controles e Periféricos: Suporte completo ao DualShock 4 com rumble de motores duplos, lightbar, touchpad e giroscópio.
2. Suporte Nativo a Controles USB no PS5 — parcial (v1.6.0)
Leitura direta pelo /dev/ugen* com ioctls USB_FS, contornando a libScePad (o /dev/uhid* não existe no PS5).
- Entregue na v1.6.0: controles Xbox Series no cabo (GIP) e controles/dongles XInput (ex: 8BitDo Ultimate 2.4G no modo X-Input). Cada controle é um jogador, na ordem em que conecta; Xbox/Home abre o menu do jogo daquele jogador e Xbox/Home + LB/RB troca o jogador.
- Falta:
- DualShock 4 USB.
- Xbox 360 com receptor sem fio e Adaptador Sem Fio Xbox (protocolos diferentes).
- 8BitDo em D-Input, fightsticks e controles HID genéricos (exige ler o descritor HID).
- Vibração nos controles USB, ícones de botões do Xbox e teste do controle de Xbox One no cabo.
3. Multi-Phone WebUI Controllers (P1..P4) & Layout Studio — next
Expansão do servidor local integrado (porta 8080) para multiplayer cooperativo local sem custos de hardware:
- Suporte a até 4 Smartphones Simultâneos: Seleção dinâmica de slot (
P1,P2,P3,P4) via/gamepad, heartbeat automático de desconexão e transmissão binária via WebSocket (/ws) com latência < 5 ms. - PSBox Layout Studio: Editor visual de controles na WebUI com pré-visualização WYSIWYG, ajuste de botões analógicos e gatilhos para telas de toque, salvamento de perfis (
portrait/landscape) e persistência imediata.
4. SmartGlass QR Code no In-Game Menu (Overlay) — next (v1.7.0)
Acesso instantâneo e sem digitação manual ao controle virtual via smartphone durante a transmissão:
- Exibição Dinâmica no Overlay: Renderização de código QR vetorial de alta definição diretamente na interface do menu in-game (
stream_menu.cpp). - Resolução Automática de IP Local: Aponta dinamicamente para o endereço local da porta 8080 (
http://<ip_ps5>:8080/gamepad), permitindo que qualquer smartphone conectado à rede Wi-Fi pareie instantaneamente como controle complementar ou principal (P1..P4). - Toggle de Exibição Rápida: Opção dedicada no menu in-game (TOUCHPAD + OPTIONS) para exibir e ocultar o QR Code com 1 clique sem interromper a transmissão.
📋 Planejado para o Futuro (Planned & Later)
1. Sincronização de Conquistas Xbox para Troféus PlayStation (PS5 Entregue / Pop-in Nativo & PS4 Planejados) — em evolução
Espelhamento contínuo e estritamente aditivo das conquistas obtidas no Xbox Cloud Gaming para o subsistema local de troféus da conta PlayStation:
- Entregue no PS5 (
PSBox_Trophies.elf+ Provisionamento Nativo):- Automação 100% Transparente: Payload interno (
assets/PSBox_Trophies.elfestagiado em/data/psbox/PSBox_Trophies.elf) enviado automaticamente na inicialização sem exigir configuração manual pelo usuário. - Sincronização Estritamente Aditiva e Proteção de Jogos Locais: Preserva integralmente quaisquer troféus e timestamps já conquistados localmente no console (
TRPTITLE.DATe pacotesTROPHY.UCPde jogos instalados em disco/PSN nunca são sobrescritos ou zerados; conquistas de nuvem apenas somam novos troféus ao progresso existente). - Controle Individual por Jogo: Opção nas configurações individuais de cada jogo (OPTIONS na tela de detalhes) para desativar a sincronização de troféus de títulos específicos mantendo a sincronização global ativa para o restante da biblioteca.
- Zero Toasts do Aplicativo em Gameplay: Como o próprio stream de vídeo do Xbox já exibe a notificação da conquista em tela, o aplicativo não exibe toasts próprios ao desbloquear troféus.
- Automação 100% Transparente: Payload interno (
- Exploração Futura — Pop-in Nativo do Sistema PlayStation Durante a Gameplay (
planned):- Investigar o acionamento direto do pop-in nativo de troféu do sistema operacional do PS5 (
SceNotification/ canalTrophiescom templateInteractiveToastTrophyou gatilho de transição0 -> 1viasceNpTrophy2UnlockTrophycom contexto ativo doNPWRdinâmico) durante a transmissão para exibir o banner oficial do PS5 sem sobrepor toasts customizados do app.
- Investigar o acionamento direto do pop-in nativo de troféu do sistema operacional do PS5 (
- Plano Técnico para Suporte Nativo de Troféus no PlayStation 4 (
planned):- Atualmente no PS4,
libSceNpTrophy(sceNpTrophyRegisterContext/sceNpTrophyUnlockTrophy) exige um pacoteTROPHY.TRPassinado pela chave oficial da Sony em/app0/sce_sys/trophy/trophy00.trpe vinculado aoNPWRfixo do pacote FPKG, não permitindo registrar múltiplos jogos de nuvem dinamicamente via API padrão. - Referência de Implementação: Atlas Trophy Tool (Pauloxzak) — projeto de referência da comunidade para manipulação, extração, reconstrução de pacotes
TROPHY.TRP(comTROPCONF.SFMe ícones) e injeção direta no bancotrophy_local.dbdo PlayStation 4. - Arquitetura Planejada para PS4:
- Construtor de Pacotes
TRP(v1/v2): Implementar gerador de arquivosTROPHY.TRP(formato de arquivo Orbis OS contendoTROPCONF.SFMXML +ICON0.PNG+TROP000.PNG..TROP127.PNGsem criptografia em ambiente GoldHEN/desbloqueado) em/user/home/<uid>/trophy/conf/<NPWR>/TROPHY.TRP. - Provisionamento Direto no SQLite do Orbis OS (
trophy_local.db): Popular de forma aditiva as tabelastbl_trophy_title(resumo de progresso,np_comm_id, título, contadores de bronze/prata/ouro/platina) etbl_trophy_flag(estadounlocked,time_unlockedem ticks RTC,grade,visible) diretamente em/user/home/<uid>/trophy/db/trophy_local.db, preservando troféus locais existentes. - Metadados de Reconhecimento no
/system_data/priv/mms/app.db(PS4): Inserir entradas sintéticas de catálogo para que a tela nativa de Troféus do PS4 exiba os ícones e listas sem exigir FPKGs individuais instalados para cada jogo da nuvem.
- Construtor de Pacotes
- Atualmente no PS4,
2. Auto-Update para PlayStation 4 via GoldHEN Package Installer API — planned
Superar a limitação de partição somente-leitura (/user/app/) do Orbis OS permitindo atualizações diretas no PS4 sem depender de pendrive ou computador:
- Download em Background: Ao detectar uma release nova, o app baixa o
PSBX00001.pkgoficial do GitHub diretamente para o disco interno (/data/pkg/PSBX00001.pkg). - Integração com API Local do GoldHEN: Envio de comando HTTP para o serviço integrado do GoldHEN (
http://127.0.0.1:12800/api/install), instruindo o daemon a instalar a atualização em segundo plano. - Encerramento Limpo: Fechamento do app para que o instalador do sistema conclua o update do FPKG sem conflito de arquivos em uso.
3. Presença Visual e Banners em Lojas (RecompStore & Prospero Store) — planned
- Atualização do catálogo oficial com as artes em alta definição (512x512 Icon, 1080p/4K Hero Banners e screenshots oficiais de jogos como Halo Infinite e Fortnite).
- Manutenção contínua de metadados, links de releases assinadas e sincronização de atualizações automáticas via API.
4. Atalhos Diretos na Tela Inicial do PS5 (Home-Screen Forwarders) — later
- Criação de atalhos individuais na dashboard principal do PS5 para iniciar títulos específicos em nuvem diretamente, utilizando o formato ProsperoLight forwarder.
5. Suporte Completo a Teclado e Mouse no PlayStation 4 — planned
Paridade total no suporte a periféricos USB entre as versões de PS5 e PS4:
- Camada de Entrada Nativa: Habilitar a inicialização e polling contínuo via
libSceKeyboardelibSceMouse(src/input/kbm_ps4.cpp) conectado diretamente ao loop de eventos global (src/app/app_core.cpp). - Identificação Visual Dinâmica: Exibição do ícone do periférico em uso (
kIconKeyboardMouse/U+F8FE) nos indicadores da UI, barra superior e menu in-game (stream_menu.cpp). - Navegação e Jogabilidade Transparente:
- Emulação de gamepad para controle da dashboard e jogabilidade direta em qualquer jogo da nuvem (inclusive títulos que não aceitam KBM nativo no stream).
- Encaminhamento direto de eventos de mouse e teclado nos títulos com suporte nativo KBM.
- Captura e liberação suave do cursor do mouse em transições de menus e overlays.
6. Calibração de Giroscópio e Ajuste Fino de Mira In-Game (RFC / Discussão Prévia) — planned
Recurso solicitado pela comunidade para jogos de tiro e mira precisa (ex: Call of Duty: Warzone, Remnant II, Halo Infinite):
- Objetivo: Permitir calibração dinâmica dos sensores de movimento (giroscópio/acelerômetro) do DualSense (PS5) e DualShock 4 (PS4) durante a sessão ativa na nuvem através do menu in-game (overlay).
- Escopo e Planejamento Técnico:
- Compensação de Desvio Estático (Zero-Drift Bias): Rotina de calibração rápida no menu in-game (ex: 2 a 3 segundos com o controle em repouso) para calcular a média de erro dos eixos angulares e zerar o drift estático.
- Ajustes de Sensibilidade e Zona Morta (Deadzone): Configurações análogas à calibração de sticks analógicos, incluindo deadzone angular para amortecer micro-tremores involuntários e multiplicadores de sensibilidade separados para eixos horizontal (yaw) e vertical (pitch).
- Menu de Calibração In-Game: Interface acessível diretamente durante o streaming (OPTIONS + TOUCHPAD), possibilitando testar e refinar a precisão em tempo real.
- Persistência por Jogo: Armazenamento dos parâmetros no perfil do título (
activeGameProfile_emsettings.json). - Processo: Requisitos e comportamento de UI/UX serão conversados e alinhados detalhadamente antes de qualquer implementação de código.
🚫 Decisões Técnicas e Recursos Descartados (Dropped)
- Discord Rich Presence (Desktop): Descartado; o ecossistema Xbox Live / Game Pass já fornece presença nativa de atividade.
- Assistente de Primeiro Uso (Onboarding): Descartado para manter navegação direta, rápida e sem telas forçadas.
- Captura de Vídeo dos Últimos 30s da Partida: Descartado; impacto desnecessário em memória e I/O de disco no console.
- GeForce Now: Descartado; protocolo totalmente distinto e termos de serviço incompatíveis com a proposta do projeto.
- Transmissão HDR / Surround 5.1 / Frame Generation: xCloud transmite nativamente em áudio estéreo e vídeo SDR 1080p; interpolação artificial de quadros adicionaria latência intolerável.
- Múltiplas Contas Xbox Simultâneas: Não suportado; simplificação de cache local e segurança de credenciais.
📦 Histórico de Versões Recentes
Para o histórico completo e detalhado de todas as versões anteriores (v0.3.0 até v1.4.0), consulte as Releases Oficiais no GitHub.
- v1.6.3 (Atual):
- Eliminação de Engasgos de Streaming no PS5: Pausa automática e completa do processamento da fila em lote de troféus (
TaskType::BatchTitle) emg_trophyThreaddurante gameplay ativo (isStreaming()), eliminando micro-travamentos e contenção de CPU; checagem em tempo real (TaskType::RealtimePoll) mantida com prioridade máxima e retomada suave pós-sessão. - Restauração de Descrições Completas & Cache v3: Inversão de precedência para priorizar descrições longas (
ProductDescription) sobre slogans curtos (ProductDescriptionShort); migração automática parakCacheVersion = 3com reidratação de textos curtos via APIRemoteHighSapphire0. - 20 Dicas Dinâmicas na Tela de Launching: Expansão de 8 para 20 dicas cobrindo todas as novidades recentes (DualSense haptics/triggers, mouse no touchpad, WebUI SmartGlass, troféus, controles USB e áudio), rotacionando a cada 7 segundos com semente pseudo-aleatória por sessão e localização completa em 6 idiomas (EN, PT-BR, ES, DE, FR, IT).
- Restauração Reativa dos Diagnósticos: Telas "Verificar meu login" e "Teste de rede" inicializadas reativamente com spinners e sondagem instantânea de estágios e regiões; retry loop em
app_core.cppprevenindo descartes de comandos durante transições do worker. - Lançamento Tri-Plataforma Triplo: Pacotes completos e verificados para PlayStation 5 (Standalone + Atualizador In-App PPSA99810), PlayStation 4 (FPKG GoldHEN) e Linux Desktop / Steam Deck (AppImage).
- Eliminação de Engasgos de Streaming no PS5: Pausa automática e completa do processamento da fila em lote de troféus (
- v1.6.0:
- Controles USB no PS5: Xbox Series no cabo e controles/dongles XInput (8BitDo Ultimate 2.4G), cada um como seu próprio jogador.
- Horas de jogo na nuvem (#342): tempo restante na barra superior, avisos aos 15 e 5 minutos, e tela explicativa com QR quando o tempo acaba.
- Microfone em pacotes de 10 ms (#187): latência de codificação de ~21 para ~10,5 ms.
- Transmissão (#317): ~75% menos quadros pulados, áudio com menos atraso e recuperação suave, espera por pacotes reenviados que acompanha o ping.
- README com foco no PS5 e instalação pela RecompStore e Prospero Store.
- v1.5.5:
- Eliminação do Falso Positivo de "46 Novos Jogos" & Boot Instantâneo: Persistência integral de todos os produtos do catálogo em
library_cache.json(knownProducts_), cálculo estrito de adições reais ao catálogo e liberação imediata da Splash Screen (showHome()) com sincronização diferencial não-bloqueante em segundo plano. - Cursor do Mouse sem Duplicação no Desktop: Chamada a
SDL_HideCursor()no backend SDL3, ocultando o cursor de hardware nativo do sistema operacional e preservando exclusivamente o cursor vetorial suave da interface. - Atualização Automática de Estantes do Game Pass: Sincronização em segundo plano dos feeds SIGL ("Novidades", "Mais populares", "Streaming gratuito", "Saindo em breve") no
syncDeltasem necessidade de refresh manual (L3). - Port Nativo PlayStation 4 Consolidado (
PSBX00001): Decodificação por hardware vialibSceVideodec2, composição 2D por software multithread SIMD SSE4.2 (cópia zero de overlay), suporte completo a DualShock 4 e empacotamento PKG oficial assinado.
- Eliminação do Falso Positivo de "46 Novos Jogos" & Boot Instantâneo: Persistência integral de todos os produtos do catálogo em
- v1.5.4:
- Suporte completo a mouse e navegação vetorial no PS5 e Desktop.
- Fast-paths no renderizador 2D (cópia direta de scanlines e batch fill para texturas opacas).
- Cache de fontes UTF-8 e glifos sem contenção de mutexes em $O(1)$.
- Modularização estrutural de arquivos monolíticos (
app_ui.cpp,web_server.cpp,library.cpp,worker.cpp). - Correção de redirecionamento pós-login e resgate imediato de títulos Free-to-Play.
- v1.5.3:
- Testes autônomos de resgate de jogos na loja (
claimtest) e inserção imediata no índice 0 de "Meus jogos". - Transição imediata para streaming com decodificação por hardware (
libSceVideodec2), 120 Hz e haptics DualSense. - Reformulação da WebUI para "Smartglass WebUI" com logo oficial do Xbox Guide.
- Testes autônomos de resgate de jogos na loja (
- v1.5.2:
- Motor universal de aquisição de licenças gratuitas em 1-clique sem looping de carregamento.
- Deduplicação inteligente Series X|S sobre Xbox One e remoção de títulos exclusivos de PC.
- Bloqueio de inputs na tela de splash até a conclusão do login.
- v1.5.1:
- Restauração completa da estante de jogos adquiridos e eliminação de duplicatas de títulos multi-edição.
- Auto-recuperação de cache local corrompido (
library_cache.json).
- v1.5.0:
- WebUI 2.0 com suporte a controle virtual em tela cheia para Jogadores 1 a 4.
- Botão de reset de fábrica com proteção de toque seguro de 5 segundos.
- Sincronização em tempo real de biblioteca sem congelamentos de tela.