gTile

Score 73

Issues Website Download

UUID: gTile@shuairan

Last edited:

4 days ago 2025-09-13, 13:59

Last commit: [4abcc015] fix hotkey inactive after monitor wakes bug; add Gnome Tactile like functionality (#926)

Tile your windows as you like.

README

gTile

Usage

Super + G open gTile
Esc close gTile
ARROWS move with keyboard
Shift + ARROWS select area
Space or Enter tile the selected area
Alt+ARROWS to move between monitors
1,2,3,4 to select between the 4 tiling settings
If Show Tile Labels is enabled in settings, type two labels to tile active window. The first label will be used for the top left corner, and the second for the bottom right corner. For more info, see Gnome extension Tactile.

More options are available in Cinnamon Settings -> Extensions -> gTile@shuairan -> Settings.

This extension was originally developed by vibou and shuairan. It is now maintained by the community.

CHANGELOG

Open

2.3.0

Add back old behavior as an option - Display UI on all monitors at the same time
Fixes #421 Add back old behavior as an option - UI can have a fixed size instead of respecting the monitor's aspect ratio
Add back old behavior as an option - Always use monitor's center
Fix Auto-Tiling not working in 5.4 version
Fixes #420

2.2.0

Split codebase after Cinnamon version 5.4 because of breaking changes and fix breakages.

2.1.0

Change Settings and Grid so they can be initialized from inside the app itself.
Add support for uneven rows and columns

2.0.0

Structural

Using Typescript (WIP, should enable stricter type checking)
Uses webpack for build (was not necessary, but I didn't want to bother with fixing recursive imports)
Enables multiversion support (I won't modify anything under Cinnamon version 3.8)
Factor ui elements out into their own files

Enhancements

UI facelift (using symbolic icons)
Port enhancement from cinTile where grid is only show on the monitor the focused window is on
Resolves #299 - Port fix for sizing issues with windows with client headers
Resolves #367
Resolves #336
Resolves #191 - Add Support for move windows between monitors (essentially move the singular grid ui from window to window.) Animations are a still weird as grids come in from the top left, always.
Add Keybindings Legend to settings for current available keybindings

1.0.0

Added compatibility for Cinnamon 3.8+.

Original Changelog

v0.7

Cinnamon 2.4
put all settings to extension setting screen
AutoTile: only tile non-minimized windows
AutoTile: improve on multi monitor (only tile windows in current screen)

v0.6

merge some upstream changes from vibou.gTile (V21)
exclude some apps with no wm_class. This is a wild guess to find apps which should not be tiled (like Hangouts)
hide on escape
- better multi-monitor support
new feature: select and tile by keyboard (move with Arrows, Shift+Arrow to select area, space or enter to tile window)

v0.5

support for latest cinnamon >1.8
settings-system is used (configure keyboard shortcut via extension settings)

v0.3 thx to dalcde

fixed conky-bug
changed compatiblity to match all 1.6 releases
changed grid color to blue
removed panel icon (use applet instead: https://github.com/shuairan/gTile-applet )

v0.2

added support for different panel positions of cinnamon (top,bottom,both)
panel icon is now displayed

v0.1

added support for cinnamon
fixed small offset

Log In To Comment!

83 Comments

Fonziemedia-4 months ago

Just a heads up to newcomers that this extension seems currently unsupported. It has bug since 2023 which makes it very unreliable: https://github.com/linuxmint/cinnamon-spices-extensions/issues/512

Heavygrass-3 months ago

Do you know an alternative for Cinnamon 6.0.4?

Person1873-4 months ago

not sure if it's possible to add a toggle to enable permanent auto-tiling? or even a KB shortcut for each of the quick options seen at the bottom of the super+g screen

pmcl-solutions-7 months ago

Is there a way to set spacing between the tiles?

Franz Schlicht-7 months ago

is there a way to personalize the hotkeys? I would like to set the tile selection with ctlr+h, ctrl+j, ctrl+k, ctrl+l to get a similar behavior like in vim and I don't have to use the arrow keys. Otherwise great extension

MrTheDoctor-8 months ago

Does "maintained by the community" now mean this is essentially unsupported? Seems like this useful extension needs someone to herd the cats. I'd even volunteer tho I'm not a super-techy individual. My concern--the little windoid goes transparent pretty often and just disappears. Anyone else experiencing this? Thx all.

Raymundo Cassani-6 months ago

The issue is reported in here: https://github.com/linuxmint/cinnamon-spices-extensions/issues/512 It seems it is race condition, you could take a look and a try to fix it ;)

SteegHobland-10 months ago

Could you fix it so Firefox tiles without any undesirable gaps or offsets?

André Amaral-11 months ago

Is there a way of choosing the mouse right click (when dragging) to open the gTitle menu to choose the position like the Microsoft PowerToys Fancy Zones? This would be very nice.

jm2k7-1 year ago

This plugin is fine, the only thing missing is that it is automatic and leaves the windows as they were when they are deactivated. It is not the same as the automatic tiling of Pop OS or another desktop environment with the same function, but at least it solves something. If the developer implements this suggestion it would be perfect.

Martin-1 year ago

I like the extension, but would like to have a 1 x 2 tile setting. Can this be added, or is there a way for me to change the config to change one of the other layouts to a 1 x 2 layout? Because I am using a laptop, I wouldn't ever use the 4 x 4 or 6 x 6 layouts. I don't understand the Auto tile main and list or the Auto tile two lists. Will the former meet my needs? Where can I find explanations?

D4rkKaizen-1 year ago

awesome extension

Jamie Knight-1 year ago

The issue of gTile not working after the monitor sleeps, and then disabling keys on the keyboard, isn't fixed. This is a great extension but sadly it just doesn't work correctly.

tuxfanmatze-1 year ago

Geart APP! Easy to use and works out of the box with Cinnamon 21.2! Many Thanks!!!

27n3xTOR-1 year ago

Thanks for this. I have an app that was not tiling properly in Mint LMDE6 and gTile fixed it for me.

Domenico Sgarbossa-2 years ago

As someone else there is a problem with Linux Mint 21. gtail resizes but does not move the gnome-terminal (v3.44.0) window to the indicated location.

gunnm-1 year ago

edit /home/<user>/.local/share/cinnamon/extensions/gTile@shuairan/gTile.js line: 1492-1495 add: metaWindow.move_frame(true, x, y); before metaWindow.move_resize_frame(true, x, y, width, height); result: const move_resize_window = (metaWindow, x, y, width, height) => { if (!metaWindow) return; metaWindow.move_frame(true, x, y); metaWindow.move_resize_frame(true, x, y, width, height); }; go to extensions disable extension and re-enable it. should now work with terminal too

gunnm-1 year ago

original fix by jshack88 https://github.com/gTile/gTile/issues/176

wilq12-2 years ago

https://ibb.co/d7qw0s7 can't click on those outside the window, mint 20.3

Florian Bogner-2 years ago

Thanks a lot. This is great for arranging windows on ultra-wide screens.

Shane B.-2 years ago

Neat, I am pleasantly surprised that this allows me to recreate my main windows 10 "FancyZones" layouts on my ultrawide monitor. Thank you to the creators/maintainers!

iglumedia-2 years ago

I love this tool! No more drama with pacing windows by hand. But I would really love to have a margin between windows. Is there a way to achive this?

iglumedia-2 years ago

Went through the code and made a quick'n'dirty solution. In File: .local/share/cinnamon/extensions/gTile@shuairan/5.4/gTile.js: Row: 1482 i simply added the desired margin and reduced the window size accordingly: x+=10; y+=10; width-=20; height-=20; if i ever get bored, I might look deeper into this.

iglumedia-2 years ago

the function to be edited is called 'const move_resize_window' currently in row 1492 after the latest update

JUL9NN0-11 months ago

do i add those in a new line or modify the code? if so how? ive been wanting to do this but i dont really know much abt coding tyty

pcolamar-2 years ago

Why does the package contain a 3.8 and a 5.4 version ?

Attila Greguss-2 years ago

There were some breaking changes in cinnamon 5.4, so the codebase had to be split

allstar87-2 years ago

So, is there no way to just bind global hotkeys to outright replace the default tiling? You HAVE to use the little pop-up window?

Z1moRG-2 years ago

There is a problem with Linux Mint 21. Gtail resizes but does not move the gnome-terminal (v3.44.0) window to the indicated location.

Kater-Ben-2 years ago

thank you for this great tool, it helped tremendously with my switch from Windows to Linux mint

André Amaral-3 years ago

Extension is BROKEN under Cinnamon 5.2.7 Unable to launch the extension neither settings.

Sergey-3 years ago

Most useful extension! But it broke in Cinnamon 5.4.2.

Attila Greguss-3 years ago

Fix is sitting as a PR: https://github.com/linuxmint/cinnamon-spices-extensions/pull/387

Alex Bujorianu-3 years ago

The invocation shortcut appears to be broken as of Cinnamon 5.4.2.

Kim W.-3 years ago

Great. Really like it. Unfortunately the shortcuts: Shift + ARROWS (select area) and Alt+ARROWS (to move between monitors) does NOT work.

daved3luxe-3 years ago

Can someone tell me how exactly I can change the size of the tiles? I am currently using 1x3 and I would like to make the center window wider than the two outer ones. Unfortunately, I can't find a file in which I can make such settings.

Wilfried-3 years ago

So i've just created a request here in the Github, you can upvote it if you want it to get more visibility : https://github.com/linuxmint/cinnamon-spices-extensions/issues/378

Wilfried-3 years ago

Following

chrisatbest-3 years ago

The extension is very helpful. I do not know if you want suggestions, but it'd be nice if you could do it based on percentage. Settings 'Column 80% 20%, Row 100%'

m-kowalski-3 years ago

Please add “Restore the original size of windows when unsnapping” option

Said Neder-3 years ago

Great extension thank you!

Roi Snir-3 years ago

How can you select tile in a second monitor with the keyboard? the arrow keys stay on one monitor and I can only select tiles in the other monitor with the mouse

ajdepaul-3 years ago

Found this open bug report from 2018 that makes me think this isn't getting fixed anytime soon :/ https://github.com/linuxmint/cinnamon-spices-extensions/issues/191

Christopher Schneider-4 years ago

Works fine. Would really benefit from the ability to customize zones instead of having predefined. None of the pre-defined layouts are what I really want for my Odyssey G9 monitor. I'd like to have a single row of 3 windows, with windows on either side being a tad smaller than the center window. There's obviously some configuration behind the scenes for the predefined zones, so exposing that to the user would make this infinitely more useful. As it stands, I have it installed but don't really use it.

w27y-4 years ago

Works great, most of the alternatives I've seen for Linux in general deal with window tile managers that completely remove your floating window/desktop environment. There's a ton of paid and free apps on Windows for snapping/tiling, but this was surprisingly difficult to find. I like how simple it is to switch to 2x2, 3x2, etc. Got this on a 50" 4k screen, as 3x2, and looks amazing, no wasted space.

Andrei Miculita-4 years ago

For some reason, sometimes my selection gets canceled after a few seconds if I try to select with my mouse. I'm using the 6x6 format. So if I'm dragging, it will randomly forget the tile I started with and act as if I just opened the extension.

orbitalchicken-5 years ago

How do I add a quick launch icon to gTile in my taskbar ? (what is the command line to start it instead of Gtrl+G ?)

Rubem Pacelli-5 years ago

Since I started on Mint, I have delved for a good window tilling. I found Gtile, but even so, it just has the basic function of shift+arrows to adjust the window on my screen, It is not enough. To my surprise, I found out that Ubuntu has this extension too, but with a lot of functions. So, what the difference between these two projects? Is it possible to install this gnome extension on Mint. Thanks in advance.

paulsurman-5 years ago

Frivolous is fun, but genuinely useful like this, is better. Thank you for this easy to use aid to tiling.

Maxcrazy1-5 years ago

How can I switch between one screen to another and how change the screen grid from keyboard?

ivanaponi-5 years ago

Where are the settings stored? I cannot find a config file or them in gsettings

ivanaponi-5 years ago

For some odd reason my SUPER+G key combo stopped working

ivanaponi-5 years ago

Also unable to access settings in the extension UI

ivanaponi-5 years ago

It's also not possible to disable now in the Manage extensions UI

xmo-odoo-5 years ago

Are you sure the extension is enabled in the first place? I've had the issue that the extension seemed to not work at all, but it just didn't enable on install.

skoufaki-5 years ago

very nice work - thanks a lot! if one could AutoTile all open windows only of a specific application it would be a blast ;)

Stefan Strohmeier-5 years ago

Great extension. I really love it. It works fine for me under Linux Mint 19.3 and Cinnamon 4.4.8. The only thing is that I cannot get a keyboard shortcut for AutoTile working. I tried a lot of things, e.g. checking the keycodes. They seem to be okay. Has anyone the keyboard shortcuts for AutoTile working on LM 19.3 and Cinn 4.4.8?

sellias-5 years ago

It's working on Fedora 32. Try pressing the hotkey and then running [c] $ less /var/log/syslog [c]

Rubem Pacelli-5 years ago

In Linux Mint 19.3 Tricia, Gtile doesn't fit when I set just for one tile. I need to hold shift to select 2 or more tile for the Gtile work correctly. Anyone know how to fix it? Besides that, Gtiles works fine.

sellias-5 years ago

If you're still wondering how to solve this problem; just click a second time on the one square in which you wish to place your windows. GTile waits for you to make a box shaped selection. When you click on that one tile it is waiting for where the selection finishes. So just click again on the same tile. Hope all is well!

Łukasz Dobrowolski-5 years ago

Nice idea. Not sure why but it does not work well for me. Windows are properly resized in X, but are cut in Y. https://termbin.com/297z multi screen, multiple virtual screen on single physical device It would be also nice if you add option to remember configured tiles.

Stigma67-5 years ago

I have the same problem. Does anyone have a solution for this?

leroyz84-6 years ago

Thank you for this add one! Maybe a feature request: Tile all active windows [horizontally|vertically] ?

leroyz84-6 years ago

edit: i see it's there! Love it; thank you!

Lowrida-6 years ago

"More options are available in Cinnamon Settings -> Extensions -> gTile@shuairan -> Settings." Not in Mint 19.2 Cinnamon. I had to edit extention.js and remove the three slashes in front of the 'const' !

Christopher Nash-6 years ago

I've just upgraded from Linux Mint 19.1 to Mint 19.2 and this extension has stopped working. I get the message "Problems during Cinnamon startup" dialog box when I log into Mint. What information can I give to have this fixed? (I'm so lost without having it... :-p )

Mikko Vedru-6 years ago

Disable and enable the extension again. Seemed to work for me, at least partly.

Sebastian Haas-6 years ago

Hey, is there any way to call gTile from CLI / Bash / zsh? I'd like to use it to create hotkeys for positions. Something like "gTile 4x4 1 2" which would describe the 4x4 tiles and first column second row e.g. Thank you for the extension :)

Lorenz Stangier-6 years ago

I don't think (or at least I don't know of any) way to use gtile as command line tool. You could check out http://tripie.sweb.cz/utils/wmctrl/ instead. You can move/resize windows with it from the commandline.

watercolorhearts-7 years ago

Hi, where is the README.md located for this when installing it using Extensions menu in Linux Mint system settings? Thanks.

bbuist-6 years ago

https://github.com/linuxmint/cinnamon-spices-extensions/blob/master/gTile@shuairan/files/gTile@shuairan/README.md

Eric Adams-7 years ago

Has anyone had luck getting this to work on Cinnamon 3.8?

sellias-5 years ago

It's working on 4.4.8! Give it another shot!

Dustin Falgout-7 years ago

Works fine for me on Cinnamon 3.6.7

Andrea Moro-7 years ago

Doesn't seem to work on Mint 18.3. The super key + space doesn't activate the panel.

sellias-5 years ago

It's working on 4.4.8! Give it another shot!

bbuist-6 years ago

Have you enabled the extension? This got me the first time, I thought downloading was enough. Click the + to enable.

Futureknows-7 years ago

Can it run on Fedora 27 Cinnamon (Cinnamon v3.6.6)?

sellias-5 years ago

It's working on 4.4.8! Give it another shot!

garfazadeh-7 years ago

This is exactly what I need. I would love to have settings for window margins as well.

Brian A-7 years ago

I'm running Mint 18.2 Cinnamon, fully updated. This extension looks really useful. Unfortunately, when I try to install it, via the settings application, it reports: - "Extension gTile@shuairan is not compatible with current version of cinnamon. Using it may break your system. "

sellias-5 years ago

It's working on 4.4.8! Give it another shot!

Jeremy Garcia-7 years ago

Also running 18.2 and got the same error; it's really a general disclaimer because the dev can't account for future changes in Cinnamon. You can click "yes" to load extension anyway - it seems to more or less or less work. When using the Auto-Tile function the window positioning has a negative vertical offset, so the tops of windows won't use the very top of the screen, and the bottom of windows will be cut off by the bottom panel. This issue may be specific to my system (i.e. might conflict with another extension). Manual tiling doesn't have this issue. So it works for me and hasn't broken my system.