How 31-gallium/yeval works
Yeval is a phone-to-PC virtual Xbox controller: users discover a Windows host, choose a profile and connection, operate an on-screen controller, and the PC maps received input to virtual Xbox gamepads. The graph also preserves profile/layout editing, settings and updates, the desktop dashboard’s editor and slot-management capabilities, and the documented transport and rumble loop. Source excerpts establish Android composition and parts of the Windows engine; several dashboard and runtime details are represented only where the README documents them.
Main entry points: MainActivity.kt App coordinator · main.cpp Backend engine · main.js Dashboard shell · renderer.js Dashboard renderer
Components 31
Android client
- App coordinator
android/app/src/main/java/com/mobilecontroller/MainActivity.kt - Discovery home
android/app/src/main/java/com/mobilecontroller/HomeView.kt - Touch controller
android/app/src/main/java/com/mobilecontroller/ControllerView.kt - UDP sender
android/app/src/main/java/com/mobilecontroller/UdpSender.kt - TCP sender
android/app/src/main/java/com/mobilecontroller/AdbTcpSender.kt - Profile browser
android/app/src/main/java/com/mobilecontroller/ProfilesView.kt - Layout editor
android/app/src/main/java/com/mobilecontroller/EditorOverlayView.kt - Profile model
android/app/src/main/java/com/mobilecontroller/ProfileManager.kt - Profile storage
android/app/src/main/java/com/mobilecontroller/ProfileStorage.kt - Settings
android/app/src/main/java/com/mobilecontroller/SettingsView.kt - Haptics and rumble
android/app/src/main/java/com/mobilecontroller/VibrationManager.kt - App updater
android/app/src/main/java/com/mobilecontroller/UpdateManager.kt
Desktop dashboard
- Dashboard shell
dashboard/main.js - Dashboard renderer
dashboard/renderer.js - Slot manager
dashboard/slot_manager.js - Layout editor
dashboard/editor.js - Zone editor
dashboard/zone_editor.js
Windows engine
- Backend engine
windows/core/main.cpp - UDP transport
windows/networking/UdpTransport.h - ADB TCP transport
windows/networking/AdbTcpTransport.h - Transport interface
windows/networking/ITransport.h - ViGEm backend
windows/virtual-gamepad/NefariusBackend.h - Gamepad interface
windows/virtual-gamepad/IVirtualGamepadBackend.h
Protocol and profiles
- Controller packet
shared/protocol/controller_protocol.h - Shared profiles
shared/profiles
Other components
- Phone player
- PC user
- Windows games and OS
- ViGEmBus driver
- ADB tunnel
- Release service
Connections 42
- Phone player → App coordinator: uses
README.md - App coordinator → Discovery home: shows
android/app/src/main/java/com/mobilecontroller/MainActivity.kt - App coordinator → Touch controller: shows
android/app/src/main/java/com/mobilecontroller/MainActivity.kt - App coordinator → Profile browser: shows
android/app/src/main/java/com/mobilecontroller/MainActivity.kt - App coordinator → Settings: shows
android/app/src/main/java/com/mobilecontroller/MainActivity.kt - App coordinator → Layout editor: shows
android/app/src/main/java/com/mobilecontroller/MainActivity.kt - Discovery home → App updater: checks updates
android/app/src/main/java/com/mobilecontroller/HomeView.kt - Profile browser → Profile storage: loads profiles
android/app/src/main/java/com/mobilecontroller/ProfilesView.kt - Layout editor → Profile model: edits layout
android/app/src/main/java/com/mobilecontroller/EditorOverlayView.kt - Layout editor → Profile storage: saves layout
android/app/src/main/java/com/mobilecontroller/EditorOverlayView.kt - Profile model → Shared profiles: syncs profiles
README.md - App coordinator → UDP sender: sends input
android/app/src/main/java/com/mobilecontroller/MainActivity.kt - App coordinator → TCP sender: sends input
android/app/src/main/java/com/mobilecontroller/MainActivity.kt - Touch controller → App coordinator: reports touches
android/app/src/main/java/com/mobilecontroller/MainActivity.kt - Settings → Haptics and rumble: configures
android/app/src/main/java/com/mobilecontroller/SettingsView.kt - App coordinator → Haptics and rumble: plays rumble
android/app/src/main/java/com/mobilecontroller/MainActivity.kt - App updater → Release service: checks and downloads
android/app/src/main/java/com/mobilecontroller/UpdateManager.kt - Dashboard shell → Dashboard renderer: hosts UI
- PC user → Dashboard renderer: configures
README.md - Dashboard renderer → Layout editor: opens editor
- Dashboard renderer → Zone editor: opens editor
- Dashboard renderer → Slot manager: reorders slots
- Dashboard shell → Backend engine: routes IPC
README.md - Dashboard shell → App coordinator: discovers phones
README.md - Dashboard shell → Shared profiles: serves layouts
README.md - UDP sender → UDP transport: streams packets
README.md - TCP sender → ADB TCP transport: streams packets
README.md - ADB tunnel → ADB TCP transport: forwards TCP
README.md - UDP transport → Controller packet: decodes packets
windows/networking/UdpTransport.h - ADB TCP transport → Controller packet: decodes packets
windows/networking/AdbTcpTransport.h - UDP transport → Transport interface: implements
windows/networking/UdpTransport.h - ADB TCP transport → Transport interface: implements
windows/networking/AdbTcpTransport.h - Backend engine → UDP transport: starts transport
windows/core/main.cpp - Backend engine → ADB TCP transport: starts transport
windows/core/main.cpp - Backend engine → ViGEm backend: updates controllers
windows/core/main.cpp - ViGEm backend → Gamepad interface: implements
windows/virtual-gamepad/NefariusBackend.h - ViGEm backend → ViGEmBus driver: creates virtual pads
README.md - ViGEmBus driver → Windows games and OS: exposes Xbox pads
README.md - Backend engine → Dashboard shell: exchanges IPC
README.md - Backend engine → TCP sender: returns rumble
README.md - Backend engine → App coordinator: sends rumble
README.md - Dashboard shell → App coordinator: broadcasts reload
README.md