User Guide
Install & use OneMouse
Step-by-step: download, connect, and control all your computers with one mouse.
01Download
Download the app
OneMouse runs on Windows and macOS. Install it on every computer you want to control.
- Go to onemouse.net/download
- Choose Windows or macOS
- Click Download — file saves to your Downloads folder
- Repeat on each computer you want to connect
💡 Both platforms? Install on both your Windows PC and Mac — one account links them all.
Official Downloads
Download OneMouse
Windows
10/11, 64-bit
⬇ Download
v1.0.105 · ~66 MB
macOS
13+, Universal
⬇ Download
v1.0.105 · ~101 MB
02Install · Windows
Install on Windows
Standard .exe installer — no extra dependencies needed.
- Run OneMouse-win-Setup.exe from Downloads
- If SmartScreen appears → click More info → Run anyway
- Installer runs silently — done in seconds
- OneMouse icon appears in the system tray (bottom-right)
⚠ SmartScreen is expected Click “More info → Run anyway”. OneMouse isn’t EV-signed yet but is safe.
💡 Portable option Download the Portable ZIP and run OneMouse.Client.exe directly — no install needed.
After “More info”:
✓ Run anyway
✅ Installed — system tray:
10:42
03Install · macOS
Install on macOS
Standard DMG — drag to Applications, then grant two required permissions.
- Open OneMouse-mac-arm64.dmg from Downloads
- Drag OneMouse into the Applications folder
- Open from Applications — allow if macOS warns
- Grant Accessibility permission when prompted
- Grant Input Monitoring permission when prompted
- OneMouse icon appears in the menu bar (top-right)
⚠ Both permissions required Without Accessibility AND Input Monitoring, OneMouse cannot control input. Grant both in System Settings → Privacy & Security.
💡 Universal binary One DMG for Apple Silicon (M1/M2/M3) and Intel Macs.
OneMouse
drag
Applications
04Create Account
Create your account
One account links all your computers. Create it once on the website.
- Go to onemouse.net/register
- Click “Continue with Google” — choose your Google account
- Password panel opens automatically on the same page
- Set a password (min 6 chars) — this is your app login password
- Done — use this email + password to sign in on every desktop app
💡 Already have an account? Skip to Step 05. Same email and password on all your computers.
Create Account
Verify with Google, then set your password
Step 1 — Continue with Google
✓ Google verified
🔒 New password
🔒 Confirm password
Create Password
05Sign In
Sign in on each computer
Same account on every computer — this is how OneMouse links your devices.
- Click the OneMouse icon in the system tray (Win) or menu bar (Mac)
- Enter your email and password → Sign In
- Your computer appears in the device list
- Repeat on every computer you want to connect
💡 Same credentials everywhere Use the exact same email on all computers — OneMouse auto-groups all signed-in devices.
06Screen Layout
Set the screen layout
Tell OneMouse which side of your screen the peer is — this determines the trigger edge.
- Select the peer in the Devices list
- Open the Layout tab
- Choose peer position: Left, Right, Top, or Bottom
- Example: Mac is to the right of your PC → select Right
- Click Save
💡 Match your desk If Mac is on the left, set Left. Push cursor to the left edge to jump to Mac.
MacBook Pro — Position
Top
Left
This PC
Right ✓
Bottom
Windows
MacBook
MacBook is to the Right of Windows PC
07Cursor Handoff
Move between screens
Push your cursor to the screen edge where the peer is — it crosses to the other computer.
- Move cursor toward the screen edge in the peer’s direction
- Keep moving — cursor crosses to the peer’s screen
- You now control the peer with your mouse
- Keyboard follows automatically — all keystrokes go to peer
- To return: push cursor back to the edge facing Master
💡 Edge matches layout If peer is set to Right, push to the right edge. Layout setting controls which edge triggers handoff.
🖱 Mouse
Transfers at edge
⌨ Keyboard
Follows automatically
08Keyboard
Keyboard forwarding
Every keystroke goes to the peer when cursor is on its screen. Cross-platform shortcuts are translated automatically.
- Cursor on peer screen → keyboard follows
- Ctrl+C on Windows → ⌘+C on macOS (auto-translated)
- Alt+Tab on Windows → ⌥+Tab on macOS
- F1–F12, arrow keys, numpad — all forwarded
- Move cursor back to your screen to type locally
💡 Auto-translated Ctrl ↔ ⌘ and Alt ↔ ⌥ are swapped automatically. Use the same shortcuts on both OS.
Ctrl+C
⌘+C
Ctrl+Z
⌘+Z
Alt+Tab
⌥+Tab
Modifier keys translated automatically
09Clipboard
Copy & paste across computers
Copy on one computer, paste on the other — text, images, and rich content.
- Copy on Computer A — Ctrl+C / ⌘+C
- Move cursor to Computer B
- Paste on Computer B — Ctrl+V / ⌘+V
- Works in reverse too — copy on B, paste on A
💡 What syncs Text, rich text, images (PNG/JPEG), URLs. Files over 5 MB are not synced.
sync
Syncs instantly — text, images, rich content
10Networking
LAN & Relay
OneMouse picks the best network mode automatically — no configuration needed.
🏠 LAN — Direct connection
- Same Wi-Fi or Ethernet network — direct, no cloud
- Latency: 1–5 ms — works offline
☁ Relay — Different networks
- Home vs office, different ISPs — routed through relay servers
- Latency: 15–80 ms — end-to-end encrypted
💡 Zero config OneMouse tries LAN first, falls back to relay automatically.
🏠 LAN — Direct
🖥
PC
192.168.1.10
4 ms · direct
💻
Mac
192.168.1.42
☁ Relay — Cross-network
🖥
Home PC
Network A
☁ Relay
~35 ms · encrypted
💻
Work Mac
Network B
Tips & Tricks
Get the most out of OneMouse.
🚀
Launch at startup
Enable in Settings — OneMouse starts with your computer, always ready.
🔑
Reclaim hotkey
Set a hotkey to instantly snap keyboard and mouse back to the Master computer.
🔍
Multi-monitor
Cursor exits from the correct physical display edge in multi-monitor setups.
🌙
Sleep & wake
OneMouse reconnects automatically when the peer wakes from sleep.
🔒
Privacy
Relay traffic is AES-encrypted end-to-end. No input data stored on servers.
⚡
Lowest latency
Use Ethernet instead of Wi-Fi on both computers for latency under 2 ms.
Troubleshooting
Common issues and solutions.
Cursor doesn’t move to peer screen
- Session must be active (green indicator in the app)
- Layout must match the physical screen position
- Both computers must be signed in with the same email
- Click Start again to re-establish the connection
- macOS: enable OneMouse in System Settings → Accessibility
Devices don’t appear in the device list
- Both computers must use the exact same email address
- Check internet connection — device list syncs via cloud
- Wait 10–20 seconds after signing in
- Sign out and sign in again on one device
macOS: keyboard / mouse not captured
- System Settings → Privacy & Security → Accessibility → enable OneMouse
- System Settings → Privacy & Security → Input Monitoring → enable OneMouse
- Restart OneMouse after granting permissions
Windows: SmartScreen blocks the installer
- Click More info on the SmartScreen popup
- Click Run anyway — the app is safe
High latency / laggy cursor
- Check latency in app: LAN < 10 ms, relay 15–80 ms
- Connect both computers to the same Wi-Fi network
- Use Ethernet instead of Wi-Fi for best performance
- Disconnect VPN if active — VPN can add significant latency
Clipboard sync not working
- Session must be active (green status)
- macOS: grant both Accessibility and Input Monitoring
- Content over 5 MB may not sync
Connection drops frequently
- Unstable Wi-Fi is the most common cause — switch to Ethernet
- Windows: disable “Allow computer to turn off network adapter” in power settings
- Enable Auto-reconnect in OneMouse Settings
Ready to get started?
Download OneMouse and control all your computers with one mouse.