hallski / slinger

gnome-shell extension for throwing windows around efficiently

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Slinger:

Slinger is a simple app for window manipulation. It provides multiple methods (via both mouse and keyboard) for moving and sizing windows quickly. Here's a quick screencast. The main interface is a circular popup menu which allows quick selection of various presets (half screen + quarter screen), plus plenty of mouse + keyboard shortcuts for moving & resizing.


Global hotkeys

  • win+a: show slinger
  • win+shift+8 (asterisk): splat windows - applies a basic tiling layout so you can see all windows
  • win+z: toggle maximize
  • win+j: next window
  • win+k: previous window
  • win+shift+j: swap with next
  • win+shift+k: swap with previous
  • win+alt+j: next workspace
  • win+alt+k: previous workspace
  • win+alt+shift+j: bring window to next workspace
  • win+alt+shift+k: bring window to previous workspace

Slinger menu:

  • inner ring: maximize / minimize

  • sides: half screen (top/bottom/left/right)

  • diagonals: quarter screen

  • arrows / hjkl: select a preset

  • space/tab: enter modify mode

Modify mode:

  • ctrl+move: move window
  • alt+move: resize closest corner

Modifiers:

These can be uses as-is in "modify mode", or used globally (without showing slinger) by also holding down win (super)

  • equals: shrink
  • minus: grow
  • h: move left
  • l: move right
  • u: move down
  • i: move up
  • shift+h: shrink horizontal
  • shift+l: grow horizontal
  • shift+i: shrink vertical
  • shift+u: grow vertical

Build/install instructions

Install required dependencies:

  • tsc (typescript)

Compile:

tools/gup compile

Install:

ln -sfn $PWD/extension ~/.local/share/gnome-shell/extensions/slinger@gfxmonk.net

History.

Slinger was born out of shellshape, a Gnome Shell extension I created for automatically tiling windows. Shellshape is useful, but it's also buggy and has a lot of ugly interactions with the window system (which itself has plenty of bugs).

Slinger is a simpler layout utility, which maintains many of the window manipulation shortcuts but explicitly does not do any automatic window management - it only does something when you tell it to.

In practice, I've found that slinger is slightly slower than shellshape, but allows me more control (it never gets in my way, and I end up with windows just as I want them rather than "close enough").

Truthfully, slinger was created because shellshape is not worth my time to maintain. There are many unfixable bugs due to the interaction with gnome-shell, and there is a frustrating amount of bookkeeping state and workarounds that need to be maintained so shellshape has an accurate view of the world at all time. Slinger was designed to be stateless, which makes for a simpler codebase with less bugs.

OSX version

Another benefit of a stateless app is that it's more easily portable to different window systems. There is an OSX version here, which lacks a few features, but mostly works.

About

gnome-shell extension for throwing windows around efficiently


Languages

Language:TypeScript 53.2%Language:Python 42.9%Language:JavaScript 2.7%Language:Shell 0.8%Language:Nix 0.4%