How aliihsaad/windock works
WinDock turns an Android phone into a dock and remote-control surface for a Windows or Linux PC on a local network. The main workflow is to discover or select a host, pair or authenticate, load the dock UI, then invoke host capabilities such as app launch, media and input control, screen capture, and file transfer. The repository also includes a developing iOS companion. The map preserves documented features and sampled module relationships; unsampled implementation details are represented only where the source index or README supports them.
Main entry points: server.js HTTP host · MainActivity.kt Android companion · Program.cs Tray controls · index.js Provider selection
Components 28
Phone companions
- Android companion
android/app/src/main/java/com/windock/app/MainActivity.kt - iOS companion
ios/Sources/DockViewController.swift - Host discovery
android/app/src/main/java/com/windock/app/Discovery.kt - PC picker
android/app/src/main/java/com/windock/app/PcPicker.kt - Secure pairing
android/app/src/main/java/com/windock/app/SecurePairing.kt - Secure transport
android/app/src/main/java/com/windock/app/SecureTransport.kt - Files transfer
android/app/src/main/java/com/windock/app/NativeFiles.kt
Dock interface
- Dock application
public/app.js - Input controls
public/input-pad.js - Dock rendering
public/dock.js
Host services
- HTTP host
server.js - Authentication
src/auth.js - Pairing invites
src/pairing-invites.js - Host discovery
src/discovery.js - Preference sync
src/sync.js - Transfer service
src/transfers.js - Update service
src/updates.js
Platform control
- Provider selection
src/platform/index.js - Provider contract
src/platform/contract.js - Windows provider
src/platform/windows.js - Linux provider
src/platform/linux.js - Linux input helper
native/linux/src/main.rs
Windows tray
- Tray controls
native/tray/Program.cs - Pairing window
native/tray/PairingWindow.cs - Pairing client
native/tray/PairingClient.cs - Transfer window
native/tray/TransferWindow.cs - Update checker
native/tray/UpdateChecker.cs
Other components
- Phone user
Connections 26
- Phone user → Android companion: operates
README.md - Android companion → Host discovery: discovers hosts
android/app/src/main/java/com/windock/app/MainActivity.kt - Android companion → PC picker: selects host
android/app/src/main/java/com/windock/app/MainActivity.kt - Android companion → Secure pairing: pairs securely
android/app/src/main/java/com/windock/app/MainActivity.kt - Android companion → Secure transport: uses transport
android/app/src/main/java/com/windock/app/MainActivity.kt - Android companion → Files transfer: opens files
android/app/src/main/java/com/windock/app/MainActivity.kt - Android companion → Dock application: hosts dock
- iOS companion → HTTP host: probes host
ios/Sources/DockViewController.swift - Dock application → Dock rendering: renders dock
public/app.js - Dock application → Input controls: uses controls
public/app.js - HTTP host → Provider selection: creates provider
server.js - HTTP host → Transfer service: creates service
server.js - HTTP host → Authentication: routes authentication
server.js - HTTP host → Pairing invites: routes pairing
server.js - HTTP host → Host discovery: routes discovery
server.js - HTTP host → Preference sync: routes sync
server.js - HTTP host → Update service: routes updates
server.js - Provider selection → Provider contract: validates provider
src/platform/index.js - Provider selection → Windows provider: selects by OS
src/platform/index.js - Provider selection → Linux provider: selects by OS
src/platform/index.js - Linux input helper → Linux provider: serves input protocol
native/linux/src/main.rs - Tray controls → Pairing window: opens window
native/tray/Program.cs - Pairing window → Pairing client: requests invite
native/tray/PairingWindow.cs - Tray controls → Transfer window: opens window
native/tray/Program.cs - Tray controls → Update checker: checks updates
native/tray/Program.cs - Tray controls → HTTP host: resets pairing
native/tray/Program.cs