https://github.com/tarkah/grout

Simple tiling window manager for Windows
https://github.com/tarkah/grout

rust window-manager windows

Last synced: 20 days ago
JSON representation

Simple tiling window manager for Windows

• Host: GitHub
• URL: https://github.com/tarkah/grout
• Owner: tarkah
• License: mit
• Created: 2020-05-06T18:19:25.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-02-10T00:13:22.000Z (over 3 years ago)
• Last Synced: 2024-08-21T21:27:14.047Z (2 months ago)
• Topics: rust, window-manager, windows
• Language: Rust
• Size: 82 KB
• Stars: 205
• Watchers: 4
• Forks: 8
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# grout

![Rust](https://github.com/tarkah/grout/workflows/Rust/badge.svg)

A simple tiling window manager for Windows, written in Rust. Inspired by Budgie's Window Shuffler grid functionality.

- [Demo](#demo)

- [Download](#download)

- [Usage](#usage)

- [Config](#config)

## Demo

Click for full video

[![Demo](https://i.imgur.com/bErviBc.gif)](https://i.imgur.com/ugPMvlA.mp4)

## Download

- Download executable from [latest release](https://github.com/tarkah/grout/releases/latest)

## Usage

- Run `grout.exe` or `cargo run`. Program will run in the background and options can be accessed by right clicking the system tray icon.

- Activate the windowing grid with hotkey `CRTL + ALT + S`.

- Increase / decrease grid rows / columns with `CTRL + arrows`.

- Hovering cursor over the grid will show a preview of that zone in the window.

- Select a window you want resized, then click on a tile in the grid. Window will resize to that zone.

- Hold `SHIFT` down while hovering after a selection, zone will increase in size across all tiles. Select again to resize to larger zone.

- Resizing can also be achieved by click-drag-release. Click & hold cursor down, drag cursor across multiple tiles and release to make selection.

- F1 - F6 can be used to toggle between saved profiles. F1 is the default profile loaded when program is first started.

## Config

See [example config](https://github.com/tarkah/grout/wiki/Example-Config) in the wiki for a full list of all options.

- A configuration file will be created at `%APPDATA%\grout\config.yml` that can be customized. You can also open the config file from the system tray icon.