One keyboard and mouse for a Mac and a Windows PC over the local network, in either direction.
"""The Mac app's Config and the parser for config.json's shape.
settings_store reads settings.json (WIRE.md section 1) into that shape, so what is above it is unchanged."""
import json
import os
from dataclasses import dataclass, field
from core import effects, settings_sync
from crossing import DEFAULT_CROSSING
DEFAULT_CONFIG_PATH = os.path.join(os.path.dirname(os.path.abspath(__file__)), "config.json")
DEFAULT_KEY_MAP = {
"alt": "alt",
"alt_r": "alt",
"ctrl": "cmd",
"ctrl_r": "cmd",
"cmd": "ctrl",
"cmd_r": "ctrl",
}
# The positional map Beamer used to ship as the default, written verbatim
# into every existing config.json. A saved key_map beats the default, so
# without this an upgraded install would silently keep sending Cmd as the
# Windows key.
# A saved map whose every entry matches this one is the old default rather
# than a deliberate choice, so it is discarded.
LEGACY_POSITIONAL_KEY_MAP = {
"alt": "alt",
"alt_r": "alt",
"ctrl": "ctrl",
"ctrl_r": "ctrl",
"cmd": "cmd",
"cmd_r": "cmd",
}
# The two modifier styles the settings window offers. A saved key_map may be one of these
# names instead of a JSON object; Positional has to be saved by name, because its object form is
# the old default and is discarded on load (see LEGACY_POSITIONAL_KEY_MAP).
# The settings window's palette: follow the Mac, or keep one. tokens.APPEARANCES is the home of these
# values; this copy keeps config importable without the repo root, and test_shared_copies holds the
# two together.
APPEARANCES = ("system", "light", "dark")
KEY_MAP_STYLES = {
"semantic": DEFAULT_KEY_MAP,
"positional": LEGACY_POSITIONAL_KEY_MAP,
}
class ConfigError(Exception):
pass
@dataclass
class Config:
host: str
port: int
auth_token: str
trigger_key: str = "alt_r"
double_tap_ms: int = 300
key_map: dict = field(default_factory=lambda: dict(DEFAULT_KEY_MAP))
reconnect_interval_s: float = 2.0
trigger_style: str = "double_tap"
crossing: dict = field(default_factory=lambda: dict(DEFAULT_CROSSING))
# Learned, never typed: the PC's name from its pairing beacon and its hardware address from
# the ARP table, which is what wake-on-LAN needs.
pc_name: str = ""
mac_address: str = ""
# One switch per direction, each in the menu bar: this Mac's input going to Windows, and
# the PC's input arriving here. Off stops that direction only; the other keeps working.
send_to_windows: bool = True
allow_windows_to_drive: bool = True
# Ask GitHub once a day whether a newer release is out; see updates.py.
check_updates: bool = True
# Every address the window shows is hidden; see pages.redact.
hide_addresses: bool = False
language: str = "auto"
# Only the machine in use shows a pointer: this Mac's after a driver lets go of it, until it
# moves (core/idle_pointer). Its pointer always hides while it drives. This Mac's own choice.
hide_idle_pointer: bool = True
# Same on all machines: the Crossing and Design pages kept in step with the PC's, and the unix
# seconds of the last change to that or to a shared value; see settings_sync.
same_on_both: bool = False
same_set_at: int = 0
same_groups: list = field(default_factory=list)
# Who made the change the stamp above is for, as a machine id: the tie-break between two ends
# that changed it in the same second (WIRE.md section 10).
same_by: str = ""
# Each shared value's own (set_at, by) as `{key: [set_at, by]}`, so an edit carries only what a
# person changed (settings_sync.held_stamps; rc14, 10-10-2026).
same_stamps: dict = field(default_factory=dict)
design_set_at: int = 0
design_by: str = ""
design_follow_peer: str = ""
# How the PC's pointer and scroll feel on this Mac; see receiver.InputScale.
pointer_speed: float = 1.0
scroll_speed: float = 1.0
reverse_scroll: bool = False
appearance: str = "system"
# Keys and buttons that stay on this Mac while its input is on Windows; see ignored.py.
ignored_inputs: list = field(default_factory=list)
mouse_only: bool = False
def _stamp(value) -> int:
"""A saved unix-seconds stamp, or 0 for anything that is not one."""
return int(value) if not isinstance(value, bool) and isinstance(value, (int, float)) and value > 0 else 0
def _same_stamps(value) -> dict:
"""The saved per-value stamps, keeping only well-formed pairs for keys that are shared."""
if not isinstance(value, dict):
return {}
pairs = {key: settings_sync._stamp_pair(value.get(key), now=settings_sync.MAX_STAMP)
for key in settings_sync.STAMPED_KEYS}
return settings_sync.stored_stamps({key: pair for key, pair in pairs.items() if pair is not None})
def key_map_style(key_map):
"""The name of a key_map when it is one of the two offered styles, else None."""
for name, mapping in KEY_MAP_STYLES.items():
if key_map == mapping:
return name
return None
def load_config(path: str = None) -> Config:
path = path or DEFAULT_CONFIG_PATH
if not os.path.exists(path):
raise ConfigError(
f"config file not found: {path}\n"
f"Copy config.example.json to config.json and fill in your own values."
)
with open(path, "r", encoding="utf-8") as f:
raw = json.load(f)
return parse_config(raw)
def parse_config(raw: dict) -> Config:
"""A Config from a dict in config.json's shape, the one settings_store hands over from settings.json."""
groups = raw.get("same_groups", ["crossing", "design", "shortcut", "names"]
if raw.get("same_on_both", False) else [])
if not isinstance(groups, list) or any(group not in ("crossing", "design", "shortcut", "names") for group in groups):
raise ConfigError("same_groups must contain known group names")
missing = [k for k in ("host", "port", "auth_token") if k not in raw]
if missing:
raise ConfigError(f"config.json is missing required field(s): {', '.join(missing)}")
# Empty means not yet paired, which every setting must still be able to save
# around; only the example file's placeholder is refused.
if raw["auth_token"] == "CHANGE_ME":
raise ConfigError("config.json auth_token is still the placeholder — pair with a PC or pick a real shared secret")
key_map = dict(DEFAULT_KEY_MAP)
saved_key_map = raw.get("key_map", {})
if isinstance(saved_key_map, str):
if saved_key_map not in KEY_MAP_STYLES:
raise ConfigError(f"config.json key_map style must be one of: {', '.join(KEY_MAP_STYLES)}")
key_map = dict(KEY_MAP_STYLES[saved_key_map])
elif not isinstance(saved_key_map, dict):
raise ConfigError("config.json key_map must be a JSON object or a style name")
elif saved_key_map != LEGACY_POSITIONAL_KEY_MAP:
# Only the whole old default is the accident. A partial map whose
# entries happen to agree with it -- {"cmd": "cmd"} on its own -- is a
# choice, and was being thrown away.
key_map.update(saved_key_map)
crossing = dict(DEFAULT_CROSSING)
saved_crossing = raw.get("crossing", {})
if not isinstance(saved_crossing, dict):
raise ConfigError("config.json crossing must be a JSON object")
crossing.update(saved_crossing)
if crossing.get("shortcut_goes_to") not in ("last", "next", "ticked"):
crossing["shortcut_goes_to"] = "last"
(crossing["effect_pace"], crossing["effect_size_fraction"],
crossing["effect_length"], crossing["effect_size"]) = effects.design_values(
saved_crossing.get("effect_pace"), saved_crossing.get("effect_size_fraction"),
saved_crossing.get("effect_length"), saved_crossing.get("effect_size"))
# Normalising would quietly replace a preset that is not one; the store's validation refuses it.
for name, presets in (("effect_length", effects.LENGTHS), ("effect_size", effects.SIZES)):
if name in saved_crossing and saved_crossing[name] not in {value for value, _label in presets}:
crossing[name] = saved_crossing[name]
crossing["glow_style"], crossing["glow_colour"], crossing["shortcut_arrival_style"] = effects.offered(
crossing["glow_style"], crossing["glow_colour"], crossing["shortcut_arrival_style"])
crossing["methods"] = list(crossing["methods"])
if isinstance(crossing["edge_parts"], list):
crossing["edge_parts"] = list(crossing["edge_parts"])
crossing["resistance_px"] = int(crossing["resistance_px"])
crossing["arrangement_set_at"] = _stamp(crossing["arrangement_set_at"])
return Config(
host=raw["host"],
port=int(raw["port"]),
auth_token=raw["auth_token"],
trigger_key=raw.get("trigger_key", "alt_r"),
double_tap_ms=int(raw.get("double_tap_ms", 300)),
key_map=key_map,
reconnect_interval_s=float(raw.get("reconnect_interval_s", 2.0)),
trigger_style=str(raw.get("trigger_style", "double_tap")),
crossing=crossing,
pc_name=str(raw.get("pc_name", "") or ""),
mac_address=str(raw.get("mac_address", "") or ""),
send_to_windows=raw.get("send_to_windows", True) is not False,
allow_windows_to_drive=raw.get("allow_windows_to_drive", True) is not False,
check_updates=raw.get("check_updates", True) is not False,
hide_addresses=raw.get("hide_addresses", False) is True,
hide_idle_pointer=raw.get("hide_idle_pointer", True) is not False,
same_on_both=raw.get("same_on_both", False) is True,
same_set_at=_stamp(raw.get("same_set_at", 0)),
same_groups=groups,
same_by=str(raw.get("same_by", "") or ""),
same_stamps=_same_stamps(raw.get("same_stamps")),
design_set_at=_stamp(raw.get("design_set_at", 0)),
design_by=str(raw.get("design_by", "") or ""),
design_follow_peer=str(raw.get("design_follow_peer", "") or ""),
pointer_speed=raw.get("pointer_speed", 1.0),
scroll_speed=raw.get("scroll_speed", 1.0),
reverse_scroll=raw.get("reverse_scroll", False),
appearance=raw.get("appearance") if raw.get("appearance") in APPEARANCES else "system",
language=raw.get("language") if raw.get("language") in ("auto", "en", "it") else "auto",
ignored_inputs=raw.get("ignored_inputs", []),
mouse_only=raw.get("mouse_only", False),
)