1

TABLE OF CONTENTS

2
 INTRODUCTION

Thank you for purchasing KGM - the Kontakt GUI Maker!

KGM is a powerful tool that lets you create and design virtual
instruments for the Kontakt sampler developed by Native
Instruments witout the need for complex scripting.

Core features:

Drag and drop GUI design.

Expandable factory library with 500 action scripts.
Importing of custom PNG files.
Full control over filters, envelopes and effects.
Supports tables, waveform displays and more.
Built-in note sequencer.
Includes ready-to-rock Kontakt 5 template.
Automatic script update in the background.
Available for Windows and OS X

3
 SYSTEM REQUIREMENTS

KGM requires the following setup to run properly:

A computer running Windows or OS X.

Windows 7 or higher.
OS X 10.6.8 or higher. NOTE: Sierra is not supported!
At least 2 GB RAM.
At least 1 GB of hard drive space.
Dual-core processor with at least 2 Ghz.
A fully licensed N.I. Kontakt 4.2.4 or 5.5.1 (or better).
Kontakt compatible DAW software optional.
ASIO soundcard / audio-interface recommended.
MIDI controller keyboard is strongly recommended.
Optional: A good text editor. We recommend Nils Libergs
excellent KScript Editor at http://www.nilsliberg.se/ksp/
Under rare occasions, you might need to edit a few lines in the
script file that KGM cooperates with.

This is why a good editor does come in handy.

4
 INSTALLATION

Attention: Carefully follow these steps!

Copy the folder called KGM_100 taken from the distribution

archive's Release folder to either your AppData folder:

<Drive>:\Users\<YourUserName>\AppData\Local\KGM_100

or to your hidden Application Support folder (OS X):

~/Users/<YourUserName>/Library/Application Support/KGM_100

It has to look exactly as in the following screenshot (OS X):

5
On OS X you might as well need to run the included showAllFiles
Application before. It is located in Release/OSX/showAllFiles.app.

This will make hidden files and folders on your system visible.

Once you've done that, it's a good idea to create a shortcut

(Windows) or an alias (OS X) to the KGM_100 folder.
You can then place that shortcut e.g. on your Desktop and have
easy access to it whenever you need to.

To launch Kontakt GUI Maker itself, navigate to the distribution

archive's Release/Windows or Release/OSX folder, depending on
which operating system you are using.

Copy the either the Windows or OSX folder to any location on

your harddisk (e.g. the Desktop). Launch KGM from there.

6
 SETTING UP KONTAKT

Before you can start designing your own Kontakt instruments, you
will need to import the reference (template) instrument into
Kontakt itself. Note that we focus on the Kontakt 5 template.

To do so, load up Kontakt either in standalone mode or as a plugin

into your DAW.

7
Once Kontakt is loaded, click on the Browse icon in the top
section, and choose the Files tab.

8
From here, navigate to the location of the KGM_100 folder.

When using Windows, you might find this folder either as a

link/alias on your desktop or its located at:

<drive:>\Users\<yourUserName>\AppData\Local\KGM_100

On OSX it would be:

~/Users/<yourUserName>/Library/Application Support/KGM_100

Note that you might need to copy the KGM_100 folder (and all its
content) manually to these locations, depending on which
Operating System youre using.

Otherwise KGM wont find its folder and cannot work properly.

If these steps are done, choose the project folder inside the
KGM_100 folder. Kontakt will show a list of *.NKI instruments in
that folder. Note that we focus on the Kontakt 5 template.

Doubleclick or drag and drop KGM Template Instrument.nki to

open up the KGM template (reference) instrument to work with.

It should look similar to this:

9
This is the default and empty KGM Kontakt 5 template instrument.

10
 HOW KGM WORKS
When you launch KGM for the first time it will read and interpret a
Kontakt script file, that includes all the information about the GUI
elements for the instrument itself.

This is the background image, the instrument height, the number of

items (knobs, sliders, labels and so on), the positions of them, the
assigned PNG images etc.

KGM does communicate with Kontakt via constantly modifying a

reference script file called KGM_Script1.txt, located in the
KGM_100/project/Resources/scripts folder.

This is also the script file that the template instrument is using.

That does mean whenever you change something inside KGM (e.g.
drag and drop a knob onto the GUI area, adjust values or delete
another item) it will auto-update the script file so that when you
come back to Kontakt, all changes will be reflected once you press
the ! icon in Kontakt to restart the engine:

Note that we put communicate into quotation marks since this

communication is one-way only. KGM only tells Kontakt what to do
and to display Kontakt doesnt send any information back to
KGM.

11
 MAIN GUI OVERVIEW
Locate the Kontakt GUI Maker program application and launch it.

Once its loaded, it should look like this:

12
In KGM we have the following three main sections:

1) The library that contains all the available user interface items
(PNG files + corresponding TXT information files).

2) The main GUI area, where you place (drag and drop) elements
from the library.

Here you can also see a mockup of the Kontakt instrument header
interface. The Kontakt buttons and option fields have no function.

3) The editing window for the currently selected item.

This is where you adjust options and parameters for your GUI
elements.

Well cover that later.

13
 OPTIONS MENU
KGM has an options menu, where you can set up some program
properties, like changing the grid size among other settings.

To open up the options menu, click on the wrench icon in the

Kontakt header area at the top.

The following options can be adjusted here:

1) Movement Lag (100ms, 200ms or 300ms)

2) Grid (On or Off)
3) Grid X (Horizontal Size) (8px, 16px, 32px or 64px)
4) Grid Y (Vertical Size) (8px, 16px, 32px or 64px)
5) Grid Brightness (Left=Black, Right=White)
6) Grid Alpha (Left=Transparent, Right=Opaque)
7) Enable History (Stores a copy of the current script file in a
backup folder upon every change)
8) Load Last Project (Currently always on)
9) Anti-Aliasing (Improves graphics quality when resizing the main
window)
10) Hide Controls (Hides all control items on screen)
11) Hide Labels (Hides all label items on screen)
12) Bake Labels (Renders label items into the wallpaper)

14
Lets have a closer look at these options:

1) Movement Lag (100ms, 200ms or 300ms)

Whenever you click and move items in the GUI area, you might
have noticed that a delay comes into play and wondered if thats a
program slowdown or even a bug. No, it isnt.

Weve introduced this delay to avoid the risk of unwanted item

movement when clicking one to edit its properties.

If there wouldnt be a delay theres still a chance of accidentally

moving an item even if you try hard keeping the mouse in place
while doing so.

You can choose between 100, 200 and 300 milliseconds. The
default value is 200ms.

2) Grid (On or Off)

KGM has a built-in grid that you can align interface elements to.
This grid can be visually displayed if wanted. Whenever the grid is
turned on, items on screen will snap to it as soon as you move
them around in the GUI section.

Note that you can also use your computers keyboard key G to
enable or disable the grid.

3) Grid X (Horizontal Size) (8px, 16px, 32px or 64px)

Here you can change the amount of pixels for the X coordinate.
Note that you can also use your computers keyboard keys 1-4
to select the pixel sizes 8, 16, 32 and 64px for both X and Y.

4) Grid Y (Vertical Size) (8px, 16px, 32px or 64px)

Here you can change the amount of pixels for the Y coordinate.
Note that you can also use your computers keyboard keys 1-4
to select the pixel sizes 8, 16, 32 and 64px for both X and Y.

15
5) Grid Brightness (Left=Black, Right=White)

Some instrument background wallpapers might be very dark or

very bright. To still see the visual grid properly, you can adjust its
brightness using the Grid Brightness.

Moving the fader all the way to the left will darken the grid,
centering it will result in a gray colour and moving it to the right will
result in a whiter grid.

6) Grid Alpha (Left=Transparent, Right=Opaque)

Looking at a grid at full colour and brightness can be quite

distracting for the eye after a certain amount of time.
To compensate for this, you can make the grid e.g. semi-
transparent using this slider.

Simply move it to the left until you are happy with the appearance.

7) Enable History (Stores a copy of the current script file in a

backup folder upon every change)

This is no undo history. Instead, this menu option, when checked,

stores a copy of the current used Kontakt script in a History folder
inside the KGM_100 folder before applying changes that you have
made to any item on screen.

If you for example move a slider to a new position, this will store a
copy of the current script with the current slider position (and of
course everything else) in the History folder.

Note that this option isnt thought as a backup function, it is more

or less designed as a personal reference in case you need to know
what you have done to an item a few (or way more) steps before.

16
8) Load Last Project (Currently always on)

In the future, you will be able to load a project from a list of

available ones. Currently, KGM does always load the current (last)
project automatically.

9) Anti-Aliasing (Improves graphics quality when resizing

the main window)

In case you have a very high screen-resolution, you can enlarge the
main KGM window by dragging the outer edges:

In some cases checking this option will improve the picture quality.
Oh, and by the way: To restore the KGM main window back to its
original size, simply click this little button in the Kontakt header
area top-right:

10) Hide Controls (Hides all control items on screen)

Sometimes you might want to hide items that youve placed on

screen before to see whats in the background at that position.
(E.g. for pixel-perfect positioning of ite
ms). You can use this option to do so. Note that you can also press
your computers keyboard key C to hide or unhide control items.

Optionally, you can right-click (OSX: <OPTION>+Click) items to

make them semi-transparent temporarily.

17
11) Hide Labels (Hides all label items on screen)

This option is pretty much like the Hide Controls menu option.
The only difference is that this one hides all on-screen items with
an item type label.
Note that you can also press your computers keyboard key B to
hide or unhide label items.

Optionally, you can right-click (OSX: <OPTION>+Click) items to

make them semi-transparent temporarily.

12) Bake Labels (Renders label items into the wallpaper)

With this option you can render (bake) all items of the item type
label that are currently on screen into the current wallpaper
background. Labels can be static images like logos, GUI dividers,
screws and fake venting slots.

This option is useful if you have designed a GUI layout that uses a
lot of labels for composition. Once you consider your GUI as done
you can let run the bake process. This is also handy since it
removes all label item declarations in the main Kontakt script, thus
freeing up resources.

But be careful: This process is permanent and cannot be undone.

To be safe, always have a backup of your wallpaper background
image at hand. (Or (and also) back up a copy of the main script
file).

In a nutshell, always see this as the last step in your GUI design.

18
 THE LIBRARY
The most important component of KGM is the library.

There you have access to all of your user interface controls and
elements to design your instrument. These include buttons and
switches, knobs and sliders, menus, labels, level meters, tables and
so on.

KGM comes with a comprehensive library of over 340 items.

Each item in the library has to be made up of two components:

1) The PNG file (graphic) itself.

2) The additional TXT file describing the item.

Important: Each PNG file, e.g. mySlider.png must have a

corresponding TXT file like mySlider.txt in the same location for
KGM to recognize it. Both filenames must be identical!

Also, Kontakt does require these TXT files as well.

All the items in the library are seperated by type:

knobs metal
knobs plastic
labels
menus
other
sliders
switches
tables
user
wallpaper
waveform

19
 ITEM TYPES EXPLAINED
As we already know, each item in the library is a combination of a
PNG file as well as a TXT file describing the item itself.

Let's examine one of the items from the library:

(library/pictures/knobs metal/knob_metal_gold_pan.png)

Notice that the TXT file has the same name as the PNG file:
knob_metal_gold_pan.txt

It contains:

Has Alpha Channel: yes

Number of Animations: 70
Horizontal Animation: yes
Vertical Resizable: no
Horizontal Resizable: no
Fixed Top: 0
Fixed Bottom: 0
Fixed Left: 0
Fixed Right: 0
Type: slider
Mouse Behaviour: -750
Action: "groups\grp pan.txt"
Def Value: 500000

Lets go through each line of the TXT file:

1) Has Alpha Channel: yes

This line describes the handling of alpha channel information.
If it says yes then Kontakt will draw it with the alpha channel
being transparent (look-through). Otherwise you would have black
coloured regions in the image whereever there is alpha information.

2) Number of Animations: 70
You might notice the cutted preview of the slider on the top of this
page. This is how the image looks on disk (internally).

20
However, since we do need to animate this slider (it should react
and update its graphic upon dragging it) we'll define the number of
frames in the TXT file. Youll have to do this since Kontakt or KGM
cannot know how much frames the PNG file has.

With Number of Animations: 70, we tell KGM to divide the PNG

file horizontally seventy times.

This PNG file is therefore called an image strip since it contains

multiple frames layed out in a horizontal fashion.

Note: KGM does only support horizontal PNG image-strips.

Keep this in mind when designing your own graphic files.

3) Horizontal Animation: yes

As stated above, this is important and has to be always yes.

4) Vertical Resizable: no
5) Horizontal Resizable: no
In Kontakt you can have GUI items scaled. To use scaling you would
need to enable one of these options by setting it to yes.

However, the possibility of scaling isnt used often since it would

make the image appear blurry. Thus we never use it and always set
that one to no.

6) Fixed Top: 0
7) Fixed Bottom: 0
8) Fixed Left: 0
9) Fixed Right: 0
With these commands you can set pixel distances. We wont use
them at all so well leave them at 0.

21
10) Type: slider
This is important!

Here well define the type of the control item, in this case we want
the item to act as a slider.

Note that if the Type information is missing in any TXT file, KGM
will treat that control element as a slider.

You basically should use Type: slider for everything that is a fader
or rotary control (e.g. a knob) that you drag horizontally or
vertically with the mouse.

The available control item types are:

anim
button
label
level meter
menu
slider (default)
switch
table
text edit
value edit
wallpaper
waveform

At the end of this chapter we will explain all types in detail.

11) Mouse Behaviour: -750

This option sets the mouse behaviour for the item.
Here you can enter a value from -5000 to 5000, setting the move
direction of a slider.

22
Negative values give a vertical slider behaviour and positive values
give a horizontal behaviour.

Lower values result in more pixels that need to be travelled with

the mouse.

12) Action: groups\grp pan.txt

This line assigns an action to the item. More on actions later.

Upon dragging this item to the GUI area in KGM, it will

automatically add the assigned action, in this case grp pan to it.

This premade action controls the groups panning.

13) Def Value: 500000

By using this line, we set the items default value to 500000.
Without this line, an item would always have a default value of 0.
Note that in Kontakt, all items do have values from 0 to 1000000.

The reason for this assignment is that when you <CONTROL>+click

(OSX: <COMMAND>+click) the item in Kontakt, it will reset itself to
a value of 500000 and the image will jump to a center position.

Since this is a knob that controls panning, this way you can easily
reset (center) the panning amount.
(Otherwise you might have a hard time finding the exact center).

23
We have now examined a single control item.

Lets get into the nasty details again on what types are available,
what tags (instructions) you can add to them and how they work:

Type: anim
Number of Animations: 100 (currently needs to be 100 always)

Possible instructions in TXT file:

<none>

Is used for animations that run on their own once dropped into the
KGM GUI area.

The speed is set globally in the main script file. The line for that is:
set_listener ($NI_SIGNAL_TIMER_MS,18000).
The 18000 indicates when frames should be increased by one.
Here, the speed is 18 milliseconds.

You cannot interact with this type.

Type: button
Number of Animations: 6

Possible instructions in TXT file:

Width: <value> (pixels)
Height: <value> (pixels)
Min Value: <value>
Max Value: <value>
Def Value: <value>
Help: <string>
Action: <actionfolder+actionfile>
Text: <string>
Randomize Layer: <value>

24
Note on Randomize Layer: There are four randomize layers.
The value has to be in the range from 0 to 15.

Once you drag the item into the KGM GUI area, it will automatically
set up random groups for that particular item.

Randomize value and what it results in:

0 =____
1 =___D
2 =__C_
3 =__CD
4 =_B__
5 =_B_D
6 =_BC_
7 =_BCD
8 =A___
9 =A__D
10 = A _ C _
11 = A _ C D
12 = A B _ _
13 = A B _ D
14 = A B C _
15 = A B C D

Note that a button always needs a horizontal image-strip with

exactly six images to function properly.

These six images correspond to the following states in Kontakt:

Frame 1: OFF (regular)

Frame 2: ON (regular)
Frame 3: OFF (pressed)
Frame 4: ON (pressed)
Frame 5: OFF (mouse over)
Frame 6: ON (mouse over)

Type: label
Number of Animations: 1

Possible instructions in TXT file:

25
Screw Type: <value> (0 to 2)

When you add this tag to an item, it will randomly rotate the
graphic (PNG) files associated with it. The value 0 means only
rotate, 1 means rotate and add dark screw base and 2 means
rotate and add a light screw base.

You cannot interact with this type.

Type: level meter

Number of Animations: 1 (won't show up in Kontakt)

Possible instructions in TXT file:

Width: <value> (pixels)
Height: <value> (pixels)
Help: <string>
Channel Assign: <value> (0=left or 1=right)
Bus Assign: <value> (0=bus 1 to 15=bus 16)
Background Colour: <hex> (e.g. #A9B02F)
Off Colour: <hex>
On Colour: <hex>
Overload Colour: <hex>
Peak Colour: <hex>
Vertical: <string> (yes or no)

You cannot interact with this type.

Type: menu
Number of Animations: 1 (won't show up in Kontakt)

Note on the animation: It only has one frame since in Kontakt, it

wont be displayed at all. Its just for KGM as a placeholder.

Possible instructions in TXT file:

Help: <string>
Action: <actionfolder+actionfile>

Note that a menu will be generated and rendered once you drag

26
and drop it from the library to the GUI area. As an action, use e.g.
menu functions/playback group A select.txt

For KGM to know what to render, youll need to define e.g. patch
names in the menu TXT file like this:

{ BEGIN MENU ITEMS }

Preset Name A
Preset Name B
Preset Name C (RR: 2)
Another one D
A different one
And so on
{ END MENU ITEMS }

You can have as much items as you want.

Note the (RR: 2) that has been added to Preset Name C.

This indicates that a round robin group should be taken into

account for this particular preset.

What this does is, when you use this menu item in Kontakt, and
switch to (select) menu preset Preset Name C, it will allow two
(RR: 2) consecutive groups to be played.

Note that youll need to program these two groups so that they
work in round-robin mode. Please refer to the Kontakt manual on
how to accomplish this.

Further menu instructions do exist to adjust colours, fonts and so

on:

Font: <value> (0 to 7, built-in fonts, currently cannot be replaced)

Font Size: <value> (1=small to 5=large)
Font Colour: <hex> (e.g. #FF0000)
Outline Colour: <hex> (e.g. #000000)
Gradient Colour: <hex> (e.g. #00FF77)
Gradient Angle: <value> (degrees, e.g. 90)

Besides using the menu item type to display e.g. preset names, you

27
can also use it to change IR (impulse response) files for the
convolution reverb effect in Kontakt.

Remove any { BEGIN MENU ITEMS } and { END MENU ITEMS }

plus all the lines inbetween. Instead, enter these lines:

IR Readout: yes
IR Readout Format: <string> (lowercase or uppercase) - dont
include this line at all to have the default output (no change).

IR Readout Hide Extension: <string> (yes or no, will hide the

*.WAV file extension after the file name)

When you will now drag and drop this item, it will automatically
generate a menu with all the available IR (impulse response) files
as selectable entries.

Note: The IR (impulse response) files are located in:

project/Resources/ir_samples

For this item to work, choose

menu functions/insert fx impulse response select.txt as an action.

Type: slider (default)

Number of Animations: <value>

Possible instructions in TXT file:

Width: <value> (pixels)
Height: <value> (pixels)
Min Value: <value>
Max Value: <value>
Def Value: <value>
Mouse Behaviour: <value>
Help: <string>
Action: <actionfolder+actionfile>
Text: <string>
Automation: <string> (allow automation, yes or no)
Automation Name: <string> (e.g. filter cutoff)
Randomize Layer: <value> (0 to 15)
Label Text: <string> (generates a label, e.g. my label)

28
Label Font: <value> (0 to 7)
Label Font Size: <value> (1=small to 5=large)
Label Font Colour: <hex> (e.g. #FF0000)
Label Outline Colour: <hex> (e.g. #000000)
Label Gradient Colour: <hex> (e.g. #00FF77)
Label Gradient Angle: <value> (degrees, e.g. 90)

Note: The tag Label Text: (that will generate a label item) can be
used for any other item type as well, not only for sliders.

Type: switch
Number of Animations: 6

Possible instructions in TXT file:

Width: <value> (pixels)
Height: <value> (pixels)
Min Value: <value>
Max Value: <value>
Def Value: <value>
Name: <string>
Help: <string>
Action: <actionfolder+actionfile>
Text: <string>
Automation: <string> (allow automation, yes or no)
Automation Name: <string> (e.g. filter enable)
Randomize Layer: <value>

Note that a switch is identical with a button. The only difference is

that a switch can be automated. So you should always use switches
instead of buttons to be flexible.

Type: table
Number of Animations: 1 (won't show up in Kontakt)

Possible instructions in TXT file:

Width: <value> (pixels)
Height: <value> (pixels)
Table Steps: <value> (e.g. 16)
Table Steps Shown: <value> (e.g. 16)

29
Table Range: <value> (e.g. 127)
Name: <string>
Help: <string>
Action: <actionfolder+actionfile>
Bar Colour: <hex> (e.g. #FF0000)
Line Colour: <hex> (e.g. #00FF00)
Randomize Layer: <value>

Currently, tables are only used for a simple note step-sequencer in

KGM. To enable the step-sequencer, you also need to drag and drop
the item switch_sequencer_enable from the library to the GUI
area. It is located in switches.

Note that you can only have a one note step-sequencer at a time,
as it works globally. The default tempo of the note step-sequencer
is 1/16th.

To change the tempo of the note step-sequencer, you can use

buttons that are located in the folder switches. These are called:

button_sequencer_dur_sixteenth
button_sequencer_dur_sixteenth_triplet
button_sequencer_dur_eighth
button_sequencer_dur_eighth_triplet
button_sequencer_dur_quarter
button_sequencer_dur_quarter_triplet

Type: text edit

Number of Animations: 1 (won't show up in Kontakt)

Possible instructions in TXT file:

Text: <string> (e.g. enter a patch name)

Note: In the future, KGM will support actions for text edit items.

Type: value edit

Number of Animations: 1 (won't show up in Kontakt)

30
Possible instructions in TXT file:
<none>

Note: In the future, KGM will support actions for value edit items.

Type: wallpaper
Number of Animations: 1

Possible instructions in TXT file:

<none>

Wallpaper items can be dragged and dropped onto the GUI area in
KGM to set the background to a different wallpaper.

Once dragged, the wallpaper.png file in

project/Resources/pictures will be overwritten.

Note that you have to reload the Kontakt template instrument for
the changes to be visible.

Type: waveform
Number of Animations: 1 (won't show up in Kontakt)

Possible instructions in TXT file:

Width: <value> (pixels)
Height: <value> (pixels)
Action: <actionfolder+actionfile>
Waveform Colour: <hex> (e.g. #00FF00)

This will create a new waveform display that shows the current
waveform (zone) that is associated with the pressed note on your
MIDI keyboard or DAW note event.

You can have multiple waveform displays, however, at the moment

they will only show the currently pressed note's waveform.

31
 ACTION FILES
All items in the KGM library do have pre-made actions assigned to
them that tell Kontakt what function they have or what parameter
they should manipulate.

Without these, any control in Kontakt would be just nice to look at.

In this section, we will learn everything about action files, which are
located in KGM_100/library/actions. For the ease of editing, these
are just plain TXT files.

An empty action file does look like this:

{ KGM VERSION 100 }

{ KONTAKT 4 }
{ BEGIN DECLARATIONS }
{ END DECLARATIONS }
{ BEGIN UI_CONTROL_ACTION }
{ END UI_CONTROL_ACTION }
{ NO GROUP ACTION }

Let's examine the file line by line:

1) { KGM VERSION 100 }

This is for KGM to know which action script version it can expect.
100 stands for v1.00.

2) { KONTAKT 4 }

This can either be 4 or 5. The default is 4. It is used for

compatibility between Kontakt 4 and 5 and to distinguish between
the two.

Certain Kontakt engine parameters do only work in Kontakt 5, so

here you can mark your script as Kontakt 5-only.
The action script box in KGM (where you can assign actions to GUI
items) will then display a KONTAKT 5 reminder beneath the action
in the selection list.

32
3) { BEGIN DECLARATIONS }
4) { END DECLARATIONS }

This is a declaration block for any variables that your script might
require. These variables will be declared once in the main script file
per item that this script will be assigned to.

Remember that when you delete the item with this script assigned
to in KGM, these declarations will also be deleted.

For example, you could write:

<name>_LAST_VALUE := 0
$MY_VAR := <name>
$ANYTHING := 12345

Notice the <name> tag in this declaration.

The <name> tag will be replaced by KGM with the name of the item
that this action will be assigned to.

5) { BEGIN UI_CONTROL_ACTION }
6) { END UI_CONTROL_ACTION }

This is the action block that will be called / triggered whenever you
press a button or move a slider in Kontakt.

So, if for example you want to write an action that sets a variable
to the value of the item that this action script will be assigned to,
you would need to write:

{ BEGIN UI_CONTROL_ACTION }
$MY_VAR := <name>
{ END UI_CONTROL_ACTION }

7) { NO GROUP ACTION }

Indicates whether the script is a group action or not. When this line
is present, the script will be interpreted as a non-group action.
Some Kontakt engine parameters dont assign groups, e.g. when

33
you adjust the volume of a bus (which has nothing to do with
groups).

This is when you should insert this line into your action script as it
also wont let you make changes to the group selection box in
KGMs edit window as well as to the Random Layer selection.

More on this later.

In the previous example, we have assigned the value of an item to

a variable called $MY_VAR. This is fine but somewhat limited.

What if, for example, you wanted to have a slider control the
volume of one group? Or a range of groups? Or even all groups in
Kontakt?

To achieve this, well have a look at an existing action script taken

from the library, called grp volume.txt which is located in
actions/groups:

{ KGM VERSION 100 }

{ KONTAKT 4 }
{ BEGIN DECLARATIONS }
declare <name>_GRP_CURRENT := <group_single>
declare <name>_GRP_BEGIN := <group_begin>
declare <name>_GRP_END := 0
<name>_GRP_END := <group_end> { REQUIRED }
{ END DECLARATIONS }
{ BEGIN UI_CONTROL ACTION }
<name>_GRP_CURRENT := <name>_GRP_BEGIN
while (<name>_GRP_CURRENT < <name>_GRP_END+1)
set_engine_par ($ENGINE_PAR_VOLUME,<name>,<name>_GRP_CURRENT,0,-1)
inc(<name>_GRP_CURRENT)
end while
{ END UI_CONTROL ACTION }

Some new tags are being introduced here.

<group_single>, <group_begin> and <group_end>.

These values will be set by KGM when you change the group mode.

Basically, what this does is looping through the groups (from

<group_begin> to <group_end>). This way you can adress more
than a single group with your action.

34
 THE EDIT SECTION
In this chapter we will explore the edit section, that is used to
adjust parameters of items on screen, add actions and so on.

The functions displayed here (being active) depend on what type of

item you have selected.

That means for e.g. a menu or a table item some of the

elements in here might be grayed out, indicating that adjusting this
particular option for that specific item is not possible or doesn't
make sense.

In the above picture, we've selected an item that is a slider.

Let's have a look at all possible settings for this item:

Width/Height
Will display the items width an height in pixels. Note that KGM does
only work in pixels-mode and not with grid-based values.
Normally, you shouldn't change these values as they (most of the
time) only refer to the so called bounding box which is the
clickable area inside Kontakt. (Area of action).

Min/Max/Default
Most items have minimum, maximum and default values. Note that
an item with a default value won't reflect that upon launch of the
instrument. The default value will be referred to whenever the user
clicks on an item with the <CONTROL> (OSX: <COMMAND>+Click)

35
being pressed at the same time.
This is useful to e.g. reset a control to its initial state. (think of 0dB,
center panning and so on).

Note that values in Kontakt go from 0 to 1000000 (one million).

Disp-R
Obsolete. (Only used for items with type knob). Since you cannot
assign pictures to that type, we won't use this option at all.

Name
KGM does name your controls e.g. slider9438759. It always adds
a random number at the end of the control name to avoid naming
conflicts in Kontakt. If you wish you can give your control a specific
name here.

Autom
Most of the control items in Kontakt are automatable and that by
default. Here, you can enter a name for the automation name of
the selected control. This name will appear in the Auto section of
Kontakt:

36
Using the checkbox, you can decide if you want that control to be
automatable or not.

Giving automatable controls meaningful automation names like e.g.

Filter Cutoff is always a good idea since otherwise the user might
not know what he is actually automating.

Help
When the user hovers over an item, Kontakt can display a help text
for that particular item in the information window at the bottom.
(That empty box with the i in a circle). Here, you can e.g. let the
user know what your control actually does.

Persist
In Kontakt, item values (like the angle/position of a knob) can be
stored within the actual instrument.

This box is checked by default to ensure that when you save and
reload your instrument, all knobs and sliders will revert back to
their last state. So you should let this checkbox ticked.

Image
This box shows the image (PNG file) that is currently assigned to
the selected item.

Action
Here you can choose the action for the currently selected item.
Refer to the chapter Action files to learn more about actions.

Unit
Obsolete. (Only used for items with type knob). Since you cannot
assign pictures to that type, we won't use this option at all.

37
Mouse (Mouse Behaviour)
This let's you adjust how an item should react to mouse movement
upon dragging. Here you can enter a value from -5000 to 5000,
setting the move direction of a slider. Negative values will result in
a vertical movement. Smaller values will mean that it takes more
pixels to travel for the knob or slider to move.

Text
This option is used for labeling items.
Here you can enter a text that should be displayed in Kontakt.
You should only use it for items of the type label.

Random (ABCD)
KGM does support randomizing the value of items.There are four
randomize layers that you can add controls to.

You can add e.g. two knobs to random group A and a set of
another five controls to random group B.

Once that's done, add two buttons to your project, one button to
randomize group A and one to randomize group B.

You can find the required actions for this in actions/miscellaneous.

When randomizing, the items inside randomize groups will move to
a random position and also run their actions with the new
randomized position as well.

All Groups/Group/From/To
This is used to decide which group or range of groups the selected
controls action should affect.
Let's say you have a knob with an action assigned that controls the
groups filter cutoff. By default, this knob will alter the filter cutoff
of all groups, unless you switch to either Group and enter the
number of the group or to From/To and enter the first and the last
group.

38
 PLAYBACK GROUPS
You can determine, how (much) groups should be played back at
the same time (or not) using playback groups.

KGM features up to 10 playback groups (A to J).

That means you can e.g. play up to 10 different sounds (groups) at
once. Note that only group A is enabled by default.

Let's say your instruments uses 10 groups with different WAV

samples. And furthermore, let's say you want the user to be able to
check or uncheck tones that should play upon pressing a note.

(Like those very old CA*** and YAM*** keyboards back then).

For this to work you will need to add group playback select buttons
to your project. The required actions for that are located in
library/actions/groups.

The steps involved in settings these up are:

1) Drag a switch from the library to the GUI area.

2) Assign e.g. groups/playback grp A active toggle.txt to it.
3) Done.

By pressing that switch you can toggle the on/off status of the
playback group easily.

39
 YOUR FIRST INSTRUMENT
In this chapter, we will design a complete instrument from scratch.

We will start with the blank Kontakt 5 template instrument loaded:

40
In KGM, go to the library and select the folder knobs metal.
Drag four knob_metal_gold_minmax knobs into the GUI area:

41
Now assign them ADSR actions to control the volume envelope.
(ADSR stands for Attack, Decay, Sustain and Release).

Select the first knob from the left and click on the Action field in
the edit section, where it says N/A (no action assigned).

In the action library, navigate to the folder envelope.

Select the script grp ampenv attack:

42
Now select the next golden knob and do the same procedure as
before, but this time select grp ampenv decay.

For the third knob, select grp ampenv sustain and for the fourth
one grp ampenv release. You now have set up the volume
envelope controls for your instrument.

Note that in the edit section, the group selection area to the right
has updated. All Groups has been selected automatically. That
means, each knob will control the envelope of all groups in your
instrument.

Now we want to add another set of four knobs, this time we choose
the silver version of the metal knob. In the library, go to knobs
metal and drag four knob_metal_silver_minmax knobs onto the
GUI area. It should look like this:

43
Now we want to add filter envelope actions to the silver knobs.

From left to right, click each knob, go to the Action edit field and
from the list choose the filter folder and then select grp fltenv
attack, grp fltenv decay, grp fltenv sustain and grp fltenv
release.

Let's now add a fancy waveform display, which will show the
current zone's sample.

In the library on the left, navigate to the waveform folder.

From that folder (there is currently only one item) drag and drop
waveform display onto the GUI area. It should look like this:

44
Before we carry on, we have to add a filter cutoff knob, a filter
resonance knob and a filter envelope amount knob as well.

From the library, drag and drop one knob_plastic_green_percent,

one knob_plastic_green_posneg and one
knob_plastic_red_percent onto the GUI area.

You might need to re-arrange the other elements to have enough

space around them. It should now look similar to this:

45
Now we need to again assign actions to our fresh new controls.

Select the first green knob (knob_plastic_green_percent) and

assign it the action filter/grp fx filter cutoff.

Click on the second green knob (knob_plastic_green_posneg) and

this time, attach a filter/grp fx filter reso action to it.

The red knob will get the filter/grp fltenv amount action.

So, what's next?

Our instrument could need some effects. Otherwise it would be a

bit boring.

Let's add a convolution reverb, a chorus and a lofi (degrader) effect

to it.

We'll start with the convolution reverb selection menu.

In the library, go to menus and drag in the menu_IR_readout.
This will generate a menu will all entries populated with WAV (IR)
files found in project/Resources/ir_samples. This way, you can
easily switch between them.

But for the convolution reverb effect to work, we will need another
knob to control the send amount to the convolution reverb itself.
(The amount of audio we're feeding into it).

So once again, go to the library and choose the folder knobs

plastic. From there, drag and drop knob_plastic_blue_db12 onto
the GUI area. Position it right above the IR readout menu.

Have it look roughly like this:

46
Granted, we won't win a design-award with that one.

Anyway, we still need to assign a proper action to our blue

convolution reverb send knob. In the edit section at the bottom, go
to Action and from the send fx folder select fx send level irc.

Since this send should work on an instruments basis, we won't use

the grp fx send level irc version.

Let's move on to our chorus and lofi effects.

Drag another two knob_plastic_blue_db12 knobs onto the GUI

area. Position them more or less like this:

47
Editor's note: Can't watch that for long. My eyes hurt.

What's next? You got it: We need to add actions to these two knobs
as well. Select the middle one like in the picture and give it the
groups/group fx lofi srate action. For the blue knob to the right,
locate the send fx/fx send level chorus action and assign it.

Now you might have realized that we have added an action to

control the lofi sample rate with the blue knob in the middle.
While this is no problem at all, the labelling of it is now somewhat
wrong. When we want to control the sample rate, a label with
decibels doesn't make much sense.

48
No worries - we can fix that with one simple step.

Go to the library, go into the knobs plastic folder and look for the
item called knob_plastic_blue_posneg.

Drag it over to the GUI area and drop it directly onto the middle
knob with the wrong label.

Notice that the rectangle around both items will become orange.

Once you've dropped it, the graphic of the knob has changed to
that of the newly dragged item. This can come in handy when you
only want to exchange graphics but not erase the whole item.

So that should be enough for our first instrument, no?

Not quite. We do need a button to enable or disable the lofi effect,

since by default, it is turned off.

From the library, drag the switch called button_1_wh_blue_led

onto the GUI area. You can find it the folder switches.

Position it under the blue sample rate knob in the middle. If you're
having trouble centering it because of the active grid, you can press
<G> on your keyboard to disable it. Then you can position the item
freely. Once done, press <G> again to bring back the grid.

Now we only need to assign the actual lofi enable/disable action to

our new switch. Its located in groups/grp fx enable lofi.

49
So, what else could we do to polish our shiny GUI?
Well, some labels for the knobs would be nice.
Agreed.

Double click on an empy spot in the GUI area to create an editable

text (label) item:

Click on it, to display the edit section for that item at the bottom.
There, go to the Text: field where it says Control Name and click
it. A dialog will pop up and prompt you to enter a new text to
display for that label item. Type in LOFI and press OK.

50
The label has been updated and now reads LOFI. Position it
directly underneath the blue lofi sample rate knob.

Time to add a few more labels!

Once again, doubleclick anywhere in the GUI area without hitting
an existing control to create some more label items.

Position these underneath all the knobs and give them proper
names.

We will need Attack, Decay, Sustain and Release, Cutoff,

Reso, Filter and Env Amount, Reverb, Sample Rate and
Chorus for now:

51
Okay, now it's time to move over to Kontakt itself. Hit the ! button
to restart the Kontakt engine and the script interpreter:

There it is. Our instrument in all its beauty.

What do we have to do now? Import some samples!

But before we do that, let's make sure there aren't any script

52
errors. In Kontakt, click on the wrench icon at the top to flip the
instrument and show the internals:
Scroll down until you see the script edit box.
Hit the little Apply button. In the status line, a message saying
script updated (no errors) should appear:

If thats the case all is good. If thats not the case, please contact
Rigid Audio. We will get back to you.

53
Let's now import some audio files into our instrument, so that we
can actually play it.

In KGM's project folder is a folder called Samples. This is where

all your instruments samples should go. Its a good practice to
create one folder for all the samples of one group. This is handy
when your group has more than one sample for each instrument:

Samples/Bass01/bass_C1.wav
Samples/Bass01/bass_D#1.wav
Samples/Bass01/bass_F#1.wav
Samples/Lead/lead_C1.wav
Samples/Lead/lead_D1.wav
Samples/Lead/lead_E1.wav
Samples/Lead/lead_F1.wav
Samples/Lead/lead_G1.wav

and so on.

In Kontakt, open up the Group Editor. Make sure that the group
called INSTRUMENT 1 is selected (white rectangle). Then click on
the Mapping Editor.

Now drag and drop the demonstration samples from

project/Resources/Samples/DEMO PL Cabernetia Samples into the
mapping editor until it looks like this:

54
Notice that when you drag over these samples, Kontakt will show
you how each sample will be mapped across the keyboard.

In our case each WAV file needs to be mapped onto 3 keys.

(C1, C#1, D1) and so on.

Release the mouse button once the mapping looks like in the
picture above.

You have now succesfully imported your own samples (well, sort of
your own, but you know what we mean) into Kontakt.

You should now be able to play notes on your MIDI keyboard and
already (or should i say finally?) hear something.

Ladies and gentlemen - its time to play around with your

instrument.

55
But wait, whats that?

When you move controls in Kontakt, a message appears:

SCRIPT WARNING: set_engine_par(): non-existent group!

Well, that does make sense since our instrument only has one
group for now which is called INSTRUMENT 1.

To fix this, we go back to KGM and for each control in there we set
it to only control Group 1:

Once that is done, go back to Kontakt and push the ! (engine

restart) button once again so that it will update.

The warning message should be gone.

Note that if you want more than one group for your instrument you
will need to duplicate the group called INSTRUMENT 1 inside
Kontakt.
To do so, go to the Group Editor and locate INSTRUMENT 1 and
then right-click (OSX: <OPTION>+Click) and select Duplicate
group(s). Then it's advisable to rename the group to
INSTRUMENT 2 and so on and so forth.

56
 DISTRIBUTING YOUR INSTRUMENT
In this chapter, we will explain all the steps required to finalize
your product and to prepare it to be distributed or shared with
friends.

The process is as following:

A) In your Kontakt instrument itself (e.g. KGM Template

Instrument.nki) click on the wrench icon on the top left.

Click on "Instrument Options".

In the "Resource Container" section, click on "Create".
Browse to the "KGM_100/project" folder.
In there you have a file called "KGM_Template_Instrument.nkr".
This file is the instrument's resource container.

Double-Click it to update the resource container. This will store all

script files, pictures and impulse responses inside this file.

B) Copy all the *.nki instruments that belong to your package to a

new folder. Call it for example "Release".
Copy the previously updated "KGM_Template_Instrument.nkr" +
*.nkc to it as well.

C) Copy all the samples to your "Release" folder.

(The folder called "Samples" that contains all the samples for
your package).

If you're using Kontakt 4, you will also need to copy the

ir_samples folder (located at project/Resources/ir_samples) to
the Release folder as well.

After that you should now have a release folder that contains just
the project's samples, your resource container files (*.nkr and
*.nkc) and your Kontakt *.nki instrument(s) itself.

Now you can share that folder with your friends (e.g. compress it to
a ZIP file) or distribute and sell it.

57
Note: In case there are "File not found" problems, you should batch
re-save all the instruments:

A) Make sure that the wrench icon is NOT clicked (you can see the
main GUI of your instrument).

B) In Kontakt itself, go to the "Files" dropdown menu at the top.

Choose "Batch re-save".
A warning will pop up - click "Yes" to proceed.
Navigate to your "release" folder with all the instruments in it and
click "Okay".
Kontakt will now re-save the files and fix any missing file problems.
It is also advisable to protect the script files:

In the instrument itself, press the wrench icon again and go to

"Script Editor".
Scroll down and look for the "Edit" button (with a little lock beneath
it).
Click "Edit" and then "Lock with Password".
Enter your password two times (remember it) and press "Okay".
Dont forget to save your instrument again using the Disk symbol
located at the top of Kontakt.

58
 TROUBLESHOOTING & FAQ

---------------------------------------------------------------------------
----------------------------------------------
Does KONTAKT GUI Maker work with the free KONTAKT
Player?
---------------------------------------------------------------------------
----------------------------------------------
No. Youll need fully licensed and registered versions of Kontakt.
(Kontakt 5.5 or Kontakt 4.2).

---------------------------------------------------------------------------
----------------------------------------------
Can i control the Sample Offset (Sample Start)?
---------------------------------------------------------------------------
----------------------------------------------
Yes. Directly via Knobs, Sliders or Faders or via external modulation
(velocity, modwheel, aftertouch).

---------------------------------------------------------------------------
----------------------------------------------
Can i control samples loop points?
---------------------------------------------------------------------------
----------------------------------------------
Not currently.

---------------------------------------------------------------------------
----------------------------------------------
Can i import my own user interface elements?
---------------------------------------------------------------------------
----------------------------------------------
Yes.

59
---------------------------------------------------------------------------
----------------------------------------------
Am i stuck with what is offered in terms of interface
elements?
---------------------------------------------------------------------------
----------------------------------------------
No, you can create and import your own files to the library.

---------------------------------------------------------------------------
----------------------------------------------
Is the library expandable?
---------------------------------------------------------------------------
----------------------------------------------
Yes.

---------------------------------------------------------------------------
----------------------------------------------
Is the script library expandable?
---------------------------------------------------------------------------
----------------------------------------------
Yes.

---------------------------------------------------------------------------
----------------------------------------------
Can i customize action script files?
---------------------------------------------------------------------------
----------------------------------------------
Yes, completely and freely.
Use the <name> tag so that KGM does know where to insert the
currently selected control.

---------------------------------------------------------------------------

60
----------------------------------------------
When i import PNG files to the library they dont show up in
KGM.
---------------------------------------------------------------------------
----------------------------------------------
That is because KONTAKT needs a text file for each PNG file that
describes its behaviour among other things.
You need to make sure that each imported PNG graphic has a
corresponding text file with the same name.
Look into the txt files in the library to get an idea how these files
have to look like.

---------------------------------------------------------------------------
----------------------------------------------
When i import WAV files into the template instrument, i can
t hear no sound at all.
---------------------------------------------------------------------------
----------------------------------------------
Make sure you import your samples into group number 1! (Not
group 0 which is called "DONT ERASE ME").
Always start from that group. If you need more groups, always
duplicate groups starting from group 1, called INSTRUMENT 1.

---------------------------------------------------------------------------
----------------------------------------------
Can i change the PNG file of an user interface element in
KONTAKT GUI Maker?
---------------------------------------------------------------------------
----------------------------------------------
Yes, simply drag a different user interface element (graphic) from
the library on top of the one that you want to change.

---------------------------------------------------------------------------
----------------------------------------------

61
What KONTAKT user interface control elements are
supported?
---------------------------------------------------------------------------
----------------------------------------------
Currently Sliders, Buttons, Switches, Menus, Tables, Level Meters,
Text and Value Edits, Waveforms.

---------------------------------------------------------------------------
----------------------------------------------
Can i change the background image for my KONTAKT
instrument?
---------------------------------------------------------------------------
----------------------------------------------
Yes, simply drag and drop a wallpaper file from the library onto the
KGM GUI area.

---------------------------------------------------------------------------
----------------------------------------------
How can i add my own background images to the library?
---------------------------------------------------------------------------
----------------------------------------------
Copy your (PNG only!) background files to
"library\pictures\wallpaper". Make sure that each file has a
corresponding <name>.txt file with the wallpaper tag set (Type:
wallpaper).

---------------------------------------------------------------------------
----------------------------------------------
I have changed the wallpaper background image in KGM. In
my Kontakt instrument, when i click on engine restart it
does
still show the previous background image. Why?
---------------------------------------------------------------------------
----------------------------------------------

62
When changing background wallpaper images, you will need to
reload the instrument completely.

---------------------------------------------------------------------------
----------------------------------------------
Can i use the template KONTAKT instrument for a
commercial release?
---------------------------------------------------------------------------
----------------------------------------------
Yes.

---------------------------------------------------------------------------
----------------------------------------------
Can i use the bundled scripts and graphics for a commercial
release?
---------------------------------------------------------------------------
----------------------------------------------
Yes.

---------------------------------------------------------------------------
----------------------------------------------
Changes that i have made to my project do not appear inside
KONTAKT.
---------------------------------------------------------------------------
----------------------------------------------
Verify that there are no script errors. Go into KONTAKT and click on
the top wrench icon.
Go to the Script Editor, scroll down to "Edit". The script editor will
open up.
Press the "Apply" button. If there are any errors, it will tell which
one in the status line underneath
the script editor. Please contact us if this happens.

---------------------------------------------------------------------------

63
----------------------------------------------
Can i use my own samples with KONTAKT GUI Maker?
---------------------------------------------------------------------------
----------------------------------------------
KONTAKT GUI Maker doesnt come with samples so - yes!

---------------------------------------------------------------------------
----------------------------------------------
Can i control KONTAKTs LFO functions?
---------------------------------------------------------------------------
----------------------------------------------
Yes. The template KONTAKT instrument comes with two LFOs set
up for you.

---------------------------------------------------------------------------
----------------------------------------------
Is there support for the convolution reverb?
---------------------------------------------------------------------------
----------------------------------------------
Yes.

---------------------------------------------------------------------------
----------------------------------------------
Is there support for KONTAKTs effects?
---------------------------------------------------------------------------
----------------------------------------------
Yes, the complete range of effects is supported.

---------------------------------------------------------------------------
----------------------------------------------
Is KONTAKTs BUS system supported?
---------------------------------------------------------------------------
----------------------------------------------

64
Yes.

---------------------------------------------------------------------------
----------------------------------------------
Can i use my own convolution reverb impulse responses?
---------------------------------------------------------------------------
----------------------------------------------
Yes. Simply copy these to the project/Resources/ir_samples"
folder.

---------------------------------------------------------------------------
----------------------------------------------
Are tables supported?
---------------------------------------------------------------------------
----------------------------------------------
Yes, but currently only rudimentary.

---------------------------------------------------------------------------
----------------------------------------------
Can i use my own fonts for the labels and menus?
---------------------------------------------------------------------------
----------------------------------------------
No, not currently. You would have to design your own PNG files.

---------------------------------------------------------------------------
----------------------------------------------
Is KONTAKT 5.6 supported?
---------------------------------------------------------------------------
----------------------------------------------
No yet, we are working on it.

---------------------------------------------------------------------------
----------------------------------------------

65
Are MIDI controllers supported?
---------------------------------------------------------------------------
----------------------------------------------
Yes.

---------------------------------------------------------------------------
----------------------------------------------
Are send effects supported?
---------------------------------------------------------------------------
----------------------------------------------
Yes.

---------------------------------------------------------------------------
----------------------------------------------
Can i make interface elements automatable?
---------------------------------------------------------------------------
----------------------------------------------
Yes, items are automatable by default.

---------------------------------------------------------------------------
----------------------------------------------
Are multi scripts supported?
---------------------------------------------------------------------------
----------------------------------------------
Not yet.

---------------------------------------------------------------------------
----------------------------------------------
Are values of controls stored within my instrument?
---------------------------------------------------------------------------
----------------------------------------------
Yes, unless you uncheck the "Persist" checkbox in KGM.

66
---------------------------------------------------------------------------
----------------------------------------------
Can i create a KONTAKT instrument without using the
bundled template NKI instrument?
---------------------------------------------------------------------------
----------------------------------------------
Yes, but you will need to make sure that you give all your
modulators inside KONTAKT the correct names, otherwise the
included action scripts will not work. A list of these names will be
released soon.

---------------------------------------------------------------------------
----------------------------------------------
Is KONTAKT GUI Maker KONTAKT 4+ compatible?
---------------------------------------------------------------------------
----------------------------------------------
Yes, the script output does work with KONTAKT 4 unless you use
specific KONTAKT 5 functions / effects.

---------------------------------------------------------------------------
----------------------------------------------
Are menus supported?
---------------------------------------------------------------------------
----------------------------------------------
Yes, KONTAKT GUI Maker comes with PNG image menu generation.

---------------------------------------------------------------------------
----------------------------------------------
Can i control group volume and panning?
---------------------------------------------------------------------------
----------------------------------------------
Yes.

67
---------------------------------------------------------------------------
----------------------------------------------
Can i setup keyboard colours?
---------------------------------------------------------------------------
----------------------------------------------
Currently not. You would need to script that for yourself.

---------------------------------------------------------------------------
----------------------------------------------
Do the instruments made with KONTAKT GUI Maker work
with both Windows and OSX?
---------------------------------------------------------------------------
----------------------------------------------
Yes.

---------------------------------------------------------------------------
----------------------------------------------
Why isnt my instrument appearing as a library in
KONTAKT?
---------------------------------------------------------------------------
----------------------------------------------
Native Instruments does charge a huge amount of money for that
feature.
You will need to contact them directly.

---------------------------------------------------------------------------
----------------------------------------------
Does KONTAKT GUI Maker support multiple instrument
groups?
---------------------------------------------------------------------------
----------------------------------------------
Yes.
---------------------------------------------------------------------------
----------------------------------------------

68
Is there screen zooming in KONTAKT GUI Maker?
---------------------------------------------------------------------------
----------------------------------------------
Yes, use the mousewheel while pressing ALT/OPTION.

---------------------------------------------------------------------------
----------------------------------------------
Can i protect user interface elements from unwanted
editing / positioning?
---------------------------------------------------------------------------
----------------------------------------------
Yes, there is an item lock function. Press <L> on your keyboard to
lock a currently selected item.

---------------------------------------------------------------------------
----------------------------------------------
Is there multi-selection?
---------------------------------------------------------------------------
----------------------------------------------
Not yet.

---------------------------------------------------------------------------
----------------------------------------------
How can in scroll in the library?
---------------------------------------------------------------------------
----------------------------------------------
Simply use the mousewheel.

---------------------------------------------------------------------------
----------------------------------------------
How can i scroll in the action script library window?
---------------------------------------------------------------------------
----------------------------------------------

69
Simply use the mousewheel.

---------------------------------------------------------------------------
----------------------------------------------
Can i load an existing script from a different KONTAKT
instrument?
---------------------------------------------------------------------------
----------------------------------------------
Yes, but it is not guaranteed to work since KGM was made to work
for and with the bundled template KONTAKT instrument. So we
cannot recommend that.

---------------------------------------------------------------------------
----------------------------------------------
Can i play more than one sound / group at the same time?
---------------------------------------------------------------------------
----------------------------------------------
Yes, use group playback actions for this. Refer to the chapter
Playback groups.

---------------------------------------------------------------------------
----------------------------------------------
Can i make a fullblown instrument with tons of sounds using
KONTAKT GUI Maker?
---------------------------------------------------------------------------
----------------------------------------------
Yes.

---------------------------------------------------------------------------
----------------------------------------------
Do i have to pay royalties or license fees when i distribute
my own instruments made with KONTAKT GUI Maker?
---------------------------------------------------------------------------
----------------------------------------------

70
No.

---------------------------------------------------------------------------
----------------------------------------------
I have imported my own PNG image into the library but it
looks kind of destroyed (random pixels everywhere). Why?
---------------------------------------------------------------------------
----------------------------------------------
Most likely you have saved your PNG image with 32 bits truecolour.
KGM only supports a colour-depth of 16 or 24 bits. Also make sure
your image-strips are horizontally.

---------------------------------------------------------------------------
----------------------------------------------
The controls in my instrument do not change/update when i
change e.g. the "default value" in KGM. Why?
---------------------------------------------------------------------------
----------------------------------------------
KONTAKT stores these values initially and sets up the controls
accordingly. Values of knobs and sliders will be stored
within the instrument. In this case you would need to adjust the
control manually in your KONTAKT instrument.
(Dont forget to save your instrument(s) afterwards).

---------------------------------------------------------------------------
----------------------------------------------
I am getting an "The application cannot be openened error
(OSX). What's the reason for that?
---------------------------------------------------------------------------
----------------------------------------------
As it seems, this is a general problem with newer OS X operating
systems and happens from time to time. A few tips and help:

71
https://support.apple.com/kb/PH21769?locale=en_US
https://www.cnet.com/news/tutorial-what-to-do-when-a-mac-os-x-
application-will-not-launch/
http://help.yoyogames.com/hc/en-us/articles/216753558-My-app-
won-t-open-when-downloaded-from-the-internet
http://www.cultofmac.com/224876/safely-install-non-mac-app-
store-apps-on-your-mac-os-x-tips/

---------------------------------------------------------------------------
----------------------------------------------
My question isn't answered here.
---------------------------------------------------------------------------
----------------------------------------------
Please send an email to questions@rigid-audio.com.
We will get back to you within one working day.

72
 KEY COMMANDS

Grid Size (X&Y): <1>,<2>,<3> and <4>

Hide Controls: <C>
Hide Labels: <B>
Lock Item: <L>
Grid On/Off: <G>
Delete Item: <BACKSPACE> / <DEL>
Cancel: <ESCAPE>
Confirm: <ENTER>
Move Items: <ARROW KEYS>
Zoom: <ALT> (<OPTION>) + Mousewheel
Quit KGM: <ESCAPE>

73
 LEGAL DISCLAIMER

Kontakt GUI Maker (KGM), including all of it's components and

any additional files included with the distribution, is protected by
copyright law and international copyright treaties. You are free to
use Kontakt GUI Maker (KGM) on as much computers as you
prefer, if they do belong to yourself or your development team.
Also, you may make one copy of Kontakt GUI Maker (KGM) solely
for archival or backup purposes.

Except as provided in the agreement, you receive no rights to

transfer, rent, lease, lend, copy, modify, market, transmit or reverse
engineer Kontakt GUI Maker (KGM), any component hereof, or
any file provided with the distribution.

Kontakt GUI Maker (KGM), and any files included with the
distribution, including sampled sounds and presets, is licensed but
not sold to you, for use in software instrument design and the
development of your own Kontakt instruments. You can use all
provided graphics and scripts for commercial distribution.

Kontakt GUI Maker (KGM), any component hereof, and any files
distributed with it, is provided "as is", and there is no warranty of
any kind, either express or implied - including, but not limited to,
the implied warranties of merchantability and fitness for any
particular purpose. The risk as to the quality and performance of
the program is with you, and Rigid Audio will not be held
responsible for any damage or loss, to your person or property, as
incidential or consequential result of installing or using this
software.

All logos and/or trademarks shown or referred to in this manual or

on the website are the property of their respective owners.

Feb 2017
Rigid Audio

74
 CREDITS

Kontakt GUI Maker (KGM) was developed and designed by

Dennis Lenz @ Rigid Audio using
YoYo Games Game Maker: Studio Professional.

We hope you enjoy KGM.

Feel free to send bug reports, suggestions and more to:

questions@rigid-audio.com

Also, please don't forget to visit us online:

http://www.rigid-audio.com

RIGID AUDIO 2017. All Rights reserved.

75