Python project for complete support of Logitech's G19 keyboard
Branch: master
Clone or download
Pull request Compare This branch is 6 commits ahead of sblatt:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

G19 Drivers for linux (Debian/Ubuntu based) systems.

This is a stable* version of the drivers for a G19 keyboard on linux (Debian/Ubuntu based).

* Stable in the sense that I have not been able to crash it or anything from normal use. This will also not break anything else on your computer.

Features of the system:

  • change backlit keys color
  • applets that use the display
  • change display brightness
  • installer
  • startup with system startup

Not working (correctly):

  • map G-keys

This code was based on sblatt his repository:


  • Google Calendar: view upcoming events of the display
  • Clock: see the date en time
  • Timer: have a timer that counts down (doesn't make sound yet)
  • Display Brightness: change the brightness of the display
  • Background light: change the key lights color
  • Slideshow: display pictures.
  • XPlanet: Show a spinning earth
  • Sample Applet: sample code for making your own applet
  • Exit: shut down keyboard drivers (may reset media keys)


screenshot screenshot

How to install:

  • make sure you have python installed
    • $ python --version
    • Python 2.7.x (might work with other versions, I'm running 2.7.6)
  • browse to install folder (contains src and service folder)
  • open terminal
$ sudo ./
  • type the username that you currently use
  • ...installing...
  • your keyboard should not light up and work. :D

Addition steps:

  • for calendar install additional packages:
$ pip install pyRFC3339
$ pip install pytz
$ pip install tzlocal
$ pip install --upgrade google-api-python-client
sudo apt-get install xplanet xplanet-images

Known problems: Calendar

  • No known problems
  • Add 'all' calendar option.

Display Brightness

  • Can not capture volume keys

Background light

  • Can not capture volume keys


  • Can use improvements in saving set time

If all breaks you need to shut down the app called in system manager (need root to do this) This will do the job (at least if you have no other apps that are called this way):

sudo pkill