For the S series MK3: A small Helper App for modifying .kmt template files

nico5
nico5 Member Posts: 101 Advisor
edited June 1 in Komplete Kontrol

Encouraged by the product team's post, I've recently built a very small helper app (browser based), to give a simple front-end to things that I used to do via editing the .kmt files by hand.

It can:

  • Add or change the image file for a template
  • Create/change template names with (optionally) special characters not found in the onboard editor
  • Create/change the labels for knobs and buttons with (optionally) special characters not found in the onboard editor (new)
  • Copy selected sections from another template file (.kmt) into the template file being edited. This can be handy for cases where you like some settings from a template made by someone else, but you want your own pedal settings, keyboard splits, etc.
    • Keyzones, Buttons & Knob settings (pages), Pedals, Touchstrip, Wheels

I've kept a couple of items that can also be edited with the keyboard's current firmware on board editor, because they were simple to implement.

  • Change the default LED color for the template
  • Change the MIDI output settings
  • Change the button LED colors
  • Change the display mode for Knobs

The online version can be found at

Technical info:

It's simple HTML, CSS, JavaScript - runs entirely in the local browser - so nothing gets uploaded to a server.

I've tried to make the code somewhat understandable, so it's more verbose than elegant. And it's also available for download (and potential further editing), and it hopefully fully works in a local browser context, so should also be usable off-line:

To download the code for running locally in your browser and/or for modifying the code, click here:

Simply put the unzipped folder somewhere and open index.html in a modern browser with JavaScript enabled.

The code is licensed as MIT No Attribution License / MIT-0 making it effectively like public domain. So any individual or company can freely use it, change it or build on it.

I'll continue to monitor this thread for questions, issues or comments.

Version history and downloads:

Update 2025-05-31:

Small change / fix:

  • Custom labels made with this app should now be preserved even when later changing MIDI channel, CC, PC or Note assignments in the hardware editor.
    • Note: Any label that is not PC or NO and doesn't start with CC is treated as custom label.

The online version can be found at

To download the code for running locally in your browser and/or for modifying the code, click here:

Update 2025-04-10:

Pretty much a full re-write with a few additions.

https://www.emxr.com/various/emx/kmtHelper_2025-04/

Added:

  • Edit the labels on the button and knob pages.
  • Edit Button LED colors.
  • Change the default LED color for the template — however since the recent firmware update, that can now also be done with the onboard editor.
  • Change the MIDI output settings — however since the recent firmware update, that can now also be done with the onboard editor.
  • Change the button LED colors (new) — can also be done in the onboard editor
  • Change the display mode for Knobs (new) — can also be done in the onboard editor

It looks quite different than the first version. I pretty much re-wrote the whole thing to be able to handle up to 16 kmt template pages worth of buttons and knobs labels a bit better than the original code and user interface could. But it's still just regular HTML, JavaScript and CSS and should hopefully work in any modern mainstream browser.

To download the code for running locally in your browser and/or for modifying the code, click here: https://www.emxr.com/various/emx/kmtHelper_2025-04.zip

I'll continue to monitor this thread for questions, issues or comments.

Update 2025-03-20:

Added a field for the MIDI output preference in support of the firmware upgrade released in March 2025.

Original 2025-01-14:

Link to my introductory blog post of the original version,

Direct link to the original version:

The original user interface uses a step by step metaphor, in the hope to make it as easy to understand and use as possible.

Technical info: It's simple HTML, CSS, JavaScript - runs entirely in the local browser - so nothing gets uploaded to a server.

I've also tried to make the code somewhat understandable, so it's more verbose than elegant. And it's also available for download (and potential further editing), and it hopefully fully works in a local browser context, so should also be usable off-line:

kmtHelper.zip

Simply put the kmtHelper folder somewhere and open index.html in a modern browser with JavaScript enabled.

Any questions, bugs or other feedback, I'll try to monitor this thread.

Komplete Kontrol S MK3 Outline
«1

Comments

  • Yearofthegoat
    Yearofthegoat Member Posts: 19 Member
    edited January 22

    This does look cool. I need to find out how to get my template copied off the keyboard and onto my PC!

  • nico5
    nico5 Member Posts: 101 Advisor
    edited January 23

    You'll need to install the "Hardware Connection Service" via Native Access.

    And once that is working ok - when the MK3 keyboard is connected to the PC, go to the EDIT mode on the keyboard (hold Shift button and press Browser button).

    That should give you Import and Export options - i.e. Export and Import are both initiated from the Keyboard.

    ==============================================

    When pressing the Export button, a window to select a target folder will open - this Window has the title

    "Select the location to save the templates"

    NOTE: You may have to hunt for that window, because it may not always pop to the foreground.

    image.png

    ==============================================

    When pressing the Import button, a small dialog window will appear on the PC, and you can drag and drop the template files from your PC to that window.

    NOTE: You may have to hunt for that window, because it may not always pop to the foreground.

    NIHardwareConnectionServiceGUI_oUEispRZVJ.png

    After one or more template files have been added to that window, press the "Send Templates & Close", and then the imported template(s) should be available on the keyboard.

  • Shore
    Shore Member Posts: 20 Member

    Thank you so much @nico5 !!!!

    Patt

  • Shore
    Shore Member Posts: 20 Member

    Hey @nico5 and anyone who is interested:

    Used this recently and works a treat! Makes the image import process much easier.

    Here is an free online image editing site I used to get the correct pixel values (for those of us that have no clue what to do in photoshop):

    https://the-image-editor.com/en?gad_source=1&gclid=CjwKCAiAtNK8BhBBEiwA8wVt92aqZh1jZqZLDA_aKQ9178sFX5LXHQOPfD3o4akipV1DX4Wqr6mOBBoCUYMQAvD_BwE

    Take Care

    Patt.

  • Yearofthegoat
    Yearofthegoat Member Posts: 19 Member

    Doesn't work here - i.e. I don't get any window opening up when I select to Export a MIDI template. I tried re-installing/updating but no luck.

  • Yearofthegoat
    Yearofthegoat Member Posts: 19 Member

    Needed a hard re-boot. Seems to be okay now.

  • nico5
    nico5 Member Posts: 101 Advisor

    Glad you got it working!

    p.s. It's amazing that even in 2025 a hard reboot is still the answer to so many problems! 😆

  • Michiro Sato
    Michiro Sato Member Posts: 8 Member

    This is truly an amazing software!!!
    And I would be very grateful if you could make the software that can edit NKS2.

  • nico5
    nico5 Member Posts: 101 Advisor
    edited February 7

    Thank you!

    From what I've investigated, NKS2 seems to be a very different thing.

    It's not one or more separate files, but an API that has to be implemented in the C++ code for each plugin or the KSP (Kontakt scripting language) for each Kontakt Library - and that can only be done by the makers of plugins and libraries.

  • Yearofthegoat
    Yearofthegoat Member Posts: 19 Member

    Yes, it's one of those things the Linux folk used to laugh about - but these days even Linux updates need a good ol' reboot.

    Thanks for the tool though - it's very useful. I now have a bespoke background to my templates!

  • nico5
    nico5 Member Posts: 101 Advisor

    Yes, it's one of those things the Linux folk used to laugh about - but these days even Linux updates need a good ol' reboot.

    haha - yes indeed. If it has a processor, there's a good chance that a reboot fixes some things. And with modern cables increasingly having processors. we may even find ourselves unplugging and re-plugging cables as a fix.

    Thanks for the tool though - it's very useful. I now have a bespoke background to my templates!

    Thanks for leaving your kind note here. Since I'm sick and tired of privacy violating telemetry abuse by too many big players, there's zero telemetry in my little tool. So a comment like yours is the only way, that I can find out, if anyone is even trying the tool.

  • Uwe303
    Uwe303 Moderator Posts: 4,729 mod

    Wow that's awesome 😎 👍

  • Justerini
    Justerini Member Posts: 30 Member

    This is awesome - been playing with it for 1/2 hour - already created 5 TEMPLATES on the fly
    Mac user so no hard reboot needed😎

  • nico5
    nico5 Member Posts: 101 Advisor

    I've created a new version of the kmtHelper app for making some changes to kmt template files.

    The first post in this thread has been updated to reflect the new version:

Back To Top