GameGhost v1.10.0 (v10) — Native Handheld Cast, In-App Live FPS HUD & Ultra-Low Latency

High-Performance PC Gaming Handheld Cast & Universal Controller Subsystem
Created by rayzien & pheonix14
Direct hardware streaming and wireless gamepad subsystem for mobile handheld gaming.

Verified Live Telemetry & Handheld Screen Captures

GameGhost v10 Live Stream (Landscape 2340x1080)	GameGhost Streaming Viewport

What is New in v10 (v1.10.0)

1. In-App Live FPS Counter & Performance HUD:

   • Live hardware-synchronized FPS badge directly embedded inside the on-screen streaming overlay.
   • Real-time video telemetry delivering 85-90+ FPS and up to 24+ MB/s bitrate with 3ms broadcast polling.

2. Ultra-Low-Latency Delivery Pipeline & Button Accuracy:

   • Replaced fixed-rate sleeps with 3ms high-frequency non-blocking polling loops, slashing frame delivery latency.
   • Standardized full PlayStation and Xbox button mapping aliases (TRI, CIR, X, SQR, CROSS, CIRCLE, SQUARE, TRIANGLE) mapped directly to hardware virtual gamepad events via uinput.
   • Native touch coordinate projection directly to PC screen cursor and buttons.

3. Isolated System Audio Streaming:

   • Hardware PipeWire / PulseAudio monitor capture linking automatically to Speaker sink monitors and running games (Tekken 8, DMC5).
   • Low-latency 44.1kHz 16-bit stereo PCM streaming with auto-reconnect recovery on phone network interruptions.

4. Monochromatic Tactical Handheld Client:

   • Zero emojis, clean typography, tactile hexagonal button clusters.
   • Quick input switching: PAD, MOUSE, KBD, and TOUCH.
   • Direct launch into landscape streaming with fast return via DASH.

Donation & Sponsorship

• Litecoin (LTC): ltc1q08zgc7n6lgghfxtlure29mc8dye70r6ccq8gx0

---

GameGhost v7.6.0 — Termux-X11 Video Pipeline, Wayland ScreenCast & Display :1 Sync Release

High-Performance PC Gaming Handheld Cast & Universal Controller Subsystem
Created by rayzien & pheonix14
Based on CPUGhost — works exactly like PlayStation Portal (PS Portal) and cloud gaming, casting local PC games directly to phone anywhere in range.

GameGhost v7.6.0 resolves all video streaming issues on Android Termux with Termux-X11 and Linux hosts. It brings native Mutter ScreenCast PipeWire capture for Wayland environments, eliminates black screen voids with direct game window capture fallbacks, auto-synchronizes Termux-X11 displays across :1, :0, and :2, and updates client rendering heuristics for instant frame display.

---

What is New in v7.6.0

1. Wayland ScreenCast & Zero-Black-Screen Pipeline:

   • Integrated hardware-accelerated Mutter ScreenCast (org.gnome.Mutter.ScreenCast) with PipeWire GStreamer pipeline for zero-black-screen PC streaming on Wayland.
   • Intelligent black-screen detection: automatically detects blank/black frames from Xwayland root capture and falls back to direct XGetImage window capture of active game windows or styled host status.

2. Termux-X11 Display :1 / :0 Process Synchronization:

   • Added running process inspection to automatically detect whether Termux-X11 is serving on display :1 or :0.
   • Prevented conflicts when multiple sockets exist in /tmp and ${PREFIX}/tmp.
   • Auto-launches Termux-X11 daemon on the active target display with -legacy-drawing -ac.

3. Client Video Decoupling & Display Scaling:

   • Timed out black-screen loading banner to prevent permanently covering active game scenes.
   • Flawless full-screen scaling on high-resolution mobile phone displays in Termux-X11.

---

GameGhost v1.7.3 — Termux-X11 Stream Engine, Auto-Focus & Performance Release

High-Performance PC Gaming Handheld Cast & Universal Controller Subsystem
Created by rayzien & pheonix14
Based on CPUGhost (work in progress) — works exactly like PlayStation Portal (PS Portal) and cloud gaming, casting local PC games directly to phone anywhere in range.

GameGhost v1.7.3 delivers complete streaming fixes and optimizations for Android Termux with Termux-X11, introducing zero-black-screen root window compositing, automated game window focus via _NET_ACTIVE_WINDOW, multi-socket Termux display detection (:0, :1, :2), host software rasterizer isolation, non-blocking frame queueing, and cached surface scaling for butter-smooth 60 FPS mobile streaming.

---

What is New in v1.7.3

1. Termux-X11 Stream Pipeline Fixes:

   • Resolved black-screen streaming by preserving root window capture and activating games via _NET_ACTIVE_WINDOW.
   • Multi-socket display detection: auto-discovers :0, :1, :2 displays across ${PREFIX}/tmp/.X11-unix/ and /tmp/.X11-unix/.
   • Automated companion launch: seamlessly launches com.termux.x11 Android app into the foreground.
   • Replaced mode-switching FULLSCREEN on Termux-X11 with borderless resizable window to prevent SDL2 XRandR crashes.

2. Host GPU & Software Rasterizer Isolation:

   • Confined software rasterizer fallbacks (llvmpipe) strictly to Termux clients.
   • PC host streaming and Wine/Proton games always utilize dedicated NVIDIA RTX GPU acceleration.

3. Client Decompression & Scaling Cache:

   • Implemented cached surface scaling in GameGhostViewer to avoid redundant CPU rescaling per tick.
   • Non-blocking frame queueing (put_nowait) prevents asyncio event loop stalls and eliminates ping timeouts.

---

GameGhost v1.7.2 — Multi-Controller, Mouse & Keyboard, Touch Customization & Feedback Hub

---

GameGhost

High-Performance PC Gaming Handheld Cast & Touch Controller Subsystem
Created by rayzien & pheonix14

GameGhost casts your PC games directly to your mobile phone (running Android Termux with Termux-X11) at ultra-low latency, with an interactive on-screen handheld controller (supporting Xbox and PlayStation layout profiles, clickable L3/R3 thumbsticks, dual triggers, and customizable neon themes).

---

What is New in v1.7.2

1. Comprehensive Physical Controller Support:

   • Multi-brand controller detection: Xbox, PlayStation (DualShock / DualSense), and Nintendo Switch (Pro Controller / Joy-Con).
   • Dynamic profile auto-detection with button remapping and trigger normalization (-1.0..1.0 to 0.0..1.0).
   • Radial analog stick deadzones (0.08) to eliminate stick drift.

2. Full Mouse & Keyboard Forwarding:

   • Hardware cursor lock toggle via F10 hotkey or interactive Settings button.
   • Smooth relative mouse motion capture and forwarding (mouse_move).
   • Mouse click injection (mouse_btn: left, right, middle) and scroll wheel (mouse_scroll).
   • Full keyboard event forwarding for precision PC controls.

3. Interactive On-Screen Touch Controls Customization:

   • Touch Scale: Cycle 75%, 100%, 125%, 150% for optimal fingertip ergonomics.
   • Touch Opacity: Cycle 30%, 50%, 75%, 100% alpha for unobscured gameplay visibility.
   • Layout Styles: Choose between Classic, Compact (tucked towards edges), and Wide (tablet landscape grip).

4. Visual Feedback Animations & Styling:

   • Dynamic expanding touch ripple animations upon finger contact.
   • Active button depression (physical press feedback) and glowing neon aura upon actuation.
   • Aspect Ratio Scaling: Choose between Auto (letterboxed native), Stretch (full display), 16:9, 21:9, and 4:3.

5. Stability & Launch Optimizations:

   • Tekken 8: Verified 4-minute continuous stability with Unreal Engine 5 shader optimizations.
   • Mortal Kombat 11: Verified stable launch under DX12 with driver application workarounds and safe hardware sink-level test muting (wpctl).
   • Zero-emoji standard enforced across all user interfaces, logs, HUDs, and documentation.

---

Key Features in v1.6.0

1. Independent Dedicated Architecture:

   • 100% self-contained environment with its own isolated .venv.
   • Dedicated streaming ports (8900 video, 8901 audio, 8990 UDP discovery).
   • Dedicated user configurations and log files in ~/.config/gameghost.

2. Live Log Streaming:

   • Stream live host logs on PC: gameghost logs -f (or gg logs -f).
   • Stream live client logs on phone: gameghost logs --client -f (or gg logs -c -f).
   • Dual-logging to host.log and client.log for instant troubleshooting.

3. Seamless Game Display Capture:

   • Dynamic monitor and game window capture without freezing on standby frames.
   • Automatically attaches directly to Devil May Cry 5, Sekiro, Tekken 8, and other catalog game windows on X11 / Xwayland.
   • Streams primary desktop monitor during game boot, Wine/Proton initialization, and loading screens.

4. Zero-Lag Hotspot Autostart & Auto-Connect:

   • Boot-time network readiness detector (wait_for_hotspot_ip) waits for Wi-Fi/hotspot IP assignment before binding.
   • Automatic background service for 24/7 gaming host operation (gameghost autostart enable).
   • Client automatically detects PC host via UDP broadcast, ARP scan, and local subnet scan.

5. Super Low Data / Internet Modes:

   • New 360p Super Low Data preset (scale 0.45, quality 50, 30 FPS) for cellular mobile hotspots.
   • New 480p Efficient preset (scale 0.55, quality 60, 45 FPS).
   • Standard 720p, 1080p, 1440p, and 4K presets for high-bandwidth local Wi-Fi.

6. Interactive Handheld Client:

   • On-screen HUD toast notifications when games launch (Launching DMC5 on PC..., PC: Started successfully).
   • Interactive top collapsible Quick Settings bar ([PAD], [RES], [FPS], [THM], [VIEW]).
   • Full support for hardware Bluetooth/USB controllers (Kishi, Backbone, Xbox, DualSense).
   • Strict zero-emoji policy across all code, logs, and docs.

---

Quick Start

1. Installation (PC Host & Phone Client)

git clone https://github.com/rayzien/gameghost.git
cd gameghost
./setup.sh

2. Start PC Host in Background

gameghost start
# Or manage autostart:
gameghost autostart enable

3. Stream Live Logs on PC

gameghost logs -f

4. Connect Phone Client (Termux)

# Auto-detect PC host on hotspot/Wi-Fi:
gameghost client

# Or launch Devil May Cry 5 directly:
gg dmc5

# Or stream client logs:
gameghost logs -c -f

---

CLI Reference

Command	Description
gg	Interactive handheld touch menu
gg host	Start streaming host in foreground
gg start	Start streaming host in background daemon
gg stop	Stop running background host
gg restart	Restart background host
gg logs [-f] [-c]	View or stream live host/client logs
gg autostart [enable/disable/status]	Configure 24/7 background autostart
gg client [IP]	Launch handheld client in landscape mode
gg scan	Scan network for active PC gaming hosts
gg dmc5	Launch Devil May Cry 5 & cast to phone
gg sekiro	Launch Sekiro & cast to phone
gg tekken8	Launch Tekken 8 & cast to phone
gg status	Display connection status and IP table
gg update	Check and apply latest updates from GitHub

---

License

MIT License. Designed and maintained by rayzien & pheonix14.