Platform notes

bmux uses Electron and is intended to run across desktop platforms. Development starts with the same commands:

pnpm install
pnpm dev

macOS #

Building the native pointer integration requires Xcode Command Line Tools. Application state defaults to ~/Library/Application Support/bmux.

The pnpm package script produces a sealed .app bundle and uses the configured Developer ID identity when available. Published macOS releases are Developer ID signed and notarized, with automatic updates. Local GUI tests use a Tart virtual machine. See Packaging and the Tart test setup.

Default direct shortcuts use Command. Find in page uses Command+F. Change shortcuts in keyboard configuration.

Linux and Windows #

Run bmux from source with pnpm dev. GitHub releases provide Linux x64 and arm64 portable host archives and a Windows x64 desktop installer. Find in page uses Control+F; other direct shortcuts can be changed in keyboard configuration.