Repository navigation
Releases
Releases · thinkzhou/LunarNX
v0.3.3
v0.3.2
v0.3.1
0.3.1
LunarNX 0.3.1 focuses on faster reconnection, safer stream teardown, and predictable release packaging. It reuses successful Xbox and PlayStation network routes, improves cancellation and UI lifecycle handling, and publishes stable assets for Sphaira installation.
Streaming and stability
- Reuse successful Xbox ICE and PlayStation remote routes.
- Speed up stream exit and harden asynchronous UI teardown.
- Improve cancellation handling and stream-exit rendering.
Release and documentation
- Generate the in-app changelog from
CHANGELOG.md. - Publish stable
LunarNX.nroandLunarNX.zipassets with SHA-256 checksums.
v0.3.0
0.3.0 (2026-09-02)
LunarNX 0.3.0 is a major streaming-stability update for Xbox and PlayStation. It improves controller responsiveness, audio/video recovery, PlayStation pairing and startup, rendering correctness, and the overall in-stream experience.
Xbox streaming
- Added network-aware streaming policies for low-latency local play and more variable cloud connections.
- Improved recovery from burst packet loss, high RTT, RTP gaps, token refresh failures, and long-running video stalls.
- Made controller delivery more reliable under data-channel backpressure, reducing sticky or missing button transitions.
- Stabilized low-latency audio playback and recovery after audio-source resets.
PlayStation streaming
- Expanded local PS4 and PS5 discovery, pairing, wake-up, and connection handling, including offline-activated consoles and phone-assisted pairing.
- Improved saved-console routing and host probing so previously paired consoles can reconnect more reliably.
- Hardened PSN and local session startup, teardown, first-frame handling, decoder recovery, and packet-loss recovery.
- Improved high-bitrate playback, including 30 Mbps streams, while keeping PlayStation buffering and recovery independent from Xbox policy.
- Restored Remote Play vibration on Switch, including PS5 DualSense haptics and legacy rumble, with clean shutdown when a stream ends.
Video, audio, and controls
- Fixed the green line at the bottom of 720p video by keeping NV12 storage padding out of visible texture dimensions.
- Fixed false renderer-stall recovery when opening in-stream settings or button mapping, preventing unintended disconnects and crashes while keeping transport and decoder recovery active.
- Separated Xbox and PlayStation video paths so each protocol can apply its own buffering and recovery policy.
- Improved audio/video queue handling, hardware-decoder acceptance checks, and keyframe recovery after corruption or loss.
- Added independent Xbox and PlayStation button-mapping profiles.
- Prevented the in-stream quick menu from leaking input to the remote console and made stream exit progress clearer.
Interface and distribution
- Redesigned Xbox Cloud Gaming library browsing.
- Rebuilt the in-app About area with controller-friendly Project, Changelog, Community, and Support pages.
- Added direct project and release links, QQ and Discord community access, and optional support QR codes.
- Added clearer update download progress, speed, and ETA reporting.
- Added versioned GitHub releases with NRO and ZIP packages plus SHA-256 checksums.
- Added a Sphaira app-store banner and refreshed the English and Simplified Chinese installation and feature documentation.
- Added clearer diagnostics for connection, media startup, loss recovery, and shutdown failures.
Notes
- LunarNX remains early-stage homebrew software. PlayStation local pairing and streaming need broader testing across console models, firmware versions, and network environments.
- Launch LunarNX through Homebrew Menu title override/full-memory mode; Applet Mode does not provide enough memory for reliable streaming and hardware decoding.
LunarNX v0.2.0
Highlights
- Added PlayStation Remote Play for paired PS4 and PS5 consoles, including local discovery, pairing, wake-up, and streaming.
- Added PlayStation Network phone/QR sign-in, PS5 discovery, and remote PS5 streaming through PSN.
- Added PS5 HEVC playback; PS4 sessions continue to use H.264.
- Added separate Xbox and PlayStation button-mapping profiles with combination support. The Switch Capture button can be mapped to Xbox Guide/Nexus or other remote buttons.
- Added PlayStation touchpad gestures and Switch six-axis motion forwarding.
- Redesigned the controller-first Xbox/PlayStation interface and About page.
- Improved Xbox phone sign-in, stream recovery after returning from HOME, console caching, long-session statistics, and connection diagnostics.
- Built with application diagnostics, drop diagnostics, network diagnostics, Xbox response tracing, and curl verbose logging disabled.
主要更新
- 新增 PS4/PS5 PlayStation Remote Play，支持局域网发现、配对、唤醒与串流。
- 新增 PSN 手机扫码登录、PS5 设备发现及通过 PSN 进行 PS5 异地串流。
- 新增 PS5 HEVC 播放；PS4 会话继续使用 H.264。
- 新增 Xbox 与 PlayStation 独立按键映射及组合键；Switch 截图键可映射为 Xbox Guide/Nexus 等远端按键。
- 新增 PlayStation 触摸板手势与 Switch 六轴体感转发。
- 重构 Xbox/PlayStation 平台化界面与关于页面。
- 改善 Xbox 手机登录、从 HOME 返回后的串流恢复、主机缓存、长时间串流统计与连接诊断。
- 正式版已关闭应用诊断、丢帧诊断、网络诊断、Xbox 响应跟踪和 curl 详细日志。
Known limitations / 已知限制
- LunarNX remains early-stage homebrew. Real Switch hardware and network environments may behave differently.
- Remote streaming depends on console settings, account permissions, NAT behavior, platform services, and network quality.
- Internet Remote Play to a personal Xbox still requires a direct network path and may fail behind restrictive NAT or firewalls.
- Local PS4/PS5 support is implemented but still needs broader coverage across console models and firmware versions.
LunarNX 仍处于早期阶段。异地串流会受到主机设置、账号权限、NAT、平台服务和网络质量影响。Xbox 异地 Remote Play 仍需要网络直连；PS4/PS5 局域网功能仍需覆盖更多主机型号和系统版本。
License / 许可证
This combined Xbox/PlayStation binary links against chiaki-ng and is distributed under AGPL-3.0. Complete corresponding source and dependency modifications are available from the v0.2.0 tag.
包含 PlayStation 功能的合并二进制链接了 chiaki-ng，按 AGPL-3.0 分发；完整对应源码与依赖修改可从 v0.2.0 标签获取。
SHA-256: a7b08e1ed5ad5719968f7488fb0a511a668517c656f950e91034f855d052eb21
LunarNX v0.1.0
Highlights
- Tested Xbox console Remote Play and Xbox Cloud Gaming on real Switch hardware at 720p, 1080p, and 1080p HQ.
- Improved recovery from short packet-loss bursts, delayed packets, and missing video frames.
- Reduced stream stalls by bounding network receive work and keeping media processing responsive.
- Improved cloud-stream startup, 1080p/HQ playback, resolution transitions, and decoder recovery.
- Refreshed the English and Chinese user guides with clearer installation, controls, and troubleshooting steps.
主要更新
- 已在真实 Switch 上验证本地主机串流与 Xbox Cloud Gaming，覆盖 720p、1080p 和 1080p HQ。
- 改善短时丢包、乱序包和视频帧缺失后的恢复速度，减少画面长时间卡住。
- 限制单次网络接收工作量，降低串流主循环被阻塞造成的卡顿。
- 改善云游戏启动、1080p/HQ 播放、分辨率切换和解码器恢复。
- 重写中英文用户指南，简化安装、按键和常见问题说明。
Known limitation / 已知限制
Internet Remote Play to a personal Xbox still requires a direct network path and may fail behind restrictive NAT or firewalls because TURN relay fallback is not yet available.
异地连接自己的 Xbox 主机仍依赖网络直连；严格 NAT 或防火墙环境可能无法连接，目前尚未提供 TURN 中继回退。
SHA-256: e4eb31411c3b2533634680f03afbdf2835688eaa845305128c389c38e41e1709
version v0.0.1
v_0.0.1 improve WebRTC latency and recovery metrics
beta version v0.0.1
improve ui
beta version v0.0.1
v0.0.1-beta.1 docs: clarify Xbox Guide controls
alpha version v0.0.1
v0.0.1-alpha first commit