Skip to content

About

Zero-Cloud Cross-Platform Wireless Stream Deck, Remote Trackpad & Proximity Auto-Lock Suite for Windows & Android (Flutter, Electron, React, LAN)

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🖥️ PC Controller (Stream Deck & Remote Workspace Suite)

License: MIT Platform: Windows Mobile: Flutter Desktop: Electron Security: Zero--Cloud

PC Controller is a zero-cloud, privacy-first cross-platform system that transforms your smartphone into a wireless Stream Deck, Remote Trackpad & Keyboard, and Departure Auto-Lock Sentinel for your Windows PC over local Wi-Fi.

Operates purely within your local network (LAN) without cloud dependencies, external telemetry, or third-party servers.


📥 Downloads

Get the latest production releases directly from GitHub Releases:

Platform Type Architecture Direct Download
🪟 Windows 10 / 11 Standalone Desktop App 64-bit (x64) ⬇️ Download PC-Controller-Windows.zip
🤖 Android 8.0+ Mobile Release APK Universal (ARM / x64) ⬇️ Download PC-Controller-Mobile.apk

Tip

Over-The-Air (OTA) LAN Updates: When connected to your PC over Wi-Fi, the Mobile app can also download and install updates directly from the PC host without an internet connection.


🌟 Key Features

🎮 Mobile Controller (Flutter)

  • Virtual Stream Deck: Launch apps, control media, toggle system volume, switch audio output endpoints, and trigger stepped sleep/lock timers.
  • Precision Trackpad & Keyboard: Ultra-low-latency mouse control with multi-touch scrolling, tap-to-click, and remote keyboard typing including Windows OS shortcut keys.
  • Real-Time Telemetry Gauges: Live CPU & RAM utilization meters, active foreground window title, volume level, and live PC battery/power state.
  • Departure Auto-Lock: Automatically locks your Windows workstation when you walk away or disconnect from your designated Wi-Fi network.
  • Wake-on-LAN (WoL): Power on sleep ($S3/S4$) or shutdown ($S5$) computers with 1-tap UDP Magic Packets.
  • Biometric App Protection: Face ID / Fingerprint authentication gate before unlocking PC controls.
  • In-App Auto-Updater: Directly updates over high-speed local Wi-Fi from the PC or GitHub Releases.

💻 Desktop Host Agent (Electron + React)

  • Native Windows C-FFI Driver: High-performance Win32 API bridge via koffi (no external background helper executables).
  • System Tray Mini-App: Sits discreetly in the Windows taskbar with quick PIN regeneration, connected client manager, and update checks.
  • Frameless Futuristic UI: Cyberpunk-inspired dark neon dashboard with live pairing QR codes and telemetry.
  • Dead Man's Switch Watchdog: Auto-locks the PC if mobile keep-alive heartbeats unexpectedly terminate while armed.
  • SafeStorage DPAPI Encryption: Persists pairing authorization tokens using Windows hardware-backed Data Protection API.
  • Local Wi-Fi APK Host: Streams Android APK updates directly over LAN to connected devices.

🔒 Security Architecture

+-----------------------------------------------------------------------------------+
|                            ZERO-TRUST LOCAL PROTOCOL                              |
+-----------------------------------------------------------------------------------+
|  1. SPAKE2+ PAKE Handshake   : Zero-knowledge password authenticated key exchange |
|  2. TLS 1.3 Encryption       : Ephemeral self-signed certificates with TOFU      |
|  3. SAS Verification         : 6-digit & visual Emoji Short Authentication String |
|  4. Anti-Replay Counter      : Monotonically incrementing sequence IDs            |
|  5. DPAPI Storage Guard      : Hardware-backed Windows safeStorage                |
+-----------------------------------------------------------------------------------+

📁 Project Architecture

PcControl/
├── desktop-app/                # Windows Desktop Agent (Electron, React, TypeScript)
│   ├── src/
│   │   ├── main/               # Electron Main Process & Native Services
│   │   │   ├── drivers/        # Koffi C-FFI Win32 Low-Level Driver
│   │   │   ├── server/         # TLS WebSocket Server & mDNS Advertiser
│   │   │   ├── services/       # SPAKE2+, DPAPI Session, Watchdog, Auto-Updater
│   │   │   └── tray.ts         # Windows Taskbar System Tray Manager
│   │   ├── preload/            # Context Bridge & IPC APIs
│   │   └── renderer/           # Cyberpunk React UI & QR Generator
│   └── scripts/                # Standalone ASAR Packaging Pipeline
│
└── mobile-app/                 # Mobile Controller App (Flutter & Riverpod)
    ├── lib/
    │   ├── core/
    │   │   ├── network/        # WebSocket Client, mDNS Scanner & WoL Engine
    │   │   ├── security/       # SPAKE2+ Ed25519 & Biometric Auth
    │   │   └── services/       # In-App Auto-Updater & LAN APK Downloader
    │   └── features/
    │       ├── discovery/      # QR Scan & PIN Pairing Dashboard
    │       ├── dashboard/      # Stream Deck & System Telemetry
    │       ├── trackpad/       # Low-Latency Mouse & Keyboard Input
    │       └── automation/     # Departure Auto-Lock Network Sentinel
    └── test/                   # Comprehensive Unit & Integration Test Suite

🚀 Getting Started

Prerequisites

  • Node.js: v20+ with pnpm
  • Flutter SDK: v3.10+
  • Windows: Windows 10 / 11 (64-bit)
  • Android: Android 8.0+ (API Level 26+)

1. Build & Run Desktop Agent

# Navigate to desktop-app directory
cd desktop-app

# Install dependencies
pnpm install

# Run in development mode
pnpm run dev

# Package standalone release (.exe + ASAR)
pnpm run package:app

The compiled standalone executable will be generated at: desktop-app/release/win-unpacked/PC Controller.exe


2. Build & Run Mobile App

# Navigate to mobile-app directory
cd mobile-app

# Fetch dependencies
flutter pub get

# Run test suite
flutter test

# Run on connected device or emulator
flutter run

# Build release APK with symbol obfuscation
flutter build apk --release --obfuscate --split-debug-info=./symbols/android

The production APK will be generated at: mobile-app/build/app/outputs/flutter-apk/app-release.apk


📱 Pairing Your Devices

  1. Launch PC Controller on your Windows desktop.
  2. Open PC Controller on your phone.
  3. Your PC will appear automatically in the Nearby Devices list via zero-config mDNS.
  4. Tap your PC and enter the 4-digit PIN displayed on your desktop screen (or scan the QR Code).
  5. Confirm the matching Short Authentication String (SAS) code / security emojis.
  6. Your workstation is now paired and secured!

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Zero-Cloud Cross-Platform Wireless Stream Deck, Remote Trackpad & Proximity Auto-Lock Suite for Windows & Android (Flutter, Electron, React, LAN)

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages