1. Download and unpack the source code.
  2. You will need the pidgin-dev package installed (in Ubuntu type sudo apt-get install pidgin-dev).
  3. Open a terminal and cd to the directory, where you unpacked in step 1
  4. Run: make, then sudo make install.


You can try to type the following commands in a console window to see whether they work for you.


To turn on a led:
xset led 3 or
xset led named 'Scroll Lock'

To turn off a led:
xset -led 3
xset -led named 'Scroll Lock'

Type xset q to see possible led names.


To use this program unfortunately you have to go thru some simple steps first:
  1. Install ledcontrol (in Ubuntu type sudo apt-get install ledcontrol).
  2. Edit the config file /etc/ledcontrol.conf as root.
    Type sudo gedit /etc/ledcontrol.conf, replace gedit with your favorite editor.
    Find these lines and put in front of them a sharp (#), like this:

    # COMMAND_1="led_load"
    # SUCCESS_1="set s5 frequency 0.8 1000 1.9 100"
    # FAILURE_1="nop"
    # DELAY_1=10

    This has to be done, because the config file defaults the scroll lock to show processor usage.
  3. Edit the file /usr/share/ledcontrol/ as root.
    Type the following command on the second or third line: chgrp yourusername /var/run/ledd-pipe, like this:

    chgrp yourusername /var/run/ledd-pipe

    Replace yourusername with your real username!
    This has to be done, because you must have write permission to this file. The permission is set to 660 (rw-rw----) by default. We have to set only the group, respectively the owner.
  4. Restart.
Now you can use these commands e.g.:
ledcontrol s5 blink 900 500 - slowly blinking scroll lock led
ledcontrol s5 off - to turn off

Replace s5 with c5 for caps lock, n5 for num lock.
Type man ledd for further details.