Skip to content

A Python script to change the key colors on a Logitech G213 Prodigy Gaming Keyboard and G203 Prodigy Gaming Mouse

License

Notifications You must be signed in to change notification settings

dereisele/G213Colors

 
 

Repository files navigation

G213Colors

A application to change the key colors on a Logitech G213 Prodigy Gaming Keyboard using SebiTimeWaster's G213Colors.

Supported devices

  • G213 keyboard
  • G203 mouse

Screenshots

g213-colors-static g213-colors-cycle g213-colors-breathe g213-colors-segments

What it does

G213Colors lets you set the color(s) and certain effects of the illuminated keys on a G213 keyboard and G203 mouse under Linux.

Since Logitech is mostly ignoring the Linux market with their "Logitech Gaming Software" but i also wanted to use my expensive new keyboard also under linux without tolerating the color cycling animation all the time. So i searched on the internet and added a gui to SebiTimeWaster's project for comfortable usage.

G213Colors was built and tested under Linux for the G213 keyboard and G203 mouse specifically, but after some adaptation it could potentially be run under other OS'es and used for other Logitech devices as well.

If you have any Logitech keyboard or mouse that is not supported feel free to open an issue and/or contact me via Email: git(AT)eiselecloud(DOT)de

The "Wave" color effect that is available with the Logitech software could not be replicated since it is completely generated in the software by updating the colors every x ms (In contrast to the other effects which run on the keyboard itself). You could generate this effect with a script, but since G213Colors has to detach the kernel driver from one of the G213's interfaces to send data out the multimedia keys would most likely stop working. Unfortunately this is a side effect of the linux driver structure.

Installation

Clone this project with git and run sudo make install

Prerequisites

  • Python 3.x (which is usually already installed)
  • PyUSB (please see their instructions on how to install)
  • PyGObject

Please ignore the pcap directory, SebiTimeWaster added the pcap files he used for reverse engineering just in case someone wants to work with them. They can be opened with Wireshark.

Usage

Automatic

You can find the app in your menu after installation.

Manually

You can call the main.py script like this:

python main.py

G213Colors needs to be run as root as long as long as your user doesn't have access privileges for the USB device. In order to run the program without root privileges you have to create a udev rule for your device and add your user to the plugdev group. See how this is done on stackexchange. idVendor is 046d for Logitech. idProduct depends on your device. Use lsusb | grep Logitech to determine the Id.

Restoring previous state

After rebooting your pc you can restore the pre-reboot state by running the app with parameter -t

sudo g213colors-gui -t

You can also do this automatically at reboot by enabling the systemd service.

sudo systemctl enable g213colors.service

Known issues

ToDo

Changelog

Changelog v0.1:

  • Initial checkin

Changelog v0.2:

  • Added segments/field support
  • removed color button events

Changelog v0.3:

  • Added more intergration with linux systems (by JeroenED)

Changelog v0.4:

  • Added support for G203 mouse

Changelog v0.5:

  • Finally fixed incontrollable segments bug (with the help of Oncecreated)

About

A Python script to change the key colors on a Logitech G213 Prodigy Gaming Keyboard and G203 Prodigy Gaming Mouse

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 88.3%
  • Makefile 11.7%