#i3 #sway #workspace #mouse #scroll

app i3-workspace-scroll

A helper for switching i3 or sway workspaces

1 unstable release

0.1.0 Feb 27, 2020

#1060 in Hardware support




This is a small wrapper around the i3 / sway commands 'workspace prev_on_output' and 'workspace next_on_output' that I created to make better use of the horizontal scroll wheel on my mouse. It does the same as those i3 / sway commands, except when the next next workspace is requested on the last one on the focused output, or the previous workspace is requested on the first one. In those cases, it simply does nothing, instead of wrapping around like the i3 / sway commands do.


cargo install --git https://github.com/jplatte/i3-workspace-scroll


Note: You might want to swap button6 and button7 depending on your mouse.


Note: In sway, it won't work when the cursor is on top of a non-window surface (e.g. the bar).

Horizontal scroll wheel:

bindsym --whole-window --border --input-device=<device> +button6 exec ~/.cargo/bin/i3-workspace-scroll prev
bindsym --whole-window --border --input-device=<device> +button7 exec ~/.cargo/bin/i3-workspace-scroll next

Regular scroll wheel + modifier:

bindsym --whole-window --border --input-device=type:pointer $mod+button4 exec ~/.cargo/bin/i3-workspace-scroll prev
bindsym --whole-window --border --input-device=type:pointer $mod+button5 exec ~/.cargo/bin/i3-workspace-scroll next


Note: The code blocks below are configuration for xbindkeys, which needs to be started with i3 for this to work. The configuration has to be placed in ~/.xbindkeysrc.

Horizontal scroll wheel:

"~/.cargo/bin/i3-workspace-scroll prev"

"~/.cargo/bin/i3-workspace-scroll next"

Regular scroll wheel + modifier:

"~/.cargo/bin/i3-workspace-scroll prev"
  Mod4 + b:4

"~/.cargo/bin/i3-workspace-scroll next"
  Mod4 + b:5


This application is licensed under the GNU General Public License v3.0 or any later version. The full license text can be found in the file next to this README.


~24K SLoC