HelloOMI4LOL

Welcome to you on this tutorial about how to use OMI through the game League of Legends.

Configure Sona With Midi

Ok let's learn by doing a basic example of how OMI work.

0. Download the last build of OMI

(https://openmacroinput.itch.io/openmacroinput)

• 'OMI Last build' is the last stable build push on line.
• 'JOMI' is a portable executable that OMI use to do that keybaord and mouse action on your computer.

1. The basic: Named boolean > Condition(s) > Action(s)

To use my application you will have some 'named boolean' (true or false) that will be group to form 'condition'.
Those condition will send some 'text' called 'command' that are going to be understood and transform to actions on your computer.

Example: lol + sona + backhome ♦ jomi: b↓ b↑ ⌛8500 space↓ space↑ ♦ ☗TriggerOnTrue We say to the application. If we are in league of legend and I am playing sona, when I request to go home can you type on the keyboard 'b' and focus on me by pressing space in 8 seconds.

Named boolean : lol sona backhome
Condition : lol + sona + backhome
Text/ Command: jomi: b↓ b↑ ⌛8500 space↓ space↑
Some text format: ♦ ☗TriggerOnTrue

This line in a file represent your 'intent' of doing something that the application will execute when you play. When you modifiy a file the application detect it and update itself. So you can change in the middle of the game quickly.

2. Let's listen to Midi

• You need to say to OMI that you will listen to MIDI entry in file called default.omi.xml

default.omi.xml

<omixml>
  <!-- Listen to a Midi board you can crafted with Arduino  -->
  <midiconnectionin midiName="Arduino Micro" />
  
  <!-- Listen to the MPK Mini Play (what I have) -->  
  <!-- https://www.amazon.fr/s?k=mpk+mini+play --> 
  <midiconnectionin midiName="MPK mini play" />
  
  <!-- If you want to play music while playing Sona -->
  <midiconnectionout midiName="Microsoft GS Wavetable Synth" />
  
</omixml>

Now that you can listen to Midi. You should be able to debug what you are listening to like this:


So what next ?
Push a button on the midi keyboard or a pad and observed what id or name it has.
For example here: Name is C4 and id is 48 you can use either of them. And the velocity I apply when hit is about 50%.

So you can write in a 'default.miditoboolean' file:

MPK Mini Play♦CC♦64♦0.1♦1♦Sustain♦SetTrue
MPK Mini Play♦Note♦G4♦AdditionalPowerNote♦SetTrue
MPK Mini Play♦NoteVelocity♦G4♦0♦0♦AdditionalPowerNone♦SetTrue
MPK Mini Play♦NoteVelocity♦G4♦0.0001♦0.1♦AdditionalPowerLow♦SetTrue
MPK Mini Play♦NoteVelocity♦G4♦0.1♦0.9♦AdditionalPower♦SetTrue
MPK Mini Play♦NoteVelocity♦G4♦0.9♦1♦AdditionalPowerHight♦SetTrue

If like me you play 3 differents champion, note that you can switch the macro behaviour with a midi controller like this:

default.miditoboolean

MPK Mini Play♦CC♦48♦0.0♦0.33♦ChoGath♦SetTrue
MPK Mini Play♦CC♦48♦0.33♦0.66♦Sona♦SetTrue
MPK Mini Play♦CC♦48♦0.66♦1♦Zoe♦SetTrue

or by creating a filetoboolean.
lol.filetoboolean

sona♦true
ChoGath♦false
Zoe♦false

Change to that if you want to play Zoe and then save the file

sona♦false
ChoGath♦false
Zoe♦true

3. Apply actions just in the game

You don't want when you are outside of lol to trigger accidently some macro. So we will listen to what application is focus by adding this file:

default.apptoboolean

lol♦League of Legends

//Here are some example of other games
wow♦World of Warcraft
crash♦Crash Bandicoot
aoe4♦Age of Empires IV
ftl♦FTL:
// And application
notepad♦ - Notepad
youtube♦ - YouTube 
facebook♦Facebook  

4. Almost ready for action

Now that we can listen the keyboard you need to do 'action' based on 'condition'.

---

To delete because to complexe ?

You will be able to find the Ready to use example of this tutorial here:
//Add Link.html

At the end of this tutorials, you should be able to use the tool OMI in the version of 2021 December 15 with Xbox Controller , Keyboard and Midi Piano.

The application is in development state. Sorry if it is a bit complexe at first. But the reward is huge.

To use the tool you need to understand how it works on the paper

If I have to resume the application you will use in a step by step:

1. They are files where you fill your intent of what you want to do.
2. OMI check those file to understand what you want to do (Based on standard I am creating in the application for you).
3. It listens to what you asked him to listen and overwatch them for conditions you gave it.
4. If it found a condition you asked him. it will send a text to execute.

• Example: If space and arrow is down and you are in League of Legend, go back to base and open the store after 8 seconds
• space + arrowdown ♦ macro:lol:gobacktobase ♦ ☗TriggerOnTrue in a filename.simplecondition file
• lol:gobacktobase ♦ jomi:b↓ ⌛50 b↑ ⌛8000 i↓ ⌛50 i↑ in a filename.stringtocommands file

5. The text is sent to a interpretor that will try to understand it and convert it to code to execute.

• The interpretor are code by me for the moment on what I think could be useful for the users
• In future version, interpretor will be added as official and commmunity custom one.

6. If an interpretor understnad the text it will manage the code execution and it can send back some text to others interpretor.

• For example:
  • The macro interpertor recognize macro:******** and so send: "Hey guys this macro is called:"lol:gobacktobase". Do we have one like that. As you do it will send the text in the macro jomi:b↓ ⌛50 b↑ ⌛8000 i↓ ⌛50 i↑
  • The jomi interpretor recognize: jomi:***** and send: "Hey the application Java Open Macro Input, could you simulate this to the computer:b↓ ⌛50 b↑ ⌛8000 i↓ ⌛50 i↑".
  • The Java application try to understand the text and execute it as: I press 'b' wait for 50 ms the release 'b' wait 8000ms then press i wait 50ms and release i.

7. What is the Java Open Macro Input (jomi) ? It is a small application that run on your computer that is portable and run on any platform that listen on the network for instruction of how to simulate keyboard and mouse. Meaning that you can for example use your phone to control your game (but that an other subject).