ledcontroller-3bit/README.md

# ledcontroller-3bit #

A Linux command line utility to control usb mail notifiers identified as:

    $ lsusb
    Bus 001 Device 010: ID 1294:1320 RISO KAGAKU CORP.


Inside the scripts folder you will find some simple bash scripts you can use to control the notifier.
For example the script `mled-cputemp` will make it respond to your CPU's temperature.

### Get and compile:

    $ git clone https://github.com/andmarios/ledcontroller-3bit.git
    $ cd ledcontroller-3bit/
    $ make

### Run:

    $ ./ledcontroller blue | red | green | aqua | purple | yellow | white |  off

### Install permanently:

    $ sudo install -m root -g root -m 755 ledcontroller /usr/bin/ledcontroller

### Uninstall:

    $ sudo rm /usr/bin/ledcontroller

## Requisites:

+ libusb:1 or libusb-1.0-dev, depending on your distribution
+ a system which can compile binaries (package build-essentials for Debian based distributions)

## Hardware: 

I think [this is my notifier](http://www.andmarios.com/links/mail-usb-notifier) but I can't be
sure as I bought it a couple of years ago from eBay.

---

## Copyright

This code is a fork of the ledcontroller code by jmrobles <http://robleshermoso.wordpress.com>.

My contribution to the code was trivial. I added support for all the 7 colors of the notifier
as the original code only supported the 3 basic colors.

As jmrobles' website is in Spanish, his code on dropbox and I had a difficult time finding
it, I uploaded it to GitHub.

The code is distributed under the terms of the GNU General Public License v3. You can find more information inside `main.c`.
initial commit 2013-02-18 23:21:48 +00:00			`# ledcontroller-3bit #`

			`A Linux command line utility to control usb mail notifiers identified as:`

			`$ lsusb`
			`Bus 001 Device 010: ID 1294:1320 RISO KAGAKU CORP.`

added piece for scripts folder 2013-02-21 01:28:25 +00:00
			`Inside the scripts folder you will find some simple bash scripts you can use to control the notifier.`
			For example the script `mled-cputemp` will make it respond to your CPU's temperature.

initial commit 2013-02-18 23:21:48 +00:00			`### Get and compile:`

			`$ git clone https://github.com/andmarios/ledcontroller-3bit.git`
			`$ cd ledcontroller-3bit/`
			`$ make`

			`### Run:`

			`$ ./ledcontroller blue \| red \| green \| aqua \| purple \| yellow \| white \| off`

			`### Install permanently:`

			`$ sudo install -m root -g root -m 755 ledcontroller /usr/bin/ledcontroller`

			`### Uninstall:`

			`$ sudo rm /usr/bin/ledcontroller`

			`## Requisites:`

			`+ libusb:1 or libusb-1.0-dev, depending on your distribution`
			`+ a system which can compile binaries (package build-essentials for Debian based distributions)`

fixed missing "it" 2013-02-18 23:38:39 +00:00			`## Hardware:`
added link to the device 2013-02-18 23:29:04 +00:00
fixed missing "it" 2013-02-18 23:38:39 +00:00			`I think [this is my notifier](http://www.andmarios.com/links/mail-usb-notifier) but I can't be`
			`sure as I bought it a couple of years ago from eBay.`
added link to the device 2013-02-18 23:29:04 +00:00
initial commit 2013-02-18 23:21:48 +00:00			`---`

			`## Copyright`

			`This code is a fork of the ledcontroller code by jmrobles <http://robleshermoso.wordpress.com>.`

			`My contribution to the code was trivial. I added support for all the 7 colors of the notifier`
			`as the original code only supported the 3 basic colors.`

			`As jmrobles' website is in Spanish, his code on dropbox and I had a difficult time finding`
			`it, I uploaded it to GitHub.`

missing full stop (OCD mode) 2013-02-18 23:32:14 +00:00			The code is distributed under the terms of the GNU General Public License v3. You can find more information inside `main.c`.