Differences from the original

This is a continuation of the work started by Ben Curtis @FmStrat. Ben created the original extension, but GrylledCheez has done considerable code revision and feature additions. Because of the frustrating release schedule, this repo will now be strictly separate and be released independently under the name "Wintile-Beyond"

WinTile-Beyond: Windows 10 window tiling for GNOME

WinTile-Beyond is a hotkey driven window tiling system for GNOME that imitates the standard Win-Arrow keys of Windows 10, allowing you to maximize, maximize to sides, or 1/4 sized to corner a window using just <Super>+<Arrows>.

WinTile-Beyond also supports:

• 1-5 columns for standard or ultrawide monitors
• 1-5 rows for standard or ultrawide monitors
• Mouse preview and snapping for placing tiles
• "Maximize" mode, which adds/removes GNOME animations
• Ultrawide-only mode allows 16:9 screens to use separate row/col counts
• Portrait screens will automatically swap columns and rows
• Adding gaps around tiles

Usage:

Moving with arrow key:

Pressing <Super>+<Arrows> will move tile around the screen.

• <Super>+<Up> will maximize your tile with a few different levels

  • Maximized vertically in the current column
  • Maximized horizontally in the top row
  • If you're using 4-5 col mode, it will maximize in the center leaving 1 column on either side first

• <Super>+<Left> or <Super>+<Right>

  • Move a tile in that direction. If it's at the edge of a screen, it will go full-height
  • If a tile is more than 1 column wide and on the edge in that direction it will shrink by 1 column

• <Super>+<Down> will maximize your tile with a few different levels

  • If you're already maximized in 4/5 col mode, it will downsize in the center leaving 1 column on either side
  • If maximized vertically, it will shrink to the bottom row
  • If minimizing is enabled, the tile will disappear to the task bar

• <Super>+<Ctrl>+<Arrow> will grow the window in that direction if there is room

Moving with the mouse:

Dragging a window around the edge of the screen will create a preview of where that tile will snap.

There are a few zones to be aware of

• Top Center maximizes a window

• Bottom Center maximizes horizontally in the bottom row

• In the center of any column on the bottom row will maximize vertically in that column

• Right or left center will maximize vertically in a column

  • If using 4/5 columns and double-width is enabled, it will maximize on that half of the screen

• Holding <CTRL> while dragging will create a 1x1 anywhere in the grid without needing to be at an edge

• Holding <SUPER>+<CTRL> will create a start point for multi-row/col tiles

• Any other zone along the edge will create a 1x1 tile

Configuration

Browser

1. Visit https://extensions.gnome.org/local/
2. Click on the "Configure this extension" button.

Gnome-tweaks

1. Open Extension settings in [Gnome Tweaks] (https://gitlab.gnome.org/GNOME/gnome-tweaks)
2. locate WinTile-Beyond and click on the cogwheel button to bring up the configuration dialog.

Installation

GNOME Extension site:

https://extensions.gnome.org/extension/6970/wintile-beyond/

Building from source

1. Download source code from the Master or develop branches.
2. unzip the file
3. cd into the directory it creates
4. run ./build.sh
5. run unzip -d wintile-beyond@GrylledCheez.xyz wintile-beyond@GrylledCheez.xyz.zip
6. run cp -r wintile-beyond@GrylledCheez.xyz ~/.local/share/gnome-shell/extensions/
7. restart your session

Wayland users need to reboot to enable the extension.

Gnome users can press <Alt>+<F2> and run r from the prompt. (IT WILL NOT WORK from a terminal)

Debugging

If you're having issues, please attach some debug logs to your issue. Note: debugging must be enabled in WinTile-Beyond settings

journalctl -qf | grep -i -e wintile -e 'js error'