Add a README

This commit is contained in:
Neale Pickett 2014-03-11 19:08:34 +00:00
parent 6081e88a4c
commit dccb830fc3
1 changed files with 59 additions and 0 deletions

59
README Normal file
View File

@ -0,0 +1,59 @@
Hercules DJ Controller Driver
=============================
This is a userspace driver for some Hercules DJ controllers.
Originally this was a part of Mixxx,
but in order to issue more timely updates
(not bound to the Mixxx release schedule),
it is now a standalone project.
That means you can use it with any version of Mixxx,
without needing to recompile anything other than this driver.
Since it runs in userspace,
you don't need to keep modifying your kernel to keep it working.
And if the driver crashes,
the rest of your system keeps running.
But please tell me if it crashes!
Supported Controllers
---------------------
* MP3e2
* Steel
How To Run
----------
Also make sure your user can read and write to raw USB devices.
See [this Mixxx wiki page](http://mixxx.org/wiki/doku.php/hercules_dj_control_mp3_e2#usb_hid) for how to do this with udev-based systems (almost every Linux distribution).
Currently, the driver must be started after you plug in a device.
Just run `hdjd` and it will tell you what it found.
Current Issues
--------------
The driver is pretty crappy right now.
If you email me, I'm a lot more likely to fix things.
Even if you just say "hi, I'm using your Hercules driver".
* Driver must be launched after
Thanks
------
Thanks to Guillemot (makers of the Hercules controllers) for sending me
a whole bunch of controllers so I could make a better driver.
Thanks to the Mixxx project for connecting me with Guillemot,
and for providing something interesting to use this driver ;-)
Contact Me
----------
Neale Pickett <neale@woozle.org>