1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222
|
.TH RATBAGCTL "1" "@version@"
.SH NAME
ratbagctl \- inspect and modify configurable mice
.SH SYNOPSIS
.B ratbagctl
.RI [< options >]
.B list
.br
.B ratbagctl
.RI [< options >]
.RI < device "> <" command "> ..."
.SH DESCRIPTION
.PP
The
.B ratbagctl
tool queries or changes a device's settings.
.PP
This tool usually needs ratbagd to be running.
.SH OPTIONS
.TP 8
.B \-\-version, \-V
Show program's version number and exit.
.TP 8
.B \-\-verbose, \-v
Print debugging output. Multiple -v options increase the verbosity. For example,
.B \-vvv
will show the protocol output.
.TP 8
.B \-\-nocommit
Do not immediately write the settings to the mouse. This allows
multiple parameters to be set in a script, and the last call to
.B ratbagctl
will write them all.
.TP 8
.B \-\-help, \-h
Print the help.
.SH General Commands
.TP 8
.B list
List supported devices (does not take a device argument)
.SH Device Commands
.TP 8
.B info
Print information about a device
.TP 8
.B name
Print the device name
.SH Profile Commands
.TP 8
.B profile active get
Print the currently active profile
.TP 8
.B profile active set N
Set profile N as to the active profile
.TP 8
.B profile N {COMMAND}
Use profile N for COMMAND
.PP
.B Available COMMANDs:
.RS
.TP 8
.B get
Print selected profile information
.TP 8
.B name get
Print the name of the profile
.TP 8
.B name set blah
Set the name of the profile
.TP 8
.B enable
Enable a profile
.TP 8
.B disable
Disable a profile
.TP 8
.B [resolution|dpi|rate|button|led] ...
Use profile N for the specified command.
.RE
.SH Resolution Commands
Resolution commands work on the given profile, or on the active profile if none
is given.
.TP 8
.B resolution active get
Print the currently active resolution
.TP 8
.B resolution active set N
Set resolution N as the active resolution
.TP 8
.B resolution default get
Print the current default resolution
.TP 8
.B resolution default set N
Set resolution N as the default resolution
.TP 8
.B resolution N {COMMAND}
Use resolution N for COMMAND
.PP
.B Available COMMANDs:
.RS
.TP 8
.B get
Print selected resolution
.TP 8
.B [dpi|rate] ...
Use resolution N for the specified command.
.RE
.SH DPI Commands
DPI commands work on the given profile and resolution, or on the active
resolution of the active profile if none are given.
.TP 8
.B dpi get
Print the dpi value
.TP 8
.B dpi get-all
Print the supported dpi values
.TP 8
.B dpi set N
Set the dpi value to N
.SH Rate Commands
Rate commands work on the given profile and resolution, or on the active
resolution of the active profile if none are given.
.TP 8
.B rate get
Print the report rate in ms
.TP 8
.B rate get-all
Print the supported report rates in ms
.TP 8
.B rate set N
Set the report rate in N ms
.SH Button Commands
Button commands work on the given profile, or on the active profile if none is
given.
.TP 8
.B button count
Print the number of buttons
.TP 8
.B button N get
Print the selected button
.TP 8
.B button N action get
Print the button action
.TP 8
.B button N action set button B
Set the button action to button B
.TP 8
.B button N action set special S
Set the button action to special action S
.TP 8
.B button N action set macro ...
Set the button action to the given macro
.PP
.B Macro syntax:
.HP 8
A macro is a series of key events or waiting periods. Keys must be specified
in linux/input-event-codes.h key names.
.RS
.TP 8
.B KEY_A
Press and release 'a'
.TP 8
.B +KEY_A
Press 'a'
.TP 8
.B \-KEY_A
Release 'a'
.TP 8
.B t300
Wait 300ms
.RE
.SH LED Commands
LED commands work on the given profile, or on the active profile if none is
given.
.TP 8
.B led get
Print the current led values
.TP 8
.B led N get
Print the selected LED value
.TP 8
.B led N {COMMAND}
Use led N for COMMAND
.PP
.B Available COMMANDs:
.RS
.TP 8
.B mode [on|off|cycle|breathing]
The mode to set as current
.TP 8
.B color RRGGBB
The color to set as current (the color should be in the hexadecimal format).
.TP 8
.B rate R
The rate to set as current
.TP 8
.B brightness B
The brightness to set as current
.RE
.SH Examples
.TP 8
ratbagctl profile active get eventX
.TP 8
ratbagctl profile 0 resolution active set 4 eventX
.TP 8
ratbagctl profile 0 resolution 1 dpi get eventX
.TP 8
ratbagctl resolution 4 rate get eventX
.TP 8
ratbagctl dpi set 800 eventX
.SH NOTES
.PP
There is currently no guarantee that the output format of
.B ratbagctl
will not change in the future. There should be some stability with the commands
mentioned in this man page, but do not expect it to stay the same.
.SH AUTHORS
.B ratbagctl
was written by David Herrmann, Peter Hutterer and Benjamin Tissoires.
.PP
This manual page was written by Stephen Kitt <skitt@debian.org> for
the Debian GNU/Linux system (but may be used by others).
|