Awesome
<img src="https://raw.githubusercontent.com/domferr/tilingshell/main/logo.png" align="right" width="76"/>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 47 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 | ⬇️ Snap Assistant | ⬇️ Select a layout | ⬇️ Select multiple tiles |
---|---|---|---|
⬇️ Layout editor | ⬇️ Smart resize | ⬇️ Tile with Keyboard | ⬇️ Edge Tiling |
⬇️ Tiling Buttons | ⬇️ Per-workspace layout | ⬇️ Auto-tiling | ⬇️ Tiling context menu |
⬇️ Smart border radius |
Tiling System
When grabbing and moving a window, press <kbd>CTRL</kbd> 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.
<p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>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!
<p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>Snap Assistant's sensibility can be customized from the preferences.
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.
<p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>Select multiple tiles
The layout is not strict. You can select multiple tiles too! Just hold <kbd>ALT</kbd> while using the tiling system (you can choose another key from the preferences).
<p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>Layout editor
Split a tile | Split a tile vertically | Delete a tile | Save, close the editor or open the menu |
---|---|---|---|
<kbd>LEFT CLICK</kbd> | <kbd>LEFT CLICK</kbd> + <kbd>CTRL</kbd> | <kbd>RIGHT CLICK</kbd> | Click the Tiling Shell's icon <img src="https://github.com/domferr/tilingshell/assets/14203981/13e27ec1-6a5d-420f-a87f-8f3df0b34c92" width=96 /> on the panel. |
Smart resize
You can resize adjacent tiled windows together!
<p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>It can be enabled/disabled from the preferences
Tile with Keyboard
Move window through the tiles using keyboard shortcuts (<kbd>SUPER</kbd>+<kbd>←</kbd>/<kbd>↑</kbd>/<kbd>↓</kbd>/<kbd>→</kbd>). They can be customized from the preferences!
<p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>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
<p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>Tiling Buttons
Right-click on a window to use the auto-tile buttons and the snap assistant from there! The auto-tile buttons allow you to tile to the leftmost or rightmost empty tile, based on your selected layout. The "Move to best tile" button suggests tiling to the nearest empty tile to the center of the screen.
Screencast from 2024-07-13 18-21-57.webm
<p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>Per-workspace layout
You can select your favorite layout for each workspace of each monitor.
<p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>Auto-tiling
When a window is created, it is automatically moved to the best tile according to where other windows are tiled and the current layout. This is disabled by default and can be enabled in the preferences.
Export and import layouts
Tiling Shell supports importing and exporting its layouts to a JSON file. With this you can create your own custom layouts without the built-in graphical editor, or share your layouts with others! If you are interested into knowing more about the contents of the layout file check the official documentation.
<p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>Tiling context menu
Right-click on a window to use the auto-tile buttons and the snap assistant from there! These buttons allow you to tile to the leftmost or rightmost empty tile, based on your selected layout. The "Move to best tile" button suggests tiling to the nearest empty tile to the center of the screen.
<p align="center"><img src="https://github.com/user-attachments/assets/d660779a-7549-4858-b149-59edad076483" width=520/></p> <p align="center">Check the demonstration video to see it in action!</p>Screencast from 2024-07-13 18-21-57.webm
<p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>The original idea was to show the snap assistant when hovering the maximize button (as it is done on Windows 11). Unfortunately, GNOME doesn't let us handle the hovering of the maximize button or add another button near it...
Smart border radius
In GNOME, different windows may have different border radius. Drawing a border around the focused window is hard because it is not possible to know the window border radius. All the existing extensions just draw a border with a static value, making the UI less polished. Tiling Shell, dynamically computes the focused window border radius at runtime. Moreover, if you have an extension or anything else who customize the border radius, the focused window border radius adapts as well! This can be enabled/disabled from the extension's preferences too.
<p align="center"> <img src="https://github.com/user-attachments/assets/cfaca5f9-d9b2-4739-9426-1aebb5f33c29" width=304 /> <img src="https://github.com/user-attachments/assets/8e68abff-66e5-4b85-a6ce-0bd2da7be166" width=332 /> </p> <p align="right"><b>Go to Usage</b> <a href="#usage">⬆️</a></p>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.
<div align="center"> <a href="https://extensions.gnome.org/extension/7065/tiling-shell/" > <img src="https://img.shields.io/badge/Install%20from-extensions.gnome.org-4A86CF?style=for-the-badge&logo=Gnome&logoColor=white"/> </a> </div>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 tilingshell@ferrarodomenico.com
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 tilingshell@ferrarodomenico.com
To read the logs you can run
journalctl --follow /usr/bin/gnome-shell
To read the logs of the preferences you can run
journalctl -f -o cat /usr/bin/gjs
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 tilingshell@ferrarodomenico.com
Contributing
Feel free to submit issues and Pull Requests!