G203CTL(1)

NAME ¶

g203ctl - tool to change the LED effects on a Logitech G203

SYNOPSIS ¶

g203ctl [-l] [-v] command [arguments]

DESCRIPTION ¶

g203ctl is a tool to change the LED effects and the DPI setting on a Logitech G203.

The options are as follows:

-l

When supplied, this executes the command for the LIGHTSYNC version of the mouse. Otherwise, a G203 Prodigy is assumed.

-v

Print the version information and exit

For the following commands, this is how arguments are supplied. Colors need to be supplied as a hexadecimal string without a prefix. A direction is either left or right. The rate is supplied in milliseconds between 1000 and 65535. The brightness is a percentage between 1 and 100.

The following commands are available:

blend rate brightness

Activates the "blend" animation. This is only available on the G203 LIGHTSYNC.

breathe color rate brightness

Activates single color breathing.

cycle rate brightness

Cycles through all colors.

dpi dpi

Sets the DPI. For the G203 Prodigy, the lower limit is 200. For the G203 LIGHTSYNC, the lower limit is 50. The upper limit is 8000 for both.

intro on|off

Hey there. It's the author of this software here. I have no clue what this is doing. I'm sorry. Do you know it? Tell me about it :)

solid color

Sets a single static color.

triple left middle right

Sets different static colors for the left, middle and right led in the mouse. This is only available on the G203 LIGHTSYNC.

wave rate brightness direction

Cycles through all colors either from left to right or from right to left. This is only available on the G203 LIGHTSYNC.

EXAMPLES ¶

To set the DPI of a Prodigy mouse to 2000, use:

g203ctl dpi 2000

To switch off the LEDs on a LIGHTSYNC mouse, use:

g203ctl -l solid 000000

To activate the "breathe" animation with the color eeaa00, a brightness of 69% and a cycle time of 2500 milliseconds on a LIGHTSYNC mouse, use:

g203ctl -l breathe eeaa00 2500 69

To activate the "wave" animation flowing from right to left with a cycle time of 16000 milliseconds and a brightness of 49% on a LIGHTSYNC mouse, use:

g203ctl -l wave 16000 49 left

EXIT STATUS ¶

g203ctl exits with a value >0 in case of an error. Otherwise, the exit status is 0.

AUTHORS ¶

Created and maintained by Hannes Braun <hannes@hannesbraun.net>. Up-to-date sources can be found at https://git.sr.ht/~hannes/g203ctl. Bugs and patches can be submitted by email to ~hannes/public-inbox@lists.sr.ht.