edgepad
Wayland touchpad edge gestures, driven by a user daemon
TLDR
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.
