Getting Started

Quick start

brew install glide
glide launch

Note: If you don't have Homebrew, see the "manual installation" section below.

The first time you do this, you will have to follow instructions to enable Accessibility permissions.

Glide requires "Displays have separate Spaces" to be turned on to work properly with multiple monitors. This is the default on macOS. You can check it under System Settings → Desktop & Dock → Mission Control. If you change it, you must log out and back in for it to take effect.

Once Glide is running, press ⌥Z to start managing the current space. Note: This will resize all your windows! To stop managing the space, press ⌥Z again.

See glide.default.toml for a list of key bindings. You can customize these by creating a config file at ~/.config/glide/glide.toml (or ~/.glide.toml) and either restarting Glide or running the following:

glide config update

To apply changes as you save, add the --watch flag: glide config update --watch.

To exit Glide, type ⌥⇧E.

Option and Alt are synonyms for the same key.

Save and restore

If you need to update Glide or restart it for any reason, exit with the save_and_exit key binding (default ⌥⇧E). Then, when starting again, run it with the --restore flag:

glide launch --restore

Note that this does not work across machine restarts.

Running Glide at login

To install Glide as a service to run at login, use:

glide service install

Manual installation

Download the latest release from the releases page.

Open the disk image and install Glide by dragging it into Applications. I recommend installing the glide CLI; you can do this by running in a terminal:

sudo ln -s /Applications/Glide.app/Contents/MacOS/glide /usr/local/bin

Launch the app using the CLI or with Finder.

Building from source

First, install Rust and make sure you have the latest Xcode command line tools installed.

Then, run the following:

git clone https://github.com/glide-wm/glide
cd glide
cargo run --release

The first time you do this, you may have to follow instructions to enable Accessibility permissions. Instead of enabling them for Glide, enable them for whatever application your terminal is running in.