Amethyst: An Automatic Tiling Window Manager for macOS
This repository profile is provided by osrepos.com, an open source repository discovery platform.

Summary
Amethyst is an open-source tiling window manager for macOS, inspired by the popular xmonad. It automatically arranges application windows, significantly enhancing productivity by eliminating the need for manual resizing and positioning. This powerful tool offers various customizable layouts and keyboard shortcuts for efficient workspace management on your Mac.
Repository Information
Topics
Click on any tag to explore related repositories
Use at your own risk
OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.
Introduction
Amethyst is a highly-regarded, open-source tiling window manager designed specifically for macOS. Inspired by the functionality of xmonad on Linux, Amethyst brings a similar level of automated window organization and efficiency to Apple's desktop environment. Written in Swift, it aims to boost user productivity by intelligently arranging application windows, allowing users to focus on their tasks rather than window management. With over 16,000 stars on GitHub, Amethyst is a popular choice for those seeking a more streamlined and keyboard-driven workflow on macOS.
Installation
Getting Amethyst up and running on your macOS system is straightforward. Please note that Amethyst is supported on macOS 10.15 (Catalina) and newer.
You can install Amethyst using Homebrew Cask:
brew install --cask amethyst
Alternatively, you can download the latest release directly from the Amethyst releases page.
Usage and Configuration
After installation, Amethyst requires a few initial setup steps to function correctly. You must grant Amethyst permissions to use the accessibility APIs in your macOS Privacy & Security settings (Privacy -> Accessibility).
It is also highly recommended to disable "Automatically rearrange Spaces based on most recent use" in Mission Control settings, as this can interfere with Amethyst's predictable window placement. This can be done via System Preferences or by running the following command in your terminal:
defaults write com.apple.dock workspaces-auto-swoosh -bool NO
killall Dock
Amethyst operates through a system of customizable keyboard shortcuts and various window layouts. Key shortcuts allow you to cycle through layouts, move focus between windows, swap windows, and adjust pane sizes. For instance, mod1 + space cycles layouts forward, and mod1 + j/k moves focus between windows.
Amethyst offers a wide array of layouts to suit different workflows, including:
- Tall: A main pane on the left, with other windows stacked on the right.
- Wide: A main pane on the top, with other windows stacked on the bottom.
- Fullscreen: The focused window takes up the entire screen.
- Column: Each window occupies its own column, spanning the full height.
- Binary Space Partitioning (BSP): Recursively splits panes to fill available space.
- Floating: Allows manual movement and resizing, temporarily deactivating tiling.
You can customize keyboard shortcuts and layout preferences via Amethyst's configuration file (YAML) in your home directory, which overrides GUI settings.
Why Use Amethyst?
Amethyst transforms your macOS workspace into a highly efficient and organized environment. By automating window placement and resizing, it significantly reduces the time and effort spent on manual window management. This leads to a substantial boost in productivity, especially for users who prefer a keyboard-centric approach. Its diverse range of layouts caters to various tasks and screen configurations, providing flexibility while maintaining order. For developers, writers, or anyone who juggles multiple applications, Amethyst offers a clean, predictable, and powerful way to manage their digital space.
Links
- GitHub Repository: https://github.com/ianyh/Amethyst
- Releases Page: https://github.com/ianyh/Amethyst/releases
- Discussions: https://github.com/ianyh/Amethyst/discussions
Related repositories
Similar repositories that may be relevant next.

Deck: A Modern, Privacy-First Clipboard Manager for macOS
May 18, 2026
Deck is a modern, native, and privacy-first clipboard manager meticulously crafted for macOS. It offers an extensive array of features designed to boost productivity while prioritizing user data security. Deck provides intelligent tools like semantic search, automated workflows, and robust privacy protections, ensuring your copied content is both accessible and secure on your Mac.

Boring Notch: Transform Your MacBook's Notch into a Dynamic Control Center
March 24, 2026
Boring Notch is an innovative macOS application that reimagines your MacBook's notch, turning it into a dynamic and interactive control hub. It offers features like a music control center with a visualizer, calendar integration, a file shelf with AirDrop support, and a complete macOS HUD replacement. This project aims to make the often-overlooked notch a central and functional part of your desktop experience.
Ice: Powerful Menu Bar Manager for macOS
February 16, 2026
Ice is a robust menu bar management tool designed for macOS, offering extensive features for hiding, showing, and organizing menu bar items. It also provides options for customizing the menu bar's appearance, making it a versatile utility. This tool aims to optimize and personalize the macOS menu bar experience for users.

yabai: A Tiling Window Manager for macOS
December 28, 2025
yabai is a powerful tiling window manager designed specifically for macOS. It extends the operating system's built-in window manager, offering advanced control over windows, spaces, and displays via a command-line interface. Utilizing a binary space partitioning algorithm, yabai automatically arranges windows to maximize screen real estate and minimize distractions, fostering a more focused work environment.
Source repository
Open the original repository on GitHub.
9 counted GitHub visits