<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>README.md - fork/glide @ v0.1.1</title>
<meta name="description" content="README.md in fork/glide at v0.1.1.">
<meta property="og:title" content="README.md - fork/glide @ v0.1.1">
<meta property="og:description" content="README.md in fork/glide at v0.1.1.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="v0.1.1" data-tip="a23fc94635e2a63aa3f23de0628f0aba05689321">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/glide</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/glide</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Tyler Mandry</span><span class="commit-message" data-commit="3663ae688f7aad59ca28eec51fac94f396e74b1e">Revert &quot;Merge pull request #56 from glide-wm/server&quot;</span><span class="snapshot-sha sha" data-commit="3663ae688f7aad59ca28eec51fac94f396e74b1e">3663ae6</span><time datetime="2026-01-05T00:06:54-08:00" title="2026-01-05 00:06:54 -0800">2026-01-05</time></p>
<header class="topbar"><details class="switcher"><summary>v0.1.1</summary><div class="menu"><strong>branches</strong><a href="/fork/glide/ref/main/">main</a><strong>tags</strong><a href="/fork/glide/ref/v0.1.0/">v0.1.0</a><a class="current" href="/fork/glide/ref/v0.1.1/">v0.1.1</a><a class="all" href="/fork/glide/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/glide/">glide</a> / <span class="cur">README.md</span></nav>
<span class="view-stats"><span>2.1 KiB</span><span>69 lines</span></span><span class="actions"><a class="raw" href="/fork/glide/raw/47afc4575e0a2b189b69ecf939a8a9c63958ede2/README.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered">&lt;!-- GUIDE_EXCLUDE_START --&gt;
<p><a href="https://github.com/glide-wm/glide/actions"><img src="https://github.com/glide-wm/glide/actions/workflows/test.yml/badge.svg" alt="GHA Status" /></a></p>
<h1>Glide</h1>
<p>Glide is a tiling window manager for macOS. It takes inspiration from window
managers like i3, Sway, and Hyprland.</p>
&lt;!-- GUIDE_EXCLUDE_END --&gt;
<h2>Quick start</h2>
<p><a href="https://github.com/glide-wm/glide/releases/latest">Download the latest release</a> from the releases page.</p>
<p>Open the disk image and install Glide by dragging it into Applications, then
launch the app. The first time you do this, you will have to follow instructions
to enable Accessibility permissions.</p>
<p>Once Glide is running, press Alt+Z to start managing the current space. Note:
This will resize all your windows!</p>
<p>See <a href="/fork/glide/ref/v0.1.1/blob/glide.default.toml">glide.default.toml</a> for a list of key bindings. You can customize these by
editing <code>~/.glide.toml</code> and restarting Glide (hit Alt+Shift+E to exit, then
re-launch).</p>
<h2>Building from source</h2>
<p>First, <a href="https://rustup.rs">install Rust</a> and make sure you have the latest Xcode command line tools installed.</p>
<p>Then, run the following:</p>
<pre>git clone https://github.com/glide-wm/glide
cd glide
cargo run --release
</pre>
<p>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.</p>
<p>If you are interested in contributing, there are lots of tips in
<a href="/fork/glide/ref/v0.1.1/blob/CONTRIBUTING.md">CONTRIBUTING.md</a>.</p>
<h3>Save and restore</h3>
<p>If you need to update Glide or restart it for any reason, exit with the
<code>save_and_exit</code> key binding (default Alt+Shift+E). Then, when starting again,
run it with the <code>--restore</code> flag:</p>
<pre>cargo run --release -- --restore
</pre>
<p>Note that this does not work across machine restarts. Currently it only works
when running Glide from the command line.</p>
&lt;!-- GUIDE_EXCLUDE_START --&gt;
<h4>License and usage notes</h4>
<p>Licensed under either of <a href="/fork/glide/ref/v0.1.1/blob/LICENSE-APACHE">Apache License, Version 2.0</a> or
<a href="/fork/glide/ref/v0.1.1/blob/LICENSE-MIT">MIT license</a> at your option.</p>
&lt;!-- GUIDE_EXCLUDE_END --&gt;
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-c>&lt;!-- GUIDE_EXCLUDE_START --&gt;</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text">[![GHA Status]][GitHub Actions]</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text"><a-p>#</a-p> <a-tt>Glide</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text">Glide is a tiling window manager for macOS. It takes inspiration from window</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text">managers like i3, Sway, and Hyprland.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"><a-c>&lt;!-- GUIDE_EXCLUDE_END --&gt;</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"><a-p>##</a-p> <a-tt>Quick start</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text">[Download the latest release][latest] from the releases page.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text">Open the disk image and install Glide by dragging it into Applications, then</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text">launch the app. The first time you do this, you will have to follow instructions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text">to enable Accessibility permissions.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text">Once Glide is running, press Alt+Z to start managing the current space. Note:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text">This will resize all your windows!</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text">See [glide.default.toml] for a list of key bindings. You can customize these by</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text">editing `~/.glide.toml` and restarting Glide (hit Alt+Shift+E to exit, then</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text">re-launch).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-tu>[latest]</a-tu>: <a-tu>https://github.com/glide-wm/glide/releases/latest</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-tu>[glide.default.toml]</a-tu>: <a-tu>./glide.default.toml</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"><a-p>##</a-p> <a-tt>Building from source</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text">First, [install Rust](https://rustup.rs) and make sure you have the latest Xcode command line tools installed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text">Then, run the following:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>git clone https://github.com/glide-wm/glide</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"><a-p>cd glide</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>cargo run --release</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>The first time you do this, you may have to follow instructions to enable</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>Accessibility permissions. Instead of enabling them for Glide, enable them for</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"><a-p>whatever application your terminal is running in.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>If you are interested in contributing, there are lots of tips in</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>[CONTRIBUTING.md](./CONTRIBUTING.md).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>### </a-p><a-tt>Save and restore</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"><a-p>If you need to update Glide or restart it for any reason, exit with the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"><a-p>`save_and_exit` key binding (default Alt+Shift+E). Then, when starting again,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>run it with the `--restore` flag:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>cargo run --release -- --restore</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"><a-p>Note that this does not work across machine restarts. Currently it only works</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"><a-p>when running Glide from the command line.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-c>&lt;!-- GUIDE_EXCLUDE_START --&gt;</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"><a-p>#### </a-p><a-tt>License and usage notes</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"><a-p>Licensed under either of [Apache License, Version 2.0](LICENSE-APACHE) or</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"><a-p>[MIT license](LICENSE-MIT) at your option.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"><a-tu>[GitHub Actions]</a-tu><a-p>: </a-p><a-tu>https://github.com/glide-wm/glide/actions</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"><a-tu>[GHA Status]</a-tu><a-p>: </a-p><a-tu>https://github.com/glide-wm/glide/actions/workflows/test.yml/badge.svg</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"><a-c>&lt;!-- GUIDE_EXCLUDE_END --&gt;</a-c></span></span></pre></div></div>
</main>
</body>
</html>
