Skip to content

Commit

Permalink
Updated documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
ejj28 committed Mar 3, 2020
1 parent edca1f0 commit 9497415
Show file tree
Hide file tree
Showing 3 changed files with 31 additions and 7 deletions.
17 changes: 14 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,18 @@
A bridge between E-Kits and Clone Hero

## Usage
- [Download and install vJoy](https://github.com/jshafer817/vJoy/releases)

### Installation
- [Download and install vJoy for Windows 10 Only](https://github.com/jshafer817/vJoy/releases)
- [Download and install vJoy for other Windows versions](https://github.com/shauleiz/vJoy/releases)
- [Download MidiDrumHero](https://github.com/ejj28/mididrumhero/releases/download/v1.0.0/mididrumhero_win64_v1.0.0.zip) and extract
- Open **mididrumhero.exe** and follow the instructions, entering the MIDI ID of your drum kit and hitting the drum pads you'd like to use when prompted
- In Clone Hero, set your mappings for the vJoy controller in the controls menu

### Configuring
- Use **monitor.exe** to find the Midi note values of the drum pads you would like to map
- Use **configure.exe** to add your pads. Upon first run you may get a warning about a config file not existing; this is fine, a new one will be created. For each pad, enter the proper Midi note number, the button number you would like to map the pad to, and the velocity at which you would like to set the hit threshold at. A good default value is 10; if your drums are sensitive and are registering erroneous hits, adjust the sesitivity as needed.
- When done adding/removing mappings, press the Save button

### Running
- Open **mididrumhero.exe**
- A list of detected Midi input devices will be shown; enter the number on the left of the device you would like to use
- MidiDrumHero will now convert your E-kit's Midi signals to gamepad button presses
17 changes: 14 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,20 @@
A bridge between E-Kits and Clone Hero

## Usage
- [Download and install vJoy](https://github.com/jshafer817/vJoy/releases)

### Installation
- [Download and install vJoy for Windows 10 Only](https://github.com/jshafer817/vJoy/releases)
- [Download and install vJoy for other Windows versions](https://github.com/shauleiz/vJoy/releases)
- [Download MidiDrumHero](https://github.com/ejj28/mididrumhero/releases/download/v1.0.0/mididrumhero_win64_v1.0.0.zip) and extract
- Open **mididrumhero.exe** and follow the instructions, entering the MIDI ID of your drum kit and hitting the drum pads you'd like to use when prompted
- In Clone Hero, set your mappings for the vJoy controller in the controls menu

### Configuring
- Use **monitor.exe** to find the Midi note values of the drum pads you would like to map
- Use **configure.exe** to add your pads. Upon first run you may get a warning about a config file not existing; this is fine, a new one will be created. For each pad, enter the proper Midi note number, the button number you would like to map the pad to, and the velocity at which you would like to set the hit threshold at. A good default value is 10; if your drums are sensitive and are registering erroneous hits, adjust the sesitivity as needed.
- When done adding/removing mappings, press the Save button

### Running
- Open **mididrumhero.exe**
- A list of detected Midi input devices will be shown; enter the number on the left of the device you would like to use
- MidiDrumHero will now convert your E-kit's Midi signals to gamepad button presses

#### Need help? Ping me (ejj28) on the Clone Hero Discord server
4 changes: 3 additions & 1 deletion mididrumhero.py
Original file line number Diff line number Diff line change
Expand Up @@ -71,9 +71,11 @@ def millis():
midi_events = i.read(10)

for x in midi_events:
if x[0][0] != 248 and x[0][2] != 0:
if x[0][2] != 0:
for b in range(len(configData)):

if x[0][1] == configData[b]["midi"] and x[0][2] > configData[b]["velocity"] and states[b] == False:

vController.set_button(configData[b]["button"], 1)
lastHitTime[b] = millis()
states[b] = True
Expand Down

0 comments on commit 9497415

Please sign in to comment.