ledcontroller-3bit/README.md
Jens True 1a93b07f73
All checks were successful
continuous-integration/drone/push Build is passing
Corrected install docs
2021-12-09 12:43:08 +00:00

53 lines
1.7 KiB
Markdown

[![Build Status](https://build.jcktrue.dk/api/badges/jct/ledcontroller-3bit/status.svg)](https://build.jcktrue.dk/jct/ledcontroller-3bit)
# 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.
### Get and compile: ###
$ git clone https://github.com/andmarios/ledcontroller-3bit.git
$ sudo apt-get install libusb-1.0-0-dev build-essential pkg-config
$ 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
### Have fun ###
## Requisites: ##
+ libusb:1, libusb-1.0-dev or libusb-1.0-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 (files `main.c` and `Makefile`) is a fork of the ledcontroller code by jmrobles (<http://robleshermoso.wordpress.com>).
My contribution to this code is very small and probably I could never write this on my own.
I added support for all the 7 colors of the notifier as the original code only supported the
3 basic colors. Also I hopefully fixed an issue with a warning output at the kernel's log.
The code is distributed under the terms of the GNU General Public License v3. You can find more
information and the original license inside `main.c`.