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.mdindex 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 start1. **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 UACprompt when you open it.2. **Pair them.** On the PC, press Pair a Mac; a six-digit code appears. On the Mac, open thePairing 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 RightOption, 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; wingetavoids it.- **macOS 27 beta 4 could block a signed app's local-network access** even when Terminal coulddiff --git a/mac_app/Beamer.command b/mac_app/Beamer.commanddeleted file mode 100755index 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.pydiff --git a/mac_app/tests/test_shared_copies.py b/mac_app/tests/test_shared_copies.pyindex 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_appand once in win_app because neither app can import across the other'sdirectory -- both are packaged as self-contained bundles. Everythingplatform-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.txtdeleted file mode 100644index 122ab4e..0000000--- a/requirements-mac.txt+++ /dev/null@@ -1,2 +0,0 @@-pynput>=1.7.6-rumps>=0.4.0diff --git a/requirements-win.txt b/requirements-win.txtdeleted file mode 100644index 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.pngdeleted file mode 100644index 6907690..0000000Binary files a/win_app/Beamer.png and /dev/null differdiff --git a/win_app/tests/test_shared_copies.py b/win_app/tests/test_shared_copies.pyindex 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_appand once in win_app because neither app can import across the other'sdirectory -- both are packaged as self-contained bundles. Everythingplatform-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),