Skip to content

One keyboard and mouse for a Mac and a Windows PC over the local network, in either direction.

README: Apple silicon only, non-US layouts, relaunch after granting, manual pairing

Toby Kalkman909a10c50412
diff --git a/README.md b/README.md
index e26dd84..6d48b4f 100644
--- a/README.md
+++ b/README.md
@@ -20,20 +20,24 @@ Free, with no account. Every installer is on the [releases page](https://github.
| Platform | Get it | Notes |
|---|---|---|
-| macOS 13 or later | `Beamer-<version>.dmg` | Signed and notarised by Apple |
+| macOS 13 or later, Apple silicon | `Beamer-<version>.dmg` | Signed and notarised by Apple. Not for Intel Macs yet |
| Windows 10 and 11 | `Beamer-Setup-<version>.exe` | Not code-signed; see step 1 below |
| Windows, through winget | `winget install KalkmanCode.Beamer` | The same installer, without the warning |
## Quick start
1. **Install on both machines.** On the Mac, drag Beamer to Applications, open it, and press the
- two Grant buttons on the Permissions page (Accessibility, then Input Monitoring). On Windows,
+ two Grant buttons on the Permissions page (Accessibility, then Input Monitoring). Then quit
+ Beamer from its menu bar icon and open it again: macOS only passes keys to an app started after
+ the grant, so until then the pointer crosses but the keyboard does not. On Windows,
run the installer. It is not code-signed, because a certificate costs money and Beamer is free,
so Windows says "Windows protected your PC" the first time: choose More info, then Run anyway.
winget does not show that warning. Beamer on Windows runs as administrator, so expect one UAC
prompt when you open it.
2. **Pair them.** On the PC, press Pair a Mac; a six-digit code appears. On the Mac, open the
Pairing page, choose the PC from the list and type the code. It lasts a minute and works once.
+ If the PC never appears in the list, as on guest Wi-Fi or across a VPN, type the PC's address
+ on the Mac's Connection page and the same token on both machines' Connection pages instead.
3. **Cross.** Push the Mac's pointer off the right-hand edge of its screen, or double-tap Right
Option, and the Mac's keyboard and trackpad are on the PC. Push back through the PC's left edge,
or double-tap again, to come home. The PC's own keyboard and mouse go the other way: push
@@ -108,6 +112,10 @@ step, so the border is always the same one seen from both ends.
keyboard there.
- **Files do not cross**, only text and images, up to 256KB of text and an 8MB image.
- **AltGr is out of reach from the Mac.**
+- **Layouts that move letters, such as AZERTY and QWERTZ, are not handled yet.** Shortcuts sent
+ from the Mac, and letters typed from the PC onto the Mac, follow US key positions, and a dead key
+ typed on the PC does not cross. US and UK layouts are unaffected.
+- **Intel Macs are not supported yet.** The Mac app is built for Apple silicon only.
- **The Windows installer is unsigned.** SmartScreen warns until it has a download history; winget
avoids it.
- **macOS 27 beta 4 could block a signed app's local-network access** even when Terminal could
diff --git a/mac_app/Beamer.command b/mac_app/Beamer.command
deleted file mode 100755
index ebdfaaf..0000000
--- a/mac_app/Beamer.command
+++ /dev/null
@@ -1,6 +0,0 @@
-#!/bin/bash
-# Double-click launcher for Beamer (see build_notes.md: "Known issue: py2app
-# packaging blocks LAN access" for why this runs as a script instead of the
-# packaged .app).
-cd "$(dirname "$0")"
-exec .venv/bin/python3 kvm_bridge_app.py
diff --git a/mac_app/tests/test_shared_copies.py b/mac_app/tests/test_shared_copies.py
index d8f4e73..6fb648c 100644
--- a/mac_app/tests/test_shared_copies.py
+++ b/mac_app/tests/test_shared_copies.py
@@ -1,6 +1,6 @@
"""The files both apps share are kept byte-identical, not merely similar.
-`ignored.py`, `protocol.py`, `receiver.py`, `return_edge.py` and `wol.py` each exist once in mac_app
+`ignored.py`, `pairing.py`, `protocol.py`, `receiver.py`, `return_edge.py` and `wol.py` each exist once in mac_app
and once in win_app because neither app can import across the other's
directory -- both are packaged as self-contained bundles. Everything
platform-shaped in them is injected at construction instead, so there is no
@@ -19,7 +19,7 @@ import unittest
_TESTS_DIR = os.path.dirname(os.path.abspath(__file__))
_REPO_ROOT = os.path.dirname(os.path.dirname(_TESTS_DIR))
-SHARED_MODULES = ("ignored.py", "protocol.py", "receiver.py", "return_edge.py", "wol.py")
+SHARED_MODULES = ("ignored.py", "pairing.py", "protocol.py", "receiver.py", "return_edge.py", "wol.py")
SHARED_TESTS = ("test_ignored.py", "test_shared_copies.py")
@@ -30,8 +30,8 @@ def _digest(path):
class SharedCopyTests(unittest.TestCase):
def _assert_identical(self, mac_path, win_path, name):
- if not os.path.isfile(mac_path) or not os.path.isfile(win_path):
- self.skipTest(f"{name} is missing from one side; nothing to compare")
+ for path in (mac_path, win_path):
+ self.assertTrue(os.path.isfile(path), f"{name} is missing from {os.path.dirname(path)}")
self.assertEqual(
_digest(mac_path),
_digest(win_path),
diff --git a/requirements-mac.txt b/requirements-mac.txt
deleted file mode 100644
index 122ab4e..0000000
--- a/requirements-mac.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-pynput>=1.7.6
-rumps>=0.4.0
diff --git a/requirements-win.txt b/requirements-win.txt
deleted file mode 100644
index 9c18849..0000000
--- a/requirements-win.txt
+++ /dev/null
@@ -1,3 +0,0 @@
-# win_receiver.py only uses the Python standard library (socket, ctypes) —
-# no third-party packages required. This file is kept for symmetry with
-# requirements-mac.txt and as a place to add deps later if needed.
diff --git a/win_app/Beamer.png b/win_app/Beamer.png
deleted file mode 100644
index 6907690..0000000
Binary files a/win_app/Beamer.png and /dev/null differ
diff --git a/win_app/tests/test_shared_copies.py b/win_app/tests/test_shared_copies.py
index d8f4e73..6fb648c 100644
--- a/win_app/tests/test_shared_copies.py
+++ b/win_app/tests/test_shared_copies.py
@@ -1,6 +1,6 @@
"""The files both apps share are kept byte-identical, not merely similar.
-`ignored.py`, `protocol.py`, `receiver.py`, `return_edge.py` and `wol.py` each exist once in mac_app
+`ignored.py`, `pairing.py`, `protocol.py`, `receiver.py`, `return_edge.py` and `wol.py` each exist once in mac_app
and once in win_app because neither app can import across the other's
directory -- both are packaged as self-contained bundles. Everything
platform-shaped in them is injected at construction instead, so there is no
@@ -19,7 +19,7 @@ import unittest
_TESTS_DIR = os.path.dirname(os.path.abspath(__file__))
_REPO_ROOT = os.path.dirname(os.path.dirname(_TESTS_DIR))
-SHARED_MODULES = ("ignored.py", "protocol.py", "receiver.py", "return_edge.py", "wol.py")
+SHARED_MODULES = ("ignored.py", "pairing.py", "protocol.py", "receiver.py", "return_edge.py", "wol.py")
SHARED_TESTS = ("test_ignored.py", "test_shared_copies.py")
@@ -30,8 +30,8 @@ def _digest(path):
class SharedCopyTests(unittest.TestCase):
def _assert_identical(self, mac_path, win_path, name):
- if not os.path.isfile(mac_path) or not os.path.isfile(win_path):
- self.skipTest(f"{name} is missing from one side; nothing to compare")
+ for path in (mac_path, win_path):
+ self.assertTrue(os.path.isfile(path), f"{name} is missing from {os.path.dirname(path)}")
self.assertEqual(
_digest(mac_path),
_digest(win_path),