yatta
BSP Tiling Window Manager for Windows 10
Getting Started
This project is still heavily under development and there are no prebuilt binaries available yet.
If you would like to use yatta, you will need a working Rust development environment on Windows 10. If you are using the x86_64-pc-windows-msvc toolchain, make sure you have also installed the Build Tools for Visual Studio 2019.
You can then clone this repo and compile the source code to install the binaries for yatta and yattac:
cargo install --path yatta
cargo install --path yattac
By running yattac start at a Powershell prompt, you should see the following output:
Start-Process yatta -WindowStyle hidden
This means that yatta is now running in the background, tiling all your windows, and listening for commands sent to it by yattac.
You can similarly stop the process by running yattac stop, and you should see the following output:
Stop-Process -Name yatta
Keybindings
This project does not handle anything related to keybindings and keyboard shortcuts. I am currently using AutoHotKey to manage my window management keyboard shortcuts. Here is a sample yatta.ahk AHK script that you can use as a starting point for your own:
; Start yatta, this command makes sure no duplicate processes will be created
Run, yattac.exe start, Hide
; Send the configuration options for yatta here
;
; Ensure there are 3 virtual desktops
Run, yattac.exe ensure-desktops 3, Hide
; Always open Signal in Desktop 2
Run, yattac.exe exe-desktop Signal.exe 2, Hide
; Always open Ferdi in Desktop 2
Run, yattac.exe exe-desktop Ferdi.exe 2, Hide
; Always float IntelliJ popups, matching on class
Run, yattac.exe float-class SunAwtDialog, Hide
; Always float Control Panel, matching on class
Run, yattac.exe float-class CabinetWClass, Hide
; Always float Task Manager, matching on class
Run, yattac.exe float-class TaskManagerWindow, Hide
; Always float Wally, matching on executable name
Run, yattac.exe float-exe Wally.exe, Hide
; Always float Calculator app, matching on window title
Run, yattac.exe float-title Calculator, Hide
; Change the focused window, Alt + Vim direction keys
!h::
; This sends an Alt key which is a hack to steal focus when Windows doesn't feel like respecting SetForegroundWindow
; https://stackoverflow.com/questions/10740346/setforegroundwindow-only-working-while-visual-studio-is-open
Send !
Run, yattac.exe focus left, , Hide
return
!j::
Send !
Run, yattac.exe focus down, , Hide
return
!k::
Send !
Run, yattac.exe focus up, , Hide
return
!l::
Send !
Run, yattac.exe focus right, , Hide
return
; Move the focused window in a given direction, Alt + Shift + Vim direction keys
!+h::
Run, yattac.exe move left, Hide
return
!+j::
Run, yattac.exe move down, Hide
return
!+k::
Run, yattac.exe move up, Hide
return
!+l::
Run, yattac.exe move right, Hide
return
; Promote the focused window to the top of the tree, Alt + Shift + Enter
!+Enter::
Run, yattac.exe promote, Hide
return
; Switch to an equal-width, max-height column layout, Alt + Shift + C
!+c::
Run, yattac.exe layout columns, Hide
return
; Switch to the default vertical bsp tiling layout, Alt + Shift + T
!+t::
Run, yattac.exe layout bspv, Hide
return
; Force a retile if things get janky, Alt + Shift + R
!+r::
Run, yattac.exe retile, Hide
return
; Float the focused window, Alt + Shift + F
!+f::
Run, yattac.exe toggle-float, Hide
return
; Pause responding to any window events or yattac commands, Alt + P
!p::
Run, yattac.exe toggle-pause, Hide
return
As more commands are still being added and some commands and arguments may change before the CLI is stabilised, I recommend running yattac.exe help to see the full list of commands and operations available to be bound to keyboard shortcuts.
3 Mar 25, 2024
17 Aug 16, 2023
80 Oct 10, 2023
899 Jan 1, 2023
2 Nov 8, 2021
2 Mar 11, 2022
121 Dec 27, 2022
296 Dec 28, 2022
4 Mar 25, 2022
38 Dec 24, 2022
1 Dec 13, 2021
42 Dec 3, 2022
1 Feb 13, 2022
5 Nov 17, 2022
2 Mar 29, 2022
84 Dec 24, 2022
6 Jan 28, 2023
4 Aug 6, 2022
16 Dec 5, 2022