Turn your Android tablet into a true second display across multiple MacBooks β USB-C or wireless over WiFi with instant Multi-Mac Takeover
SideKick is an independent fork of SideScreen, originally created by Tran Vuong Quoc Dat (sidescreen.dev).
π A Huge Thank You to Tran Vuong Quoc Dat
All credit for the foundational architecture β the ultra-low-latency hardware-accelerated H.265 streaming pipeline, the native macOS
CGVirtualDisplayintegration, the AndroidMediaCodecdecoder, and predictive touch input β goes to Tran Vuong Quoc Dat.I am deeply grateful for his outstanding engineering work on SideScreen and for his generous decision to release the entire project as open source under the MIT License. Without his craftsmanship and commitment to open source, SideKick would not exist. If you enjoy using SideKick, please consider supporting his original work!
While the original SideScreen provides an exceptional streaming engine for connecting an Android tablet to a single Mac, SideKick extends and re-engineers the macOS host and Android client specifically for seamless wireless multi-Mac workflows β allowing you to move one Android tablet effortlessly between two or more MacBooks.
| Capability | Original SideScreen (Upstream) |
SideKick Fork (My Additions) |
|---|---|---|
| Core Streaming Engine | Hardware-accelerated H.265 (VideoToolbox β MediaCodec), sub-16ms USB / <30ms WiFi latency |
Inherited from upstream |
| Virtual Display & Input | Native macOS CGVirtualDisplay, HiDPI (Retina 2Γ), 30β120 FPS, Gaming Boost, Touch Prediction |
Inherited from upstream |
| Headless Mac Support | Launch at Login & Auto-start streaming (v0.11.0) | Inherited from upstream |
| Wireless Pairing | Single paired Mac (scanning a second Mac overwrites the first) | Multi-Mac Pairing: Pair once per MacBook; Android stores all paired Macs persistently |
| IP Address Changes | Requires re-scanning the QR code if the Mac's LAN IP changes | Automatic Bonjour / mDNS (_sidescreen._tcp): Dynamically discovers paired Macs and updates their IP addresses |
| Smart Startup on Android | Auto-reconnects to the single saved IP | Smart Multi-Mac Connect: Auto-connects if 1 paired Mac is online; opens a pre-filtered Mac picker if multiple paired Macs are online |
| Switching Between Macs | Manual disconnect + re-pair or manual IP swap | Two-Way Instant Takeover (ββ§T): Pull the tablet to your current Mac via HMAC-SHA256 UDP handover (54322) or switch Macs directly from the Android in-stream dialog |
| Virtual Display Lifecycle | Created when the streaming server starts | Strictly On-Demand + Disconnect Tablet (ββ§D): Display is created only when a tablet connects and destroyed immediately on disconnect so windows never get lost on an unseen monitor |
| Resolution / HiDPI Changes | Rebuilds server and drops active tablet connection | Live Display Rebuild: Switching resolution, HiDPI, or refresh rate updates the virtual display in-place while keeping the tablet connected |
| Wireless Security | Plaintext token handshake (SSWA) & unencrypted TCP stream |
End-to-End Encrypted Wireless (SSWE): Mutual HMAC-SHA256 challenge-response (token never sent in plaintext) + optional AES-256-GCM stream encryption (enabled by default) + live Android security status HUD (π AES-256 / π Off / π USB) |
| Keyboard Forwarding | Touch & mouse input only | Hardware & On-Screen Keyboard Forwarding: Forward Bluetooth/USB/cover keyboards and the Android soft keyboard (via floating keyboard button) to macOS, gated by the Mac's Keyboard Control permission toggle |
| macOS Menu Bar & UI | Classic NSMenu dropdown + single scrolling settings window |
Native Menu Bar Popover (NSPopover) + 4-Tab Settings UI: Left-click (or ββ§W) opens live metrics, Start/Stop, Takeover, Disconnect, Mode switch, and Touch/Keyboard/Encryption toggles; right-click opens the full dropdown menu |
| macOS TCC Permissions | Signed with upstream developer ID; manual TCC handling on custom builds | Persistent Local Signing & One-Click TCC Reset: Includes ./scripts/setup_signing_cert.sh ("SideKick Local Signing"), automatic TCC reset on binary changes, and live Accessibility status + Reset & Prompt right inside Display & Touch |
| Automation & Launcher | GUI only | URL Scheme, CLI & Vorssaint Integration: Control via sidekick://takeover, sidekick://disconnect, sidekick://toggle, CLI flags, and automatic Vorssaint Quick Links |
| App Identity & Updates | SideScreen.app (com.sidescreen.app) with Sparkle & Play Store auto-update |
SideKick.app (com.sidekick.app): Separate bundle/app ID with upstream auto-updaters disabled so custom builds are never overwritten |
- Multi-Mac Wireless Pairing & Bonjour Discovery (
_sidescreen._tcp): Pair once per MacBook via QR code. The Android app stores every paired MacBook persistently, discovers which Macs are currently online via mDNS/Bonjour, and automatically tracks changing DHCP IP addresses. - Two-Way Instant Takeover (
ββ§T): Switch the active tablet stream between MacBooks at any time:- From Mac: Click Take Over Tablet in the menu bar / Settings footer or press
ββ§T(sends an HMAC-SHA256 authenticated UDP broadcast on port54322). - From Android: Open the in-stream settings overlay (
β) while streaming and tap another paired MacBook to switch immediately.
- From Mac: Click Take Over Tablet in the menu bar / Settings footer or press
- End-to-End Wireless Encryption (
SSWE/ AES-256-GCM): Wireless connections use a mutual HMAC-SHA256 challenge-response handshake (so the 256-bit pairing token is never sent in plaintext over the air) and encrypt all video frames, display configs, touch input, and keyboard events using hardware-accelerated AES-256-GCM with per-session ephemeral keys. The Android stats overlay (SECURITYcolumn), in-stream settings banner, and connect toast display the active encryption state in real time. - Native macOS Menu Bar Popover (
NSPopover): Left-click the SideKick menu bar icon (or pressββ§W) for an instant quick-control popover showing live FPS, bitrate, resolution, Start/Stop, Takeover (ββ§T), Disconnect (ββ§D), USB/Wi-Fi switch, and Touch / Keyboard / Encryption toggles. Right-click (or Control-click) opens the classic dropdown menu. - Tablet-to-Mac Keyboard Forwarding: Use a Bluetooth/USB/cover keyboard or tap the floating keyboard icon on Android to type directly into macOS (including
β,β₯,β,β§shortcuts, navigation,F1βF12, and international characters). Keyboard input can be blocked in one click from the Mac app (Menu Bar Popover or Settings β Display & Touch), and re-enabling it requires Touch ID / macOS user password. - On-Demand Virtual Display & Disconnect Tablet (
ββ§D): The macOS virtual display is only active while a tablet is actually streaming. Use Disconnect Tablet (ββ§D) to end the tablet session and remove the virtual display while keeping the Mac server listening in standby. - Live Resolution, HiDPI & Refresh Rate Switching: Change resolution, Retina/HiDPI mode, or frame rate on the fly β the Mac rebuilds the virtual display and notifies the Android decoder without dropping your session.
- URL Scheme, CLI & Vorssaint Command Bar Integration:
- URL Scheme:
sidekick://takeover,sidekick://disconnect,sidekick://toggle,sidekick://start,sidekick://stop,sidekick://settings - CLI Flags:
/Applications/SideKick.app/Contents/MacOS/SideKick --takeover(or--disconnect,--toggle,--start,--stop,--settings) - Vorssaint Integration: Automatically registers Quick Links when
/Applications/Vorssaint.appis present (or re-register any time under Settings β System & Status β Maintenance & Integrations).
- URL Scheme:
Two ways to connect, same picture quality. USB-C plugs in the cable for the lowest possible latency β adb reverse port forwarding is set up automatically. Wireless lets you scan a QR code from the Mac once and connect over WiFi (5 GHz strongly recommended). The auth token is generated locally and stays on your Mac; reset it any time to revoke access.
Creates a true hardware-backed virtual display on your Mac. Drag windows to your tablet like a real monitor β extending your desktop rather than mirroring.
Hardware-accelerated H.265 encoding on Mac and decoding on Android. Async pipeline architecture delivers frames in under 30ms.
Use your tablet's touchscreen to interact with macOS. Touch prediction compensates for network latency, making taps and drags feel natural.
Enable HiDPI mode to render at 2Γ resolution internally β text and icons are sharp at any logical resolution, just like a MacBook Retina display. Perfect for 2K/4K tablets.
Enable Gaming Boost for optimized settings: 1 Gbps bitrate, ultra-low latency encoding, 120 FPS.
Run a Mac with no display of its own β a Mac Studio or Mini on the go, or a laptop in clamshell β using the tablet as its only screen. Enable Launch at Login and Auto-start streaming on launch under Settings β Connection, and the Mac boots straight into standby for your tablet.
| macOS Host | Android Client | |
|---|---|---|
| OS | macOS 13 (Ventura)+ | Android 8.0 (API 26)+ |
| Hardware | Apple Silicon or Intel | H.265 hardware decoder |
| USB mode | USB-C port + adb (brew install --cask android-platform-tools) |
USB-C cable + USB Debugging enabled |
| Wireless mode | Same WiFi network as the tablet (5 GHz recommended) | Camera (for QR scan) + Google Play Services (for ML Kit barcode) |
Install or upgrade SideKick on macOS via my Homebrew Cask tap (kleinski/homebrew-sidekick):
brew install --cask kleinski/sidekick/sidekickTo upgrade later:
brew upgrade --cask kleinski/sidekick/sidekickQuarantine attributes (
com.apple.quarantine) are cleared automatically during Homebrew installation viapostflight_steps.
Download the latest SideKick builds from GitHub Releases (kleinski/SideKick):
- macOS (
SideKick-<version>-mac-universal.dmg):- Download the
.dmg, open it, and drag SideKick.app to/Applications. - Since SideKick is built as an independent open-source fork without an Apple Developer ID notarization certificate, clear the quarantine attribute before first launch if macOS Gatekeeper prompts you:
xattr -cr /Applications/SideKick.app
- Download the
- Android (
SideKick-<version>-android-release.apk):- Download and install the
.apkdirectly on your Android tablet, or install via ADB:adb install -r SideKick-1.2.9-android-release.apk
- Because SideKick uses the package ID
com.sidekick.app, it can be installed alongside the original Google PlaySideScreenapp without conflict.
- Download and install the
Looking for the original single-Mac version? The upstream project by Tran Vuong Quoc Dat is available on Google Play and tranvuongquocdat/SideScreen Releases.
β οΈ ADB Required for USB Mode For wired USB-C connections, the Mac app needsadbto set up port forwarding:brew install --cask android-platform-tools
Build from source & persistent local code signing (recommended for macOS updates)
git clone https://github.com/kleinski/SideKick.git
cd SideKick
# 1. Optional (once per Mac): create a persistent local code-signing certificate
# so macOS remembers Screen Recording & Accessibility permissions across updates
./scripts/setup_signing_cert.sh
# 2. Build & install macOS app (/Applications/SideKick.app + universal .dmg)
./scripts/build_mac.sh
./scripts/install_mac.sh
# 3. Build & install Android APK
./scripts/build_android.sh
./scripts/install_android.sh- Launch SideKick on each of your MacBooks β in the Connection tab, select Wireless and click Start (a QR code appears).
- Open SideKick on your Android tablet β switch to the Wireless tab β tap Scan QR Code and scan each MacBook once.
- Automatic Connection & Switching:
- When only one paired MacBook is running SideKick on your WiFi, opening the Android app connects to it automatically.
- When multiple paired MacBooks are online, the Android app highlights the online Macs (
β Online) so you can pick which Mac to connect to. - Switch Macs at any time: Press
ββ§T(or click Takeover in the Menu Bar Popover) on the MacBook you want to switch to, or open the in-stream settings (β) on the tablet and tap another paired Mac. - Disconnect without stopping the server: Press
ββ§D(or click Disconnect Tablet in the Menu Bar Popover) to close the tablet session and remove the virtual display while keeping the Mac ready for the next connection. - Type from your tablet: Connect a hardware keyboard or tap the floating Keyboard icon next to
βon Android to open the on-screen keyboard. Toggle Keyboard Control in the Mac Menu Bar Popover (or Settings β Display & Touch) to allow or block keyboard input.
- Connect the tablet to your Mac via USB-C.
- In SideKick on Mac β Connection tab β select USB (Cable) and click Start.
- Open SideKick on the tablet β USB tab β tap Connect.
Settings in the macOS app are organized into four tabs:
| Tab | Settings & Actions |
|---|---|
| Connection | Mode (USB / Wireless), QR Code & Paired Token management, Launch at Login, Auto-start streaming on launch, Startup mode |
| Display & Touch | Resolution presets (720p to 8K + custom), HiDPI (Retina) mode, Enable Touch Input, Enable Keyboard Input, Accessibility Permission status + Reset & Prompt (all display changes apply live without disconnecting the tablet) |
| Stream & Quality | Refresh Rate (30β120 Hz), Target Bitrate (20β5000 Mbps), Encoding Latency, Gaming Boost (1 Gbps, 120 Hz) |
| System & Status | Live connection & permission status, Reset macOS Permissions (TCC), Register Actions in Vorssaint |
macOS permissions (Screen Recording / Accessibility) stop working after an update
Open SideKick Settings β System & Status β Maintenance & Integrations and click Reset Permissions, then re-enable SideKick in System Settings β Privacy & Security β Screen Recording and Accessibility. To prevent macOS from invalidating permissions on future local builds, run ./scripts/setup_signing_cert.sh once and mark "SideKick Local Signing" as Always Trust in Keychain Access.
"Connection refused" on Android (USB mode)
The Mac app sets up adb reverse automatically when streaming starts. Make sure adb is installed (brew install --cask android-platform-tools) and USB debugging is enabled on your tablet.
Wireless: "Couldn't reach Mac" / connection times out
- Both devices must be on the same WiFi network and subnet (5 GHz strongly recommended).
- Click Start on the Mac so the server and Bonjour service (
_sidescreen._tcp) are active. - Ensure macOS Local Network permission is granted for SideKick.
Tablet goes black whenever an app is fullscreen on the Mac
With "Displays have separate Spaces" turned off, macOS blanks every other display when an app enters fullscreen. Turn it on in System Settings β Desktop & Dock β Mission Control β Displays have separate Spaces, then log out and back in.
Special thanks and my sincere gratitude go to Tran Vuong Quoc Dat for creating SideScreen (sidescreen.dev) and generously publishing his work under the permissive MIT License. Building a reliable, sub-16ms virtual display and H.265 streaming stack across macOS and Android is a remarkable technical achievement, and sharing it freely with the community made it possible for me to build SideKick on top of his solid foundation.
If SideKick or SideScreen is useful to your daily workflow, please consider supporting Tran Vuong Quoc Dat and his original project:
- Original Project (
SideScreen): Tran Vuong Quoc Dat β tranvuongquocdat/SideScreen Β· sidescreen.dev - SideKick Multi-Mac Fork: Maintained by kleinski β kleinski/SideKick
MIT License β free for personal and commercial use.


