Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
How to Create Macros
How to Create Macros
For our tutorial over here, we will create a simple macro that types out "12345" on a Diverge TM as an example.
To create a new macro, follow the steps below:
- Plug in your Animus device.
- (Optional) Plug in another keyboard.
- Launch Arbites, a new window like this should appear:
- Select "Select Device" and then select your device.
- A keyboard with the physical layout of your keyboard should appear.
- Following the How to Rebind Keys guide, rebind one of your keys to
macro0by using the Key Menu.
- The above has assigned
macro0to one of the keys on the keyboard, now we could specify what
macro0does by selecting "Edit Macros," then selecting
macro0from the list of choices.
- A new window should now pop up, in this example, we will create a macro which outputs "12345" which has 5 keys, so we will press the "Add Key" button 5 times, after pressing the button 5 times, resize the window appropriately.
- Macros run from left to right, the keys act like ordinary keys as if you are editing them on a virtual keyboard, so to change one of the keys, simply click on the key and press a key on your physical keyboard or utilise the key menu like you would with the virtual keyboard.
Once you are done adding keys to the macro, you may press "Save."
Now we may wish to save our layout (which includes the macro) by pressing "Save Layout," Afterwards, we could upload the layout by selecting the appropriate port number and pressing "Apply."
In-depth macro creation
This section contains some tips on advanced macro creation.
- The macro system in animus separates "key downs" from "key ups," and performs a "release all keys" action at the end of the macro, to toggle between a "key down" and "key up" mode, simply press the button on the lower right corner of the macro button. (see screenshot below)
- Whilst animus macros could contain 8 keys per macro, it could not perform 8 keypresses simultaneously whilst running in 6KRO mode, to utilise 8 keys, animus must be running in NKRO mode.
- Animus macros are capable of pressing other macro keys, this means you could link multiple macros together like screenshotted below: (the example below will output "1234567890")
- Whilst animus macros could link to other macros, do watch out on the dangers of the macro loop, if for example
macro0, then it will cause your device to keep loop typing non-stop, making it virtually impossible to reset the device without major pains.