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.

Once Glide is running, press Alt+Z (Option+Z on Mac keyboards) to start managing the current space. Note: This will resize all your windows! To stop managing the space, press Alt+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 exit Glide, type Alt+Shift+E (Option+Shift+E on Mac keyboards).

Save and restore

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

glide launch --restore

Note that this does not work across machine restarts.

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.