WinMux

https://github.com/zimengxiong/winmux
Admin
WinMux is a sidebar-first window manager for macOS featuring workspace projects, interactive tab...
Tokens:3,753
Snippets:34
Trust Score:9.9
License:MIT
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install WinMux via Homebrew

Source: https://github.com/zimengxiong/winmux/blob/main/README.md

Commands to tap the repository, trust the tap, install the WinMux cask, and clear the extended attributes for the application.

```shell
brew tap ZimengXiong/homebrew https://github.com/ZimengXiong/homebrew
brew trust ZimengXiong/homebrew
brew install --cask winmux
xattr -cr /Applications/WinMux.app
```

--------------------------------

### Create a signed release

Source: https://github.com/zimengxiong/winmux/blob/main/README.md

Command to generate a signed appcast.xml and upload it to a GitHub release, requiring the private key in the local login Keychain.

```makefile
make release VERSION=<version>
```

--------------------------------

### Configure Borderless Tiling

Source: https://github.com/zimengxiong/winmux/blob/main/README.md

Sets all inner and outer gaps to zero for a borderless tiling layout.

```toml
[gaps]
    inner.horizontal = 0
    inner.vertical = 0
    outer.left = 0
    outer.bottom = 0
    outer.top = 0
    outer.right = 0
```

--------------------------------

### Configure WinMux Keybindings in TOML

Source: https://github.com/zimengxiong/winmux/blob/main/README.md

Defines application launch shortcuts and disables native system shortcuts using the WinMux configuration file.

```toml
[mode.main.binding-tap]
    left-alt = 'exec-and-forget /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --profile-directory="Default"'
    right-cmd = 'exec-and-forget /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --profile-directory="Profile 1"'

[mode.main.binding]
    # Disable the native "Hide App" shortcut.
    cmd-h = []

    cmd-d = 'exec-and-forget osascript ~/Documents/scripts/launchTerminalWindow.scpt'
    cmd-e = 'exec-and-forget osascript ~/Documents/scripts/launchFinderWindow.scpt'
```

--------------------------------

### Configure Sidebar Expansion

Source: https://github.com/zimengxiong/winmux/blob/main/README.md

Forces the sidebar to remain fully expanded and sets its width in pixels.

```toml
[workspace-sidebar]
    always-expanded = true
    width = 240
```

--------------------------------

### AppleScript Application Launch Scripts

Source: https://github.com/zimengxiong/winmux/blob/main/README.md

Scripts for launching or focusing Terminal and Finder windows, intended to be triggered by WinMux keybindings.

```applescript
# ~/Documents/scripts/launchTerminalWindow.scpt
tell application "cmux"
    if it is running
        tell application "System Events" to tell process "cmux"
            click menu item "New Window" of menu "File" of menu bar 1
        end tell
    else
        activate
    end if
end tell

# ~/Documents/scripts/launchFinderWindow.scpt
tell application "Finder"
    if it is running
        tell application "System Events" to tell process "Finder"
            click menu item "New Finder Window" of menu "File" of menu bar 1
        end tell
    else
        activate
    end if
end tell
```

--------------------------------

### Configure Sidebar Auto-hide and Style

Source: https://github.com/zimengxiong/winmux/blob/main/README.md

Enables auto-hide for the sidebar and sets the chrome style to a solid color.

```toml
[workspace-sidebar]
    auto-hide = true
    chrome-style = 'solid'
    solid-chrome-color = 'lavender' # Choose any color shown in Appearance, including custom.
```

--------------------------------

### Configure Sidebar Clock

Source: https://github.com/zimengxiong/winmux/blob/main/README.md

Controls the visibility of the clock, seconds, date, and weekday labels in the sidebar.

```toml
[workspace-sidebar]
    show-clock = true
    show-seconds = true
    show-date = true
    show-weekday = true
```

--------------------------------

### Disable Automatic Tiling

Source: https://github.com/zimengxiong/winmux/blob/main/README.md

Prevents new windows from being tiled automatically upon discovery.

```toml
automatically-tile-new-windows = false
```

--------------------------------

### Disable Shake-to-Toggle Tiling

Source: https://github.com/zimengxiong/winmux/blob/main/README.md

Disables the gesture that toggles between floating and tiling modes when shaking a window by its title bar.

```toml
enable-shake-to-toggle-tiling = false
```
Tokens:
Raw