{"id":49539549,"url":"https://github.com/somiona/mwb-client-macos","last_synced_at":"2026-05-02T14:01:21.915Z","repository":{"id":354995993,"uuid":"1226422209","full_name":"Somiona/mwb-client-macos","owner":"Somiona","description":"A native macOS client that connects your Mac to a Windows machine running Mouse Without Borders (part of Microsoft PowerToys). Share a single mouse and keyboard across both machines over your local network.","archived":false,"fork":false,"pushed_at":"2026-05-01T11:29:08.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T11:34:15.891Z","etag":null,"topics":["macos","mousewithoutborders","powertoys","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Somiona.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-01T11:28:56.000Z","updated_at":"2026-05-01T11:30:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Somiona/mwb-client-macos","commit_stats":null,"previous_names":["somiona/mwb-client-macos"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Somiona/mwb-client-macos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Somiona%2Fmwb-client-macos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Somiona%2Fmwb-client-macos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Somiona%2Fmwb-client-macos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Somiona%2Fmwb-client-macos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Somiona","download_url":"https://codeload.github.com/Somiona/mwb-client-macos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Somiona%2Fmwb-client-macos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32536582,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["macos","mousewithoutborders","powertoys","swift"],"created_at":"2026-05-02T14:01:20.091Z","updated_at":"2026-05-02T14:01:21.905Z","avatar_url":"https://github.com/Somiona.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MWB Client for macOS\n\nA native macOS client that connects your Mac to a Windows machine running [Mouse Without Borders](https://learn.microsoft.com/en-us/windows/powertoys/mouse-without-borders) (part of Microsoft PowerToys). Share a single mouse and keyboard across both machines over your local network.\n\n\u003e **Disclaimer:** This project is independent and is not affiliated with or endorsed by Microsoft. It interoperates with the PowerToys Mouse Without Borders protocol by studying the published open-source implementation at [microsoft/PowerToys](https://github.com/microsoft/PowerToys).\n\n---\n\n## Status\n\nThis project is in early development.  See [Known Issues](#known-issues) for current limitations.\n\nContributions and bug reports are welcome. If you run into issues, please [open an issue](../../issues/new).\n\n---\n\n## Features\n\n- **Encrypted communication** — AES-256-CBC encryption on all packets with PBKDF2 key derivation (50,000 iterations)\n- **Full MWB protocol handshake** — 10-round challenge/response with noise exchange and identity verification\n- **Bi-directional input sharing** — Share your mouse and keyboard in both directions between macOS and Windows\n- **Edge crossing** — Move your cursor off the edge of one screen and it appears on the other, with configurable screen position and debounce\n- **Clipboard synchronization** — Sync text and images across machines via a dedicated encrypted TCP channel\n- **Automatic reconnection** — Recovers from network interruptions with automatic reconnect\n- **Menu bar app** — Lives in your system tray with a minimal footprint; no dock icon clutter\n- **macOS native** — Built entirely in SwiftUI and Swift with strict concurrency, zero external dependencies\n\n---\n\n## Project Structure\n\n```\nMWBClient/\n├── App/                    # Entry point, AppDelegate, Info.plist\n├── Coordinator/            # Central orchestrator (AppCoordinator)\n├── Network/                # TCP client, server listener, heartbeat\n├── Input/                  # Event capture, injection, edge detection, key mapping\n├── Clipboard/              # Clipboard sync with compression\n├── Protocol/               # MWB packet format, constants, handshake\n├── Crypto/                 # AES-256-CBC encryption\n├── Persistence/            # UserDefaults-backed settings\n├── UI/                     # Tray menu and settings window (5 pages)\n├── Utils/                  # Logger, screen info, helpers\n└── Resources/              # Asset catalog\nMWBClientTests/             # Unit tests\nInputTestHarness/           # Standalone input debugging app\n```\n\n---\n\n## Prerequisites\n\n- **macOS 14.0** (Sonoma) or later\n- **Xcode 16.0** or later\n- **Swift 6.0**\n- **[XcodeGen](https://github.com/yonaskolb/XcodeGen)** — for generating the Xcode project from `project.yml`\n\nInstall XcodeGen with Homebrew:\n\n```bash\nbrew install xcodegen\n```\n\n---\n\n## Building\n\n```bash\n# Generate the Xcode project (run after cloning or when project.yml changes)\nmake generate\n\n# Build\nmake build\n\n# Build and launch\nmake run\n```\n\nOr open `MWBClient.xcodeproj` in Xcode directly and hit Cmd+R.\n\n---\n\n## Usage\n\n### First Launch\n\n1. Launch MWBClient — it will appear as an icon in your menu bar.\n2. Click the menu bar icon and select **Settings**.\n3. Go to the **Connection** page and enter your Windows machine's IP address and the security key from PowerToys.\n4. Choose your screen position on the **Layout** page (this tells the app where your Windows machine sits relative to your Mac).\n5. Grant **Accessibility** permissions when prompted (required for input capture and injection). You can check the status on the **Permissions** settings page.\n\n### Connecting\n\n- Click the menu bar icon and select **Connect**, or enable **Auto-connect** in General settings to connect on launch.\n- Once connected, move your cursor to the configured screen edge to cross over to the Windows machine.\n- Move the cursor back to the Mac's screen edge to return.\n\n### Clipboard Sync\n\nEnable or disable text and image clipboard sync on the **Clipboard** settings page. Clipboard data is sent over its own encrypted TCP connection.\n\n---\n\n## Setting Up PowerToys (Windows Side)\n\n1. Install [Microsoft PowerToys](https://github.com/microsoft/PowerToys) on your Windows machine.\n2. Open PowerToys Settings and enable **Mouse Without Borders**.\n3. On the **Mouse Without Borders** page, note the **Security Key** — you will need this on the Mac side.\n\n---\n\n## Known Issues\n\n- **Display hotplug** -- Screen bounds are cached when input capture starts and do not refresh when displays are added, removed, or rearranged. Restart the app after changing display configuration.\n- **Drag \u0026 Drop** -- Experimental support for cross-border file dragging. This may not work flawlessly with all Windows configurations or high-integrity (Admin) applications.\n- **Mac Controlling Windows** -- Currently partially work - it does not travels back to mac, and not hiding the mac cursor properly\n- **Keyboard input** -- Currently doesn't work at all\n\n---\n\n## License\n\nThis project is provided as-is. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsomiona%2Fmwb-client-macos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsomiona%2Fmwb-client-macos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsomiona%2Fmwb-client-macos/lists"}