A window tiling extension for Gnome. This is the new official home of the vibou.gTile extension.
Clone or download
scherepanov Merge pull request #65 from WBTMagnum/master
Improved inline documentation and fixed whitespace
Latest commit b2c7cce Jan 11, 2019

README.md

gTile

Gnome-shell extension that improves window tiling capabilities of stock gnome-shell.

gTile is used to moves/resize windows on a configurable grid scheme.

It can be used with either the mouse, or keyboard, including customizable keyboard presets for immediate window placement.

This extension is particularly useful for window management on (multiple) large monitors.

Installation

Preferred installation is from Gnome Extensions

You can alternatively manually install the latest version from GitHub master branch:

  1. Clone the repository to the Gnome extensions folder.

    git clone https://github.com/gTile/gTile.git ~/.local/share/gnome-shell/extensions/gTile@vibou
    
  2. Restart Gnome (only on X11, on Wayland you will have to log out and log back in)

    Alt-F2
    Enter a Command: r
    

Configuration

For configuration, please use the built-in preferences dialog (Gnome Tweak Tool -> Extensions -> gTile -> Preferences). For configuration changes to take effect, disable/enable gTile (Gnome Tweak Tool -> Extensions -> gTile -> Off/On ) In the Help tab you will find help and usage hints.

  • Keyboard shortcuts:
    • Can be assigned from the preferences window (Accelerators tab)
    • Both the key combinations and the respective function are configurable
    • Can be Global (can be used directly without the main gTile window)
    • Can be non-global (can only be used when the gTile window is shown)
    • Up to 30 accelerators can be configured, which should be plenty
    • Up to 10 accelerators for AutoTiling
  • Grid schemes:
    • Are defined in the preferences window (Basic tab)
    • Written as a comma-separated list of grid sizes like 8x7,3x2,4x6,4x7 (no spaces)
  • Resize presets:
    • Are defined in the preferences window (Reset presets tab)
    • Format: grid size, top left corner tile, bottom right corner tile
    • Format examples: "2x2 0:1 0:1" or "6x4 0:2 3:3"
    • Grids setup here size can be of any size, not necessarily what you have set up in grid sizes settings

Usage with interface

  1. Make sure the window you want to resize has focus
  2. Click on the gTile icon on the tool bar, or press Super+Enter (default)
  3. The gTile dialog pop-up will show up in the center of your screen

What these buttons do:

  • Toggle animation icon <- this one toggles the animation of the changes to the preview drawing.

  • Toggle auto-close icon <- this one toggles the auto-closing of the gTile window after applying the changes.

Using the mouse

  1. Use the mouse cursor to click on one of the desired corner coordinates, and then the other corner coordinates
  2. Window will resize after the second click

Using the keyboard

  1. Use the arrow keys to select the coordinate of the first corner and Shift-arrow to select the second coordinate
  2. a) Hit Space to change the grid scheme [optional]
  3. b) Hit Enter and the window will resize
  4. c) Hit Escape to cancel resize

Usage with no interface

You can also resize windows using Keyboard shortcuts directly.

There are 3 groups of pre-configured shortcuts, representing the following grid schemes:

  • Grid 2x2 -> Super + Alt
  • Grid 2x3 -> Super + Control
  • Grid 3x3 -> Super + Shift

These "grid selectors" are then combined with a keypad number to define the window placement:

Default shortcuts for Super+Alt+[1..9(keypad)]

1 - Bottom left quarter of screen 2 - Bottom half 3 - Bottom right quarter 4 - Center left 5 - Center 6 - Center right 7 - Top left quarter 8 - Top half 9 - Top right quarter

Note: Preconfigured keyboard shortcuts are optimized for horizontal screens.

AutoTiling

You can do auto tiling for all windows on screen

  1. Activate gTile by pressing KP_Enter or clicking on gTile icon
  2. Click on one of 2 autotile buttons, or
  3. Press one of 1 - 0 (total 10 available)

Overlap with stock Gnome-shell shortcuts

gTile is intended to supplement existing Gnome-shell keyboard shortcuts.

Here are some useful Gnome built-ins to keep in mind when configuring gTile:

  • Super + Up - Maximize
  • Super + Down - Un-Maximize (return to size and position previous to maximizing)
  • Super + Left/Right - left/right half of screen
  • Shift + Super + Up/Down/Left/Right] - move window to adjacent monitor/workspace

Source code

This extension is developed at GitHub.

See gTile help in Preferences for info on development and debugging.

It was originally developed by vibou with help from multiple contributors, and is now community supported.

gTile is licensed under the GPL v2+

Enjoy!