+2
Daily
16,332
stars
542
forks
102
watchers
613
prs
1,181
issues
109
releases
README
Amethyst Tiling window manager for macOS along the lines of xmonad. !Windows If you want to learn more about tiling window managers and the features of Amethyst there are some great community resources on YouTube. Boost your MacOS PRODUCTIVITY with Amethyst | Tiling Window Manager Getting Amethyst Amethyst is available for direct download on the releases page or using homebrew cask. brew install --cask amethyst Note: that Amethyst now is only supported on macOS 10.15+. Using Amethyst Amethyst must be given permissions to use the accessibility APIs in the Privacy & Security tab, Privacy - Accessibilty. _Important note_: You will probably want to disable Automatically rearrange Spaces based on most recent use (found under Mission Control in System Preferences). This setting is enabled by default, and will cause your Spaces to swap places based on use. This makes keyboard navigation between Spaces unpredictable. or run in a terminal: bash defaults write com.apple.dock workspaces-auto-swoosh -bool NO killall Dock Troubleshooting See Troubleshooting for some common issues. Configuration Keyboard Shortcuts Amethyst uses two modifier combinations (mod1 and mod2) and can optionally use another two (mod3 and mod4). | Default Shortcut | Description | |---|---| | mod1 | option + shift | | mod2 | ctrl + option + shift | | mod3 | not defined by default | | mod4 | not defined by default | And defines the following commands, mostly a mapping to xmonad key combinations. | Default Shortcut | Description | |---|---| | mod1 + space | Cycle layout forward | | mod2 + space | Cycle layout backwards | | mod1 + h | Shrink the main pane | | mod1 + l | Expand the main pane | | mod1 + , | Increase main pane count | | mod1 + . | Decrease main pane count | | mod1 + j | Move focus counter clockwise | | mod1 + k | Move focus clockwise | | mod1 + p | Move focus to counter clockwise screen | | mod1 + n | Move focus to clockwise screen | | mod2 + h | Swap focused window to counter clockwise screen | | mod2 + l | Swap focused window to clockwise screen | | mod2 + j | Swap focused window counter clockwise | | mod2 + k | Swap focused window clockwise | | mod1 + enter | Swap focused window with main window | | mod1 + z | Force windows to be reevaluated | | mod2 + z | Relaunch Amethyst | | mod2 + left | Throw focused window to space left | | mod2 + right | Throw focused window to space right | | mod2 + 1 | Throw focused window to space 1 | | mod2 + 2 | Throw focused window to space 2 | | mod2 + 3 | Throw focused window to space 3 | | mod2 + 4 | Throw focused window to space 4 | | mod2 + 5 | Throw focused window to space 5 | | mod2 + 6 | Throw focused window to space 6 | | mod2 + 7 | Throw focused window to space 7 | | mod2 + 8 | Throw focused window to space 8 | | mod2 + 9 | Throw focused window to space 9 | | mod2 + 0 | Throw focused window to space 10 | | none | Throw focused window to space 11 | | none | Throw focused window to sp
Top issues
#1763Almost all keybindings stopped working28 comments · 2025-04-06#392Amethyst suddenly stops working20 comments · 2016-01-26#1496Amethyst is extremely slow21 comments · 2023-05-06#643Support mouse-follows-focus for window focuses not performed by Amethyst19 comments · 2017-08-22#1022Unable to tile Android Emulator16 comments · 2020-05-21#1283Add method to export current GUI config to `.amethyst.yml`15 comments · 2022-07-14#1509Float little arc windows?13 comments · 2023-06-04#1417"Automatically float all applications except those listed" breaks the functionality 13 comments · 2023-02-10
Discussions
#1912Amethyst 0.25.00 comments · 2026-11-06#1909Amethyst 0.25.0 Beta0 comments · 2026-11-01#1895Thank you, and a note on a personal fork (hw-Amethyst)0 comments · 2026-10-10#1893Annoyed by behavior when moving a window to a different workspace.0 comments · 2026-10-03#1869The state of state in layouts1 comments · 2026-06-25#1867ccline — ask your zsh prompt how to script macOS window management in plain English0 comments · 2026-06-10#1861problem with focus on different monitors0 comments · 2026-04-29#1854It would be great if the menu bar icon showed the current layout and screen1 comments · 2026-04-09
Latest release
Amethyst 0.25.0 v0.25.0 2026-11-06What's New Add option to start with tiling disabled. Thanks, @TheSynt4x! Add command for toggling sending windows to the main pane. Thanks, @rgeraskin! Fix an issue preventing interaction with Floating preferences. Thanks, @EhsanAzish80! Fix incorrect pointer conversion, which is a likely source of a variety of multi-display bugs. Thanks, @Possum! Fix a variety of other bugs, especially around proper reflows at the proper times. Thanks @mmv08, @farheinheigt, @pedrusck, and @djp3! What's Changed Amethyst 0.24.3 by @ianyh in https://github.com/ianyh/Amethyst/pull/1852 Upgrade S