From 435e46373f4388a5e6ec88c320366469aad284a8 Mon Sep 17 00:00:00 2001 From: Rico Tiongson Date: Sat, 18 Apr 2020 02:20:18 +0800 Subject: [PATCH] Update README and defaults.conf --- CHANGELOG | 4 +++ README.md | 92 ++++++++++++++++++++++++++++++++++++++++----------- defaults.conf | 49 +++++++++++++-------------- 3 files changed, 99 insertions(+), 46 deletions(-) create mode 100644 CHANGELOG diff --git a/CHANGELOG b/CHANGELOG new file mode 100644 index 0000000..1091d98 --- /dev/null +++ b/CHANGELOG @@ -0,0 +1,4 @@ +v1.1.0 +* Added mouse hold gestures +* Added `hold3` configuration +* Added `hold4` configuration diff --git a/README.md b/README.md index f23adec..ad69e9e 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,11 @@ [![comfortable-swipe version](https://img.shields.io/github/release/Hikari9/comfortable-swipe.svg?label=comfortable-swipe&color=orange)](https://github.com/Hikari9/comfortable-swipe/releases) [![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) +> **_New in Version 1.1.0!_** Added mouse move gestures (eg. `hold3 = button1`) + Comfortable, seamless, and fast 3-finger (and 4-finger) touchpad swipe gestures for Ubuntu 14.04 LTS and beyond. May work for other Linux distros that support `libinput`. + ## Installation 1. Install git, libinput, and g++ @@ -47,28 +50,35 @@ Comfortable, seamless, and fast 3-finger (and 4-finger) touchpad swipe gestures comfortable-swipe status ``` -## Configurations -Comfortable swipe makes use of keyboard shortcuts for configurations. Edit by running -``` -gedit $(comfortable-swipe config) -``` +## Swipe Configurations -Make sure to run after making changes: -``` -comfortable-swipe restart -``` +Comfortable swipe makes use of keyboard shortcuts for configurations. -Property | Description | Default Value | Default Behavior ---------- | ----------- | -------------- | ----- -threshold | mouse pixels to activate swipe; higher = less sensitive; floating-point (Note: Sky is the limit! Can be as large as 1000.0) | 0.0 -left3 | 3-finger swipe left | ctrl+alt+Right | switch to right workspace -left4 | 4-finger swipe left | ctrl+alt+shift+Right | move window to right workspace -right3 | 3-finger swipe right | ctrl+alt+Left | switch to left workspace -right4 | 4-finger swipe right | ctrl+alt+shift+Left | move window to left workspace -up3 | 3-finger swipe up | ctrl+alt+Down | switch to bottom workspace -up4 | 4-finger swipe up | ctrl+alt+shift+Down | move window to bottom workspace -down3 | 3-finger swipe down | ctrl+alt+Down | switch to above workspace -down4 | 4-finger swipe down | ctrl+alt+shift+Up | move window to above workpace +1. Edit by running + ``` + gedit $(comfortable-swipe config) + ``` + +1. List of possible configurations: + + Property | Description | Default Value | Default Behavior + --------- | :-----------: | -------------- | ----- + left3 | 3-finger swipe left | ctrl+alt+Right | switch to right workspace + left4 | 4-finger swipe left | ctrl+alt+shift+Right | move window to right workspace + right3 | 3-finger swipe right | ctrl+alt+Left | switch to left workspace + right4 | 4-finger swipe right | ctrl+alt+shift+Left | move window to left workspace + up3 | 3-finger swipe up | ctrl+alt+Down | switch to bottom workspace + up4 | 4-finger swipe up | ctrl+alt+shift+Down | move window to bottom workspace + down3 | 3-finger swipe down | ctrl+alt+Down | switch to above workspace + down4 | 4-finger swipe down | ctrl+alt+shift+Up | move window to above workpace + threshold | mouse pixels to activate swipe | 0.0 | tweak this if you're having troubles with touchpad sensitivity (higher = less sensitive, values can be as large as 1000.0) + hold3 | holds a mouse button when 3 fingers are down | (none) | See [Mouse Gestures](#mouse-configurations) + hold4 | holds a mouse button when 4 fingers are down | (none) | See [Mouse Gestures](#mouse-configurations) + +1. After making changes, make sure to restart the program: + ``` + comfortable-swipe restart + ``` Taken from `man xdotool`: @@ -86,6 +96,48 @@ Taken from `man xdotool`: Refer to https://www.linux.org/threads/xdotool-keyboard.10528/ for a complete list of keycodes you can use. +## Mouse Gestures + +> **Note**: Setting hold3 or hold4 will ignore its corresponding up/right/down/left command. + +We have included simple mouse gestures on swipe by setting `hold3` and `hold4`. + +**Possible values**: +* move - just move the mouse +* button1 - left click +* button2 - middle click +* button3 - right click +* button4 - wheel up (experimental) +* button5 - wheel down (experimental) + +## Example Configuration + +Edit with `gedit $(comfortable-swipe config)`: + +```conf +# File: comfortable-swipe.conf + +# four-finger drag +hold4 = button1 + +# show desktop +down3 = super+d + +# show workspaces +up3 = super+s + +# switch workspace +left3 = ctrl+alt+Right +right3 = ctrl+alt+Left + +# disabled because of hold4 +left4 = ctrl+alt+shift+Right +right4 = ctrl+alt+shift+Left + +# three-finger middle click (experimental) +# hold3 = button2 +``` + ## Debugging diff --git a/defaults.conf b/defaults.conf index 5100492..bf5ee7a 100644 --- a/defaults.conf +++ b/defaults.conf @@ -6,32 +6,6 @@ # Refer to https://www.linux.org/threads/xdotool-keyboard.10528/ for a list of # keycodes you can use. -############################# -# Experimental: MOUSE HOLD # -############################# - -# Uncomment to allow moving the mouse on 3/4 fingers -# hold3 = move -# hold4 = move - -# Uncomment to hold a mouse button on 3/4 fingers -# (1: left click, 2: middle click, 3: right click, 4: wheel up, 5: wheel down) -# hold3 = button1 -# hold4 = button1 - -################# -# MISCELLANEOUS # -################# - -# Threshold -# Tweak this value depending on the sensitivity of your mousepad to perform -# gestures. A higher value means less sensitive. -# -# (Note: Sky is the limit! Can be as large as 1000.0) -# -# Default: threshold = 0.0 -threshold = 0.0 - ############################# # THREE / FOUR FINGER SWIPE # ############################# @@ -75,3 +49,26 @@ down3 = ctrl+alt+Up # The default shortcut is moving current window to the above workspace. # Default: ctrl+alt+shift+Up down4 = ctrl+alt+shift+Up + +################# +# MISCELLANEOUS # +################# + +# Threshold +# Tweak this value depending on the sensitivity of your mousepad to perform +# gestures. A higher value means less sensitive (Sky is the limit! Can be as +# large as 1000.0). +# Default: threshold = 0.0 +threshold = 0.0 + +############################# +# Experimental: MOUSE HOLD # +############################# +# (1: left click, 2: middle click, 3: right click, 4: wheel up, 5: wheel down) + +# Uncomment to hold a mouse button on 3/4 fingers +# hold3 = button1 +# hold4 = button1 + +# You can also set to just "move" the mouse +# hold3 = move