Controlla turns your iPhone or iPad into a wireless keyboard and mouse for your Mac or Windows PC over WiFi. Control your computer from anywhere in the room with smooth joystick navigation, text input, and mouse clicks.
🌐 View Promo Page |
- Virtual Joystick Mouse Control - Smooth, game-controller-like cursor movement
- Text Input - Type on your Mac from your iPhone/iPad
- Mouse Clicks - Left and right click buttons
- Keyboard Actions - Quick access to Enter, Backspace, and Space
- Auto-Discovery - Finds your Mac automatically via Bonjour
- Persistent Connection - Low-latency TCP connection for real-time control
- Cross-Platform - Universal app for iPhone, iPad, and Mac
- Free: Virtual joystick + Mouse clicks (L/R buttons) - Full mouse control
- Pro ($0.99/month): Text input + Keyboard actions (Enter, Backspace, Space)
- 7-day free trial of Pro features
- Family Sharing supported
- Controller: iPhone, iPad, Mac
- Receiver: Mac, Windows
- iOS 15.0+ or macOS 12.0+
- Xcode 16.4
- WiFi network (devices must be on same network)
- Windows 10/11
- .NET 8.0 SDK (for building from source)
- WiFi network (devices must be on same network)
- Service Discovery: Bonjour (_controlla._tcp)
- Communication: HTTP over persistent TCP connection
- Port: Auto-assigned by OS
- Endpoints:
/keyboard/text,/keyboard/key,/mouse/move,/mouse/click
- NetworkManager.swift - Handles Bonjour discovery, TCP connections, and command sending
- InputSimulator.swift - Simulates keyboard/mouse input on Mac using CoreGraphics
- ContentView.swift - SwiftUI UI with Controller and Receiver modes
- HIDKeycodeMapper.swift - Character to HID keycode conversion
- x^4.5 acceleration curve for extended low-speed precision
- 0.6-43 pixels per update (25ms intervals)
- Sub-pixel accumulation for smooth movement
- Send throttling to prevent queue buildup
- Velocity smoothing (35%) for consistent feel
controlla/
├── AirType/ # iOS/macOS app source code
│ ├── ContentView.swift # SwiftUI UI with tabs and joystick
│ ├── NetworkManager.swift # WiFi networking and Bonjour
│ ├── InputSimulator.swift # Mac input simulation
│ └── PaywallView.swift # Subscription paywall
│
├── AirControllaWindows/ # Windows receiver app
│ └── AirControllaWindows/
│ ├── NetworkManager.cs # TCP listener and mDNS
│ ├── InputSimulator.cs # Windows input simulation
│ ├── MainWindow.xaml # WPF UI
│ └── AirControllaWindows.csproj
│
├── deployment/ # App Store deployment automation
│ ├── api.py # App Store Connect API client
│ ├── metadata.py # Metadata upload
│ ├── screenshots.py # Screenshot upload
│ ├── metadata/ # App Store text content
│ ├── screenshots/ # iOS and macOS screenshots
│ └── AuthKey_*.p8 # API key (gitignored)
│
├── scripts/ # Build and deployment scripts
│ ├── archive_and_upload.sh # iOS build
│ ├── archive_and_upload_macos.sh # macOS build
│ ├── deploy.py # Metadata/screenshot automation
│ └── upload_macos_screenshots.py # macOS screenshot upload
│
├── docs/ # GitHub Pages website
│ ├── index.html # Landing page
│ ├── privacy.html # Privacy Policy
│ └── terms.html # Terms of Use
│
├── DEPLOYMENT.md # Complete deployment guide
├── NEXT_STEPS.md # Submission checklist
└── README.md # This file
- Build and run on Mac
- Switch to "App Mode" tab
- Select "Receiver" mode
- Grant Accessibility permissions when prompted
- App will show "Ready - [Your Mac Name]"
- Download
AirControlla.exefrom Releases - Run the executable (Windows will prompt for firewall access - allow it)
- The app will show "Receiver Mode" and wait for connection
- Both devices must be on the same WiFi network
Building from source:
cd AirControllaWindows/AirControllaWindows
dotnet restore
dotnet build
dotnet runCreating distributable .exe:
dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true
# Output: bin/Release/net8.0-windows/win-x64/publish/AirControlla.exe- Build and run on iPhone/iPad
- Ensure you're on the same WiFi as your Mac/PC
- Go to "Devices" tab
- Select your computer from the discovered devices list
- Use the joystick, text input, and buttons to control your computer
macOS: Accessibility permissions required for input simulation (prompted on first launch)
Windows: Firewall access required for network communication (prompted on first launch). For full input simulation, run as Administrator.
- Only works on same WiFi network
- No internet connection required
- No data leaves local network
- Bonjour service automatically secured by WiFi encryption
- Keyboard: CGEvent API with HID keycode mapping
- Mouse Movement: Relative delta positioning
- Mouse Clicks: CGEvent mouse button simulation
- Coordinate System: Top-left origin (standard macOS screen coordinates)
Automated deployment system using App Store Connect API:
# Build iOS and macOS
./scripts/archive_and_upload.sh
./scripts/archive_and_upload_macos.sh
# Upload screenshots and metadata
python3 scripts/deploy.py --screenshots
python3 scripts/upload_macos_screenshots.pySee DEPLOYMENT.md for complete guide and NEXT_STEPS.md for submission checklist.
The docs/ folder contains the website hosted at https://okekedev.github.io/controlla/
To enable:
- Push to GitHub
- Go to Settings → Pages
- Source: Deploy from branch
main/ folder/docs - URLs:
These URLs are required for App Store submission.
Source Available - Commercial Software
This source code is publicly available for transparency and educational purposes. See LICENSE for details.
TL;DR:
- ✅ View, study, and learn from the code
- ✅ Report bugs and contribute improvements
- ✅ Use for educational purposes
- ❌ Commercial use or redistribution
- ❌ Publishing competing apps
- ❌ Using the "Controlla" trademark
For commercial licensing inquiries, contact: https://sundai.us
Built with Swift 6, SwiftUI, Network framework, and CoreGraphics.
Optimized for iOS 15+ / macOS 12+ and Xcode 16.4