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

When you exit Glide with the save_and_exit key binding (default ⌥⇧E) or the Quit menu item, it saves your layout and which spaces are enabled. The next time Glide starts in the same login session, it restores them. To start with a fresh layout instead, run:

glide launch --no-restore

To start fresh by default, set auto_restore = false under [settings] in your config. glide launch --restore then restores for that launch.

Saved state is not restored after logging out or restarting your machine.

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.