LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

edgepad

Wayland touchpad edge gestures, driven by a user daemon

TLDR

List touchpad devices
$ edgepad devices
copy
Show whether the daemon has the pad
$ edgepad status
copy
Check the setup
$ edgepad doctor
copy
Run the daemon in the foreground
$ edgepad daemon
copy
Reload the user service after a config edit
$ systemctl --user reload edgepad.service
copy
Follow this boot's logs
$ journalctl --user -u edgepad.service -b
copy

SYNOPSIS

edgepad command [options]

DESCRIPTION

edgepad turns the edges of a laptop touchpad into gesture zones on Linux with Wayland. Swipes that start in a left, right, top, or bottom zone fire a command when the finger lifts. Sliders repeat a command while the finger moves. The daemon grabs the pad, so the edges you bind are no longer normal pointer input, and unbound edges still move the pointer.A normal install runs edgepad daemon as the user unit edgepad.service. systemctl --user stop edgepad.service releases the pad. systemctl --user reload edgepad.service reloads config after fingers lift.

CONFIGURATION

~/.config/edgepad/edgepad.toml

Default config file. If the XDG config home variable is set, the file is edgepad/edgepad.toml under that directory. --config selects another file for one run. The release installer records the resolved path in the user unit. Change that variable and run the installer again so the unit follows the new path.
Zones are left, right, top, and bottom. Directions are up, down, left, right, tap, and double-tap. Each zone and direction pair has one binding. A gesture runs its command when the finger lifts. Sliders on the left and right edges use up and down; top and bottom edges use left and right.

COMMANDS

devices [--all] [--input-root DIR]

List touchpad candidates under the input root (default /dev/input). --root is the same option. --all lists every readable event device.
status [--config FILE] [--device NODE] [--service UNIT]
Print whether the configured device is grabbed and whether the user service is active. --device is auto or an event node. --service defaults to edgepad.service. --input-root defaults to /dev/input.
doctor [--uinput PATH]
Run the same checks as status, and also check that uinput exists. --uinput defaults to /dev/uinput.
daemon [--config FILE] [--input-root DIR]
Grab the touchpad and emit gestures. SIGHUP reloads the config after active contacts lift. The user service runs this command.
dump --device NODE --out FILE
Record a capture. --device and --out are required. --frames N stops after at least N frame boundaries, once the pad is idle. --raw keeps the raw stream. Stop edgepad.service first when the daemon already owns the pad. The physical device must not be grabbed during the capture.
proxy --frames N (--dry-run | --uinput)
Replay recognition for N frames (N is a positive integer). Choose --dry-run (no output devices) or --uinput (creates a virtual device). --uinput requires --grab. --grab requires --uinput. --dry-run cannot be combined with --grab. Optional: --device, --input-root, --edge-width WIDTH, and the recognition options printed by edgepad proxy --help.
replay FILE
Replay a capture file through the recognizer.
replay-raw FILE
Replay a raw capture. Both replay commands accept the same recognition options as proxy.

CAVEATS

Linux and Wayland only. A command is required; there is no default subcommand. dump fails to see the real events while the daemon holds the device. proxy --dry-run does not grab and does not create a virtual device. proxy --uinput grabs the pad for the length of the run.

HISTORY

edgepad is published by assembledev. It is written in Rust and licensed under MIT or Apache-2.0, at your option.

SEE ALSO

libinput(1), evtest(1), wev(1)

RESOURCES

Copied to clipboard
Kai