https://github.com/szymonwilczek/slab

Blazing fast GNOME tiling manager
https://github.com/szymonwilczek/slab

gjs gnome-extension gnome-shell linux master-stack minimalism tiling-window-manager typescript wayland

Last synced: 6 months ago
JSON representation

Blazing fast GNOME tiling manager

• Host: GitHub
• URL: https://github.com/szymonwilczek/slab
• Owner: szymonwilczek
• Created: 2025-12-31T01:21:05.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2026-01-10T17:33:14.000Z (6 months ago)
• Last Synced: 2026-01-11T04:58:37.827Z (6 months ago)
• Topics: gjs, gnome-extension, gnome-shell, linux, master-stack, minimalism, tiling-window-manager, typescript, wayland
• Language: TypeScript
• Homepage:
• Size: 239 KB
• Stars: 16
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README

Awesome Lists containing this project

README

          
SLAB

====

WARNING: READ THIS FIRST

------------------------

This software is in VERY EARLY ALPHA stage.

There are known bugs.

There are unknown bugs.

I am aware of them and working on them constantly.

Use at your own risk. Expect crashes.

WHAT IS SLAB?

-------------

SLAB is a high-performance tiling window manager extension for GNOME Shell.

It adheres to an "Actor-First" philosophy: visual updates happen instantly

via the compositor, without waiting for the window manager protocol.

This results in zero-latency, glitch-free tiling.

It implements a simple Master-Stack layout:

- Master window on the left.

- Stack of windows on the right.

INSTALLATION

------------

Requirements: GNOME Shell 45+ (mainly targeted at Fedora 43 / GNOME 49)

Dependencies: TypeScript (for building), zip (for packaging)

Download release from GitHub or:

1. Clone the repository:

   git clone https://github.com/szymonwilczek/slab.git

2. Run the build script:

   ./build.sh

3. Install:

   cp -r dist/* ~/.local/share/gnome-shell/extensions/slab@slab.dev/

4. Enable:

   gnome-extensions enable slab@slab.dev

HOW TO USE

----------

- Toggle Tiling: [Super] + [Shift] + [T]

  (This takes the current MONITOR and tiles it instantly)

Rest of the shortcuts does not interfere with GNOME/user default keybindings.

CONTACT / BUGS

--------------

Report issues on GitHub.

Feedback is welcome, especially regarding race conditions or crashes.