Skip to main content

​
Downloads

​
Release Builds

Download pre-built binaries from the releases page:
  • macOS: Signed and notarized DMG (separate builds for Intel/Apple Silicon)
  • Linux: AppImage
  • Windows (alpha): Installer exe

​
Development Builds

Download pre-built binaries of main from GitHub Actions:
  • macOS: Signed and notarized DMG
    • macos-dmg-x64 (Intel Macs)
    • macos-dmg-arm64 (Apple Silicon)
  • Linux: AppImage (portable, works on most distros)
Windows builds are only available from releases, not from development builds.
To download:
  1. Go to the Build workflow
  2. Click on the latest successful run
  3. Scroll down to “Artifacts” section
  4. Download the appropriate artifact for your platform

​
Installation

macOS:
  1. Download the DMG file for your Mac:
    • Intel Mac: macos-dmg-x64
    • Apple Silicon: macos-dmg-arm64
  2. Open the DMG file
  3. Drag Mux to Applications folder
  4. Open the app normally
The app is code-signed and notarized by Apple, so it will open without security warnings. Linux:
  1. Download the AppImage file
  2. Make it executable: chmod +x Mux-*.AppImage
  3. Run it: ./Mux-*.AppImage
Windows (alpha):
  1. Download the installer exe from releases (e.g., mux-x.x.x-x64.exe)
  2. Run the installer
  3. Follow the installation prompts
  4. Launch Mux from the Start menu or desktop shortcut
Windows support is currently in alpha. Please report any issues you encounter.

​
Testing Pre-Release Builds

Only builds from the main branch are signed and notarized. If you’re testing a build from a pull request or other branch, you’ll need to bypass macOS Gatekeeper:
  1. After installing, open Terminal
  2. Run: xattr -cr /Applications/Mux.app
  3. Run: codesign --force --deep --sign - /Applications/Mux.app
  4. Now you can open the app normally