{"id":22757544,"url":"https://github.com/gitanat/hdjd","last_synced_at":"2025-08-18T07:12:34.869Z","repository":{"id":15962237,"uuid":"18704874","full_name":"gitanat/hdjd","owner":"gitanat","description":"A Linux userspace driver for some Hercules DJ controllers. THIS REPOSITORY IS A FORK. Original at http://woozle.org/neale/g.cgi/hdjd","archived":false,"fork":false,"pushed_at":"2014-04-12T14:51:47.000Z","size":168,"stargazers_count":2,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-18T13:07:26.754Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitanat.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-04-12T13:39:43.000Z","updated_at":"2019-01-25T10:04:27.000Z","dependencies_parsed_at":"2022-09-24T06:10:13.913Z","dependency_job_id":null,"html_url":"https://github.com/gitanat/hdjd","commit_stats":null,"previous_names":["gitanat/hdjd"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gitanat/hdjd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitanat%2Fhdjd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitanat%2Fhdjd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitanat%2Fhdjd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitanat%2Fhdjd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitanat","download_url":"https://codeload.github.com/gitanat/hdjd/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitanat%2Fhdjd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270957544,"owners_count":24675175,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-18T02:00:08.743Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-11T07:18:51.116Z","updated_at":"2025-08-18T07:12:34.842Z","avatar_url":"https://github.com/gitanat.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"Hercules DJ Controller Driver for Linux\n=============================\n\nThis is a Linux userspace driver for some Hercules DJ controllers.\n\nOriginally this was a part of Mixxx,\nbut in order to issue more timely updates\n(not bound to the Mixxx release schedule),\nit is now a standalone project.\nThat means you can use it with any version of Mixxx,\nwithout needing to recompile anything other than this driver.\n\nSince it runs in userspace,\nyou don't need to keep modifying your kernel to keep it working.\nAnd if the driver crashes,\nthe rest of your system keeps running.\nBut please tell me if it crashes!\n\n\nSupported Controllers\n---------------------\n\nThe driver currently supports:\n\n* Hercules DJ Control MP3 e2\n* Hercules DJ Control Steel\n\nSupport is planned for:\n\n* Hercules DJ 4Set\n* Hercules Console Mk4 (if I can find one cheap enough)\n\nThings I won't support:\n\n* Hercules Console Mk2 (already works with HID code in Mixxx)\n* Hercules RMX (already works with HID code in Mixxx)\n* Hercules DJ Control Instinct (already works with Midi code in Mixxx,\n  although I *will* be contributing a mapping for it)\n\n\nIf you have a Hercules device that doesn't \"just work\" with Mixxx,\nsend me an email, there's a good chance I can support it with this driver.\n\nHow To Compile\n--------------\n\n    sudo apt-get install libasound2-dev libusb-1.0-0-dev libfaad-dev libmp4v2-dev\n    make\n\n\nHow To Run\n----------\n\nAlso make sure your user can read and write to raw USB devices.\n\nThe following are instructions for udev-based systems (almost every Linux distribution).\n\n  - Create the file `/etc/udev/rules.d/hercules-usb.rules` with the following content:\n\n    `SUBSYSTEM==\"usb_device\", SYSFS{idVendor}==\"06f8\", MODE=\"0666\"\n    SUBSYSTEM==\"usb\", ATTRS{idVendor}==\"06f8\", MODE=\"0666\"`\n\n  - Restart udev: \n\n    `sudo /etc/init.d/udev restart`\n\nSee [this Mixxx wiki page](http://mixxx.org/wiki/doku.php/hercules_dj_control_mp3_e2#usb_hid) for more information.\n\nCurrently, the driver must be started **after** you plug in a device.\nJust run `./hdjd` and it will tell you what it found.\n\n\nCurrent Issues\n--------------\n\nThe driver is pretty crappy right now.\nIf you email me, I'm a lot more likely to fix things.\nEven if you just say \"hi, I'm using your Hercules driver\".\n\n* Driver must be launched after device is plugged in\n* It locks up and crashes sometimes\n\nIf you find a problem, please, please, pretty-please,\nemail me \u003cneale@woozle.org\u003e.\nPosting on the Mixxx Community Forums is fine too,\nmaybe someone there can help you,\nbut I don't check the forums very often.\nSorry.\n\n\nThanks\n------\n\nThanks to Guillemot (makers of the Hercules controllers) for sending me\na whole bunch of controllers so I could make a better driver.\n\nThanks to the Mixxx project for connecting me with Guillemot,\nand for providing something interesting to use this driver ;-)\n\nContact Me\n----------\n\nNeale Pickett \u003cneale@woozle.org\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitanat%2Fhdjd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitanat%2Fhdjd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitanat%2Fhdjd/lists"}