ReaKS - Keyswitch Manager for Reaper

[Kabraxis]

Introducing
ReaKS
Last Update: v1.2 - 24/05/2024
Quick Look >

Over the last weekend, while I was pondering about how a built-in Articulation Manager for Reaper should behave, I wanted to give a shot to some ideas if they are already possible with the current API. I wasn't aiming for a Reaticulate competitor of course, but a simpler tool with simpler setup.

So I come up with a simple script that works along the Reaper's Note Naming feature in the MIDI Editor, that simply adds/removes KeySwitch notes into the MIDI item.

So just run the script, load a note names file and you're ready to go!

___

Installation:

1. Find it over the ReaPack.
2. (Requires ReaImGui)

Usage:

1. ReaKS Action will be added to MIDI Editor section of the Actions list. Just run that.
2. Click an articulation to insert KeySwitch note. Selecting target notes before inserting also works.

Tutorials:
https://www.youtube.com/watch?v=lP9h...i94QhYVcnlkhVy

Find more note names at:
https://kabraxis.itch.io/reaks

Features:

• Adding/removing KeySwitch notes into the MIDI editor over a UI
• Tracking active KeySwitch under playhead
• Visualise KeySwitches on Arrange View (over Text Events)
• Focus and Alias CC event lanes

Tips:

• Enable [Preferences > Peaks/Waveforms > Display MIDI: Text Events] to see Text events in the arrange window as well.

[Stevie326]

Looks very usable!!

[Kabraxis]

I recognized that avoiding from calling it an 'Articulation Manager' wasn't helping people to understand what ReaKS does

Yes, it's an Articulation Manager that works over Note Names in MIDI Editor.

Here I've put up a short tutorial on it: https://youtu.be/V3QjgwpfcJQ

Cheers

[Nantho]

This looks very interesting !

I'm on holidays right now, but I will try it as soon as I get back to work 😉

[krahosk]

This is amazing. Can't wait to try it out.

[Alez156]

A simpler tool like this is exactly what I was looking for! 🙏

I'll be trying it out and let you know how it goes. But from what I could see in the video, it works peeerfectly. Thank you so much!

[Kabraxis]

Thanks! I'm looking forward to receiving all of your feedback.

I've been updating the note names archive: https://drive.google.com/drive/folde...Uz?usp=sharing

Meanwhile, Reaper Stash is the perfect place to share your maps AND you can use all the Key Maps shared there so far!

https://stash.reaper.fm/tag/Key-Maps

Cheers,

[Spookye]

Thanks @Kabraxis....great helpful gem! I took a look at RKS Bank, would you happen to have NI Factory (orchestra bank only...) for Kontakt 5??
Thanks again.

[Kabraxis]

@Sppokye, sadly I don't have them, but I created a short video tutorial on how to build your own maps easily!

https://youtu.be/FDRATuGArM0

Cheers,

[Alez156]

I was able to load my articulation maps so easily. This works perfectly and very intuitive to use. Love having it docked on the left side of the docked MIDI editor at the bottom.

Thank you so much again for this!

[Spookye]

Originally Posted by Kabraxis

@Sppokye, sadly I don't have them, but I created a short video tutorial on how to build your own maps easily!

https://youtu.be/FDRATuGArM0

Cheers,

Thanks @Kabraxis....beautiful tool!

​

[ImJim]

Originally Posted by Alez156

I was able to load my articulation maps so easily. This works perfectly and very intuitive to use. Love having it docked on the left side of the docked MIDI editor at the bottom.

Thank you so much again for this!

Hey Alejandro, I like how you placed ReaKS here, I'm trying to dock it to my already docked MIDI editor window like you, but mine is on the right side of the screen. I'm trying to have ReaKS docked on the far right like this:



Is this even possible?

[Alez156]

Hello!
If your MIDI editor is floating (not docked), it's not possible to dock things inside the MIDI editor.

The way I have it is that I have the MIDI editor docked at the bottom.
Then I dock ReaKS by clicking and dragging the little tab while holding ctrl (or cmd) to drop it in the corner like that.

[Kabraxis]

TBF I find it easier to drag the windows to the bottom border. That way you can have multiple horizontal views.

[ImJim]

Great! But yeah I guess what I'm trying to achieve won't work in my situation... I have the piano roll on the right side of my wide 21:9 screen, and it looks like I can't dock anything to the right of that window.

[ImJim]

Originally Posted by Alez156

Hello!
If your MIDI editor is floating (not docked), it's not possible to dock things inside the MIDI editor.

The way I have it is that I have the MIDI editor docked at the bottom.
Then I dock ReaKS by clicking and dragging the little tab while holding ctrl (or cmd) to drop it in the corner like that.

Thank you! My MIDI editor isn't floating, it's docked to the right side. Kinda gives me a split view of both the arrange and MIDI windows on my 21:9 monitor. But somehow I can't dock anthing to the right of that MIDI window, only under or above it. Can you maybe give it a try on your system? Either it's a bug, either the feature doesn't exist, in any case it's pretty frustrating. I use lots of CC lanes so I need vertical space for MIDI editing, I can't put the MIDI editor at the bottom like you.

[norbury brook]

this looks great and with it docked in the midi editor it look 'Stock'

Going to try this out later.

Congrats, very simple/elegant solution.


M

[Spookye]

Thanks @Kabraxis...... extraordinary compact tool that can be integrated into ED-MIDI. Even creating the mappings is a snap of the fingers. Truly a beautiful jewel. Thanks thanks thanks

[Kabraxis]

Pushed a small update for saving settings between sessions and a button to help rename your CC lanes. A few more convenience updates to follow.

[Kabraxis]

v0.6 pushed to ReaPack repo, it should be live soon.

There's a facelift along minor fixes.

Also added a few new maps to my Google Drive archive:
https://drive.google.com/drive/folde...Uz?usp=sharing

Cheers,

[Spookye]

...Thanks Kabraxis.....really a great tool

[Kabraxis]

Glad you find it useful ^^

Please let me know if you have any suggestions!

[BogdanS]

after I clicked the triangle icon in the top left corner of the window in undocked mode, the script stopped running.
...ripts\ReaTeam Scripts\MIDI Editor\ugurcanorcun_ReaKS.lua:230: ImGui_PushStyleColor: expected a valid ImGui_Context*, got 00000000269B8A70

SizeOfColorStack >= g.ColorStack.Size && "PushStyleColor/PopStyleColor Mismatch!"

[Kabraxis]

Fixed and pushed to ReaPack queue, thanks!

Besides, I've improved automove playhead behavior and moved separators to collapsing headers. Woo!

[fakemaxwell]

Nice script! Any plans to expand on how "smart" it can be? For instance, the VSL Synchron libraries typically have very deep keyswitch maps. C1 controls articulation (long, short, legato, etc) and then C2 can control the type of shorts (spic, stac, detache) or the type of legato (normal, agile, slurred, portamento) and so on. It gets deeper for all the different sections of keymaps. Looking now, a single patch can use C1-G#1, C2-E2, F2-G#2, F7-G7, and A7-C7.

Right now the script displays everything at once. It's probably a limitation of Reaper keymaps, but if it could display only the type that corresponds to the current articulation, it would be very helpful.

[Kabraxis]

Thanks!

No, this script is and will be only limited to inserting/removing notes based on currently loaded Note Map keys (which is assigned to the Track unless you load another one).

That feature you're asking would be a great addition for an official Articulation Manager though!

[Bruceqld]

Great job Kabraxis! I have tried a multitude of these recently and yours is spot on. Straightforward, works from the note names I already have and doesn't change the keyswitch data type. Just what I needed

[Kabraxis]

Added a mini tool to insert Midi Note Names from clipboard:



(Pending ReaPack merge)

[Spookye]

Hi @Kabraxis....this is happening to me since this morning. No problem, I would like to understand if it's your change or it depends on me. Thank you 1000 Spookye

[Kabraxis]

Ahhlllrihgt. That's me
I've updated the script to use your own Reaper Theme's MIDI Editor window colors. I guessed it's a hit or miss since there are lots of themes with different color choices.

I'll fix it soon, until then you can either,
- Temporarily switch to another theme. Closing and reopening ReaKS will apply the new colors.
- Or Edit the script. There's an Enum section near the top that goes like

EnumThemeColors = { -- fetch colors from Reaper theme
    A = ThemeColorToImguiColor("midi_leftbg"), -- Background
    B = ThemeColorToImguiColor("midi_pkey2"), -- Default Interactive
    C = ThemeColorToImguiColor("midi_trackbg1"), -- Active
    D = ThemeColorToImguiColor("midi_trackbg2"), -- Hovered    
    E = ThemeColorToImguiColor("col_tcp_text"), -- HeaderText
    F = ThemeColorToImguiColor("midi_pkey1") -- Text
}

replace
F = ThemeColorToImguiColor("midi_pkey1")
with
F = 0xFFFFFFFF
for white or

F = 0x00000000
for black.

Sorry!

[Spookye]

Originally Posted by Kabraxis

Ahhlllrihgt. That's me
I've updated the script to use your own Reaper Theme's MIDI Editor window colors. I guessed it's a hit or miss since there are lots of themes with different color choices.

I'll fix it soon, until then you can either,
- Temporarily switch to another theme. Closing and reopening ReaKS will apply the new colors.
- Or Edit the script. There's an Enum section near the top that goes like

EnumThemeColors = { -- fetch colors from Reaper theme
    A = ThemeColorToImguiColor("midi_leftbg"), -- Background
    B = ThemeColorToImguiColor("midi_pkey2"), -- Default Interactive
    C = ThemeColorToImguiColor("midi_trackbg1"), -- Active
    D = ThemeColorToImguiColor("midi_trackbg2"), -- Hovered    
    E = ThemeColorToImguiColor("col_tcp_text"), -- HeaderText
    F = ThemeColorToImguiColor("midi_pkey1") -- Text
}

replace
F = ThemeColorToImguiColor("midi_pkey1")
with
F = 0xFFFFFFFF
for white or

F = 0x00000000
for black.

Sorry!

...no problem, I'll wait for your adjustment. Thanks for the reply

[Kabraxis]

ReaKS v1.0 is out!

What's updated since 0.7:
+ More streamlined workflow. No more tick boxes!
+ Injector tool for easy note-name mapping
+ ReaKS colors now match your theme
+ TUTORIALS!
# Settings are simplified and has tooltips
# LOTS of UX and performance improvements

There are a lot to come, so please send your suggestions!

I also moved Note Name maps to itch.io while updating the introduction text here.

If you like the tool, please consider donations there

[Spookye]

Thanks @Kabraxis.... it's shining again!
Thank you so much

[Kabraxis]

Thanks Spookye!

v1.1 pushed to ReaPack

• (Re)Added KS Note offset to help trigger Keyswitches just before the note.
• Smashed many bugs related to Single-Line mode.
• Introduced proper undo/redo
• Removed unused config variables

[Kabraxis]

v1.2 is out!

- Added Ctrl/Shift/Alt modifiers to KS buttons for Preview/Bypass Smart/Remove KS functions
- Added 'Help' section

[ZeRedbeard]

AAAAh I've been looking for this kind of stuff for ages! What a clever way to set it up easily. Thank you!

[handfp]

This is great! Many thanks!!

[ceanganb]

A great tool for Reaper Stubborn MIDIers
Thank to the intertwined work of devs and scripters, Reaper is getting such an accomplished MIDI tool.
Thanks a lot!

[JT-Axxe]

Hi,

Trying to install and run ReaKS (my first Rea Script) in Reaper.
Need to enter/manage key switches for NI Session Guitarist.

Getting the following error (Reaper 7.27) after updating the ReaimGUI to latest from Reapack:

ugurcanorcun_ReaKS.lua:71: attempt to call a nil value (field 'SNM_GetIntConfigVar')

Can you help to fix this?

[cfillion]

Originally Posted by JT-Axxe

ugurcanorcun_ReaKS.lua:71: attempt to call a nil value (field 'SNM_GetIntConfigVar')

This error means SWS is not installed.