This extension modifies and extends existing touchpad gestures on GNOME using Wayland. This project is a fork of gnome-gesture-improvements. Since the original project seems to be no longer maintained, I setup this project with the aim of taking over the development and maintenance of this wonderful extension that I relied on for daily use.
Note:
mainbranch contains latest changes which may not work on older version of GNOME, please choose the correct branch if install from source.- To view the extension's settings window, user need to install
extensionsapp. - I have removed the support for X11 since I only use Wayland, but this can be added again in the future if needed and if someone is willing to support this.
- There is a bug in GNOME 49 which break the extension, you have to upgrade to GNOME 49.3 or compile it from source for the extension to work again.
Note: Please choose correct branch for your corresponding version of GNOME first.
- Install extension
git clone https://github.com/HieuTNg/touchpad-gesture-customization.git
cd touchpad-gesture-customization
npm install
npm run update
- Log out and log in
- Enable extension via extensions app or via command line
gnome-extensions enable touchpad-gesture-customization@coooolapps.com
| Swipe Gesture Actions | Description | Fingers | Direction |
|---|---|---|---|
| Overview navigation | Switch between overview, app grid, activites | 3/4/both | Vertical/Horizontal |
| Workspaces Switching | Switch between workspaces | 3/4/both | Vertical/Horizontal |
| Windows Switching | Switch between windows | 3/4/both | Vertical/Horizontal |
| Maximize a window | Part of Window Manipulation | 3/4/both | Vertical |
| Unmaximize a window | Part of Window Manipulation, not Minimize | 3/4/both | Vertical |
| Fullscreen | Part of Window Manipulation, not Maximize | 3/4/both | Vertical |
| Minimize a window | Part of Window Manipulation | 3/4/both | Vertical |
| Snap/half-tile a window | Part of Window Manipulation, snap window to | 3/4/both | Vertical (*) |
| either half of screen | |||
| Volume Control | Increase/decrease system volume | 3/4/both | Vertical/Horizontal |
| Brightness Control | Increase/decrease system brightness | 3/4/both | Vertical/Horizontal |
| Pinch Gesture Actions | Description | Fingers |
|---|---|---|
| Show Desktop (*) | Hide all application (i.e. windows), pinch out | 3/4 |
| Open/Close Window | Open/Close an application, like clicking on "x" | 3/4 |
| Open/Close Tab/Document | Open/Close a tab in application that uses tabs | 3/4 |
| Show Notification List | Show GNOME notification | 3/4 |
| Application Gestures Actions (*) | Description |
|---|---|
| Forward/Backward | Go back or forward in browser tab |
| Page up/down | Scroll up/down 1 page |
| Right/Left | Switch to next or previous image in image viewer |
| Audio Next/Prev | Switch to next or previous audio |
| Tab Next/Prev | Change tabs (e.g. in browser or file manager) |
- Do a 3/4-fingers vertical swipe downward gesture on an unmaximized window but don't release the gesture
- Wait a few milliseconds
- Do a 3/4-fingers horizontal swipe gesture to tile a window to either side of the screen
- Activate a 3/4-fingers hold gesture on touchpad by pressing your fingers on touchpad but don't release the gesture
- Wait a few milliseconds
- Do a 3/4-fingers vertical/horizontal swipe gesture to activate the application gesture (an arrow animation circle will appear)
- For horizontal gestures, application gesture only works if 3/4-fingers horizontal swipe is set to Window Switching
- Application gesture also supports vertical swipe but is still experimental and requires users to turn off other actions for 3/4-fingers vertical swipe (i.e. set the action to None).
- Enabling minimizing window gesture for Window Manipulation will disable snapping/tiling gesture.
- If you are using an older version of GNOME, there might be a bug which prevent the extension from detecting hold and swipe gesture and pinch gesture. If you face this problem, the gesture can only work if the mouse pointer is pointed at the desktop or top panel.
- To switch to windows from all workspaces using 3-fingers swipes, run
gsettings set org.gnome.shell.window-switcher current-workspace-only false
Massive thanks to the original author and everyone who has contributed to the original project to bring us this wonderful GNOME extension.
gnome-gesture-improvements - Original GNOME Gesture Improvement
Screen Brightness Governor - brightness control code.
Volume Scroller - volume control code.
