Midilute

Midilute is a command-line application that turns midi input into keystrokes that causes the lute in Mordhau to be played.

Not for Windows

I wrote this program for myself, but decided to publish it. I play Mordhau on Linux via software made by Valve called Proton. Because of this the program I wrote unfortunately only works on Linux.

It uses Guile, ALSA, and xdotool.

• Guile runs on Windows via Cygwin or MinGW, but
• ALSA only runs on Linux.
• xdotool is available on many *nix platforms.

If you want something like this for Windows:

I know that the creator of Lutebot is working on a new version that has midi device support. There is also another project that seems to support this feature.

How to build the program

You need Guile, ALSA, a C++ compiler, and CMake to compile the midi component of this program. Some OS's like Ubuntu put development components into special packages like guile-2.2-dev and asoundlib2-dev.

Assuming you've got everything you need installed, you should be able to follow these instructions:

Clone the project:

$ git clone https://github.com/dextercd/Midilute.git
$ cd Midilute

Create the build directory and build the midi component with CMake:

$ mkdir build
$ cd build
$ cmake ..
$ cmake --build .

As long as no errors occurred you should now have a file named libguilemidi.so in the build directory.

Now you should be able to use the program.

How to use the program

You'll need to build the C++ files with CMake. Let's assume the resulting libguilemidi.so file is in a directory called build/.

Now you should be able to run this command.

$ LTDL_LIBRARY_PATH=build/ guile main.scm

This will launch Midilute, but playing your midi device will not yet do anything. You'll need to connect your midi device with the program using aconnect.

# Show all midi input and output devices
$ aconnect -l
client 0: 'System' [type=kernel]
    0 'Timer           '
    1 'Announce        '
client 14: 'Midi Through' [type=kernel]
    0 'Midi Through Port-0'
client 28: 'Digital Piano' [type=kernel,card=3]
    0 'Digital Piano MIDI 1'
client 128: 'Mordhau input' [type=user,pid=19573]
    0 'Mordhau input   '

# Digital piano is my midi device, Mordhau input is the virtual device that we
# want to connect to.

$ aconnect 28:0 128:0

# Now when you press a key on your midi device that is in Mordhau's lute range
# it should automatically type something like `equipmentcommand 16.

Now you should be able to play the Lute with your midi device!