-
-
Notifications
You must be signed in to change notification settings - Fork 273
Configuration
Logid uses a standard libconfig-style config file stored in /etc/logid.cfg by default (although you launch logid with the -c option to change it).
For a sample config, see logid.example.cfg.
: and = are used for defining variables and are interchangeable. (e.g. name: "foo"; is the same as name = "foo";)
Devices can be blacklisted from being used in logid. To blacklist a device, create a field called blacklist as an array of the PIDs of the devices you want to blacklist.
e.g. blacklist: [0x00a7]
Workaround Note: To prevent logid from crashing with a Logitech G PRO headset, PID 0x00a7 must be blacklisted. This isssue will be fixed in a later update.
Devices are defined in an array field called devices. This array consists of objects that define a device.
e.g. devices: ( { device object }, { device object } ... );
The following are a list of fields that a device object contains.
This is a required string field that defines the name of the device. To get the name of the device, launch logid with the device connected and it should print out a message with the device name. (e.g. name: "MX Master";)
This is an optional array field that defines the mappings for buttons.
e.g. buttons: ( { button object }, { button object } ... );
This is a required integer field that defines the Control ID of the button that is being remapped. (e.g. cid: 0xc4;)
This is a required object field that defines the new action of the button. (e.g. action: { ... }; )
Refer to the actions section for more information.
This is an optional integer field that defines the DPI for a mouse that supports adjustable DPI. (e.g. dpi: 1000;)
This is an optional object field that defines the SmartShift settings for a mouse that supports it.
smartshift:
{
on: true;
threshold: 30;
default_threshold: 30;
};
This is an optional boolean field that defines whether SmartShift should be activated. (true for SmartShift, false for free-spin).
This is an optional integer field between 1-255 that defines the threshold required to change the SmartShift wheel to free-spin.
This is an optional integer field between 1-255 that defines the mouse's default threshold required to change the SmartShift wheel to free-spin.
This is an optional object field that defines the HiRes mouse-scrolling settings for a device that supports it.
hiresscroll:
{
hires: true;
invert: false;
target: false;
};
This is an optional boolean field that defines whether the mouse wheel should be high resolution or not.
This is an optional boolean field that defines whether to invert the mouse wheel.
This is an optional boolean field that defines whether mousewheel events should send as an HID++ notification or work normally (true for HID++ notification, false for normal usage).
This is a required string field that defines the type of action. (e.g. type: "None";). The following is a list of possible actions with their additional fields.
This does nothing. There are no additional fields.
This maps press and release events of a button to a list of keys/buttons.
This is a required string array field that defines the keys to be pressed/released. For a list of key/button strings, refer to linux/input-event-codes.h. (e.g. keys: ["KEY_A", "KEY_B"];)
This action disables mouse movement while the button is pressed and allows you to assign actions for each direction. The possible directions are Up, Down, Left, Right, and None.
Note that any button can be used as a gesture button if the device supports gestures.
This is a required array of gesture objects that map a direction to a gesture mode and an action.
e.g. gestures: ( { gesture object }, { gesture object } ... );
This is a required string field in a gesture object that defines the direction of the gesture. (e.g. direction: "Up")
This is an optional string field that defines the mode of the gesture. This field defaults to OnRelease if it is omitted.
The following is a list of gesture modes:
This mode does nothing. The action field is ignored when this mode is used.
This mode presses and releases an action when the gesture button is released
This mode presses and releases an action after the mouse is moved every n pixels (where n is the integer field pixels).
This mode maps a gesture movement to an axis. The axis is defined as a string (e.g. "REL_WHEEL") in the axis field and the multiplier for its movement is defined in the axis_multiplier field. For a list of axis strings, refer to linux/input-event-codes.h.
This is a mandatory field that defines the action the gesture uses. This can be any action other than Gestures. Refer to the entire Actions section for more details.
This action toggles the SmartShift scrolling feature when pressed. There are no additional fields.
This action toggles high resolution scrolling when pressed. There are no additional fields.
This action cycles between the given DPIs.
This is a mandatory integer array field that defines what DPIs to cycle through. (e.g. dpis: [800, 1000, 1200];)
This action increments the DPI by the value given in the inc field.
This is an integer array field that defines what to increase the DPI by.