Skip to content

Extend Gnome Shell with advanced tiling window management. Supports multiple monitors, Windows 11 Snap Assistant, Fancy Zones, customised tiling layouts and more.

License

Notifications You must be signed in to change notification settings

domferr/tilingshell

Repository files navigation

kofi

Tiling Shell

This is a Gnome Shell extension implementing modern windows tiling system by extending GNOME's default 2 columns to any layout you want! Can be installed on Gnome Shells from 40 to 46 on X11 and Wayland: the most recent GNOME Shell is supported, and older releases will include all the features and bug fixes!

  • 🤩 First and only extension that provides Windows 11's snap assistant
  • 🖥️🖥️ multiple monitors support, even with different scaling factors!
  • ⚙️ Manage, edit, create and delete layouts with a built-in editor
  • 💡 Layouts are not strict, you can span multiple tiles if you want
  • 🚀 Automatically sets the same UI of your GNOME theme, for a seamless integration!

Have issues, you want to suggest a new feature or contribute? Please open a new issue!

Usage

Tiling System

When grabbing and moving a window, press CTRL key to show the tiling layout (you can choose another key from the preferences). When moving on a tile, it will highlight. Ungrab the window to place that window on the highlighted tile.

tiling_system.webm

This extension and the tiling system also implements Windows PowerToys FancyZones!

Snap Assistant

When grabbing and moving a window, the snap assistant will be available on top of the screen. Move the window near it to activate the snap assistant. While still grabbing the window, move your mouse to the tile you are interested in. By stopping grabbing the window will be tiled to the selected tile!

snap_assistant.webm

Select a layout

Click on Tiling Shell's panel indicator and the available layouts will be shown. Select the one you prefer by clicking on it. That layout will be applied to every monitor in case you have more than one.

layout_selection.webm

Select multiple tiles

The layout is not strict. You can select multiple tiles too! Just hold ALT while using the tiling system (you can choose another key from the preferences).

multiple_selection.webm

Layout editor

Split a tile Split a tile vertically Delete a tile Save, close the editor or open the menu
LEFT CLICK LEFT CLICK + CTRL RIGHT CLICK Click the Tiling Shell's icon on the panel.
layout_editor.webm

Smart resize

You can resize adjacent tiled windows together!

recursive_resize.webm

It can be enabled/disabled from the preferences

Tile using Keyboard

Move window through the tiles using keyboard shortcuts (SUPER+///). They can be customized from the preferences!

Screencast.from.2024-06-18.23-06-56.webm

It can be enabled/disabled from the preferences

Edge Tiling

You can tile a window by moving it to the edge.

Screencast.from.2024-06-22.22-12-22.webm

Installation

This extension is published on extensions.gnome.org! You can install from there or install manually. By installing from extensions.gnome.org you will always have the latest update.

Install manually

Download the latest release. Extract the downloaded archive. Copy the folder to ~/.local/share/gnome-shell/extensions directory. You need to reload GNOME Shell afterwards (e.g. by logging out). Then you can enable the extension:

/usr/bin/gnome-extensions enable [email protected]

Install via Source

Clone the repo then run npm i to install dependencies and then run npm run build to build the extension. To finally install the extension run

npm run install:extension

You can restart your GNOME shell e.g. logout then login, or restart in place with an alt-F2 and entering r (X11 only) and enable the extension. Enjoy it! To enable via the command line you can run

/usr/bin/gnome-extensions enable [email protected]

To read the logs you can run

journalctl --follow /usr/bin/gnome-shell

Uninstall Tiling Shell

To uninstall, first disable the extension and then remove it. To disable via the command line you can run

/usr/bin/gnome-extensions disable [email protected]

Contributing

Feel free to submit issues and Pull Requests!