← back

fork/glide

git clone https://git.julia.blue/fork/glide

Tyler MandryBREAKING CHANGE: group_indicators config was renamed to group_bars577e3ec

main
5 folders16 files
languages

files

.github/workflows/
assets/
examples/
site/
src/
.gitignore66 B
.licensesnip71 B
.licensesnipignore19 B
.release-please-manifest.json14 B
CHANGELOG.md973 B
CONTRIBUTING.md8.8 KiB
COPYRIGHT626 B
Cargo.lock62.3 KiB
Cargo.toml4.5 KiB
LICENSE-APACHE10.6 KiB
LICENSE-MIT1023 B
README.md2.4 KiB
build.rs205 B
glide.default.toml3.4 KiB
release-please-config.json320 B
rustfmt.toml160 B
<!-- GUIDE_EXCLUDE_START -->

GHA Status

Glide

Glide is a tiling window manager for macOS. It takes inspiration from window managers like i3, Sway, and Hyprland.

<!-- GUIDE_EXCLUDE_END -->

Quick start

Download the latest release from the releases page.

Open the disk image and install Glide by dragging it into Applications. We 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. The first time you do this, you will have to follow instructions to enable Accessibility permissions.

Once Glide is running, press Alt+Z 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 editing ~/.glide.toml and either restarting Glide or running the following:

glide config update

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

To exit Glide, type Alt+Shift+E.

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.

If you are interested in contributing, there are lots of tips in CONTRIBUTING.md.

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). Then, when starting again, run it with the --restore flag:

cargo run --release -- --restore

Note that this does not work across machine restarts. Currently it only works when running Glide from the command line.

<!-- GUIDE_EXCLUDE_START -->

License and usage notes

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

<!-- GUIDE_EXCLUDE_END -->