Skip to content

Managing Gesture Properties with gesture_prop

The gesture_prop command in the ChromeOS Shell is used to view and configure gesture-related properties for attached input devices. This tool is ideal for customizing and troubleshooting gestures on ChromeOS.

Usage

gesture_prop <command> [options]

Commands

  • devices or devs: List all devices managed by the gestures library, along with their numeric IDs.
  • list <device ID>: Display all properties for the specified device.
  • get <device ID> <property name>: Retrieve the current value of a specific property for the device.
  • set <device ID> <property name> <value>: Update a specific property for the device.

Examples

1. List Available Devices

gesture_prop devices

This command outputs a list of all input devices managed by the gestures library, including their numeric IDs.

2. View Properties of a Device

gesture_prop list 12

This displays all configurable gesture properties for the device with ID 12.

3. Get the Value of a Specific Property

gesture_prop get 12 "Mouse CPI"

This retrieves the current value of the "Mouse CPI" property for the device with ID 12.

4. Set a Property Value

gesture_prop set 12 "Mouse CPI" array:double:500

This sets the "Mouse CPI" property for the device with ID 12 to 500. Values should follow the syntax used by dbus-send.

Additional Information

  • Device Requirements: The device must be supported by the gestures library, and the "Enable gesture properties D-Bus service" flag must be enabled for this command to function.
  • Property Syntax: Values can be arrays or strings and should adhere to the dbus-send syntax.
  • Documentation: For more details, see the gesture properties documentation.

Best Practices

  1. List Devices First

  2. Always start by listing devices with gesture_prop devices to ensure the target device is supported.

  3. Validate Property Changes

  4. After setting a property, test the gesture functionality to ensure the desired effect.

  5. Use Clear Values

  6. Ensure that values entered for properties are accurate and within acceptable ranges to avoid unintended behavior.

The gesture_prop command is a powerful tool for customizing input gestures, enabling users to optimize their ChromeOS experience.