# NKS - Details
{% hint style="info" %}
This page contains technical details of the Native Kontrol Standard. As a legal disclaimer, I do not have access to the specification from Native Instruments and all the information is based on my own research.
{% endhint %}
## What is NKS?
I assume you already know about NKS, the Native Kontrol Standard. If not, I recommend you look at a brief overview on the [Native Instruments Website.](https://www.native-instruments.com/en/specials/komplete/this-is-nks/)
## Details about NKS
NKS consists of several parts:
* A preset file (.nksf for Instruments, .nksfx for Effects)
* A directory structure where the preset files and metadata information are stored
* Several metadata files
* A central database where favourites are stored and preset names/banks are cached
## NKS Preset Files
NKS preset files are [RIFF](https://en.wikipedia.org/wiki/Resource_Interchange_File_Format) files with 4 sections:
* A Summary Information Section, which contains data like the preset author, comments, bank information, types, modes and vendor name
* A Controller Assignments Section, where the controller pages are stored
* A Plugin ID section, where the plugin ID is stored to the software can load the correct plugin
* A Plugin Chunk section, where the plugin specific preset information is stored
## Directory Structure
The user content directory contains sub-directories which specify the plugin name. Each plugin directory has one sub-directory per bank. Finally, in each bank directory, the NKS files are stored.
If the bank contains instruments, it might contain audio previews in an additional subdirectory named `.previews`. Audio Previews are stored in the `.ogg` format, consisting of the full NKS filename appended with `.ogg`.
To my knowledge, audio previews are not possible for Effects.
## Metadata Files
Metadata files are plugin specific and contain information about the Plugin name displayed on the NI Hardware, image files and color settings.
These metadata files are usually stored in the public documents folder, typically found in `C:\Users\Public\Documents\NI Resources`.
| Folder or File | Description |
| ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \_DatabaseResources\color\color.db | A SQLite Database containing entries for all plugin colors used for Maschine and the Visual Browser. This database is managed by Maschine / Komplete Kontrol and should left untouched.
MST\_bgcolor
Maschine Studio Background Color (probably also for MK3)
VB\_bgcolor
Visual Browser Background Color (= in Maschine and KK software)
|
| \_DatabaseResources\shortname\shortname.db | A SQLite Database containing name variations of the plugin. This database is managed by Maschine / Komplete Kontrol and should left untouched.
MKII\_shortname
The name displayed on Maschine MK2 (and maybe MK1 as well?
MST\_shortname
The name displayed on Maschine Studio and MK3
MIKRO\_shortname
The name displayed on Maschine Mikro
VB\_shortname
The name displayed in the visual browser
|
| database\pal\categories.db | A SQLite Database containing categories, information about plugins and groups.
Currently it is not known for what purpose it is used, as the actual data about presets, plugins, groups and categories is stored in AppData\Local\Native Instruments\Maschine 2\komplete.db3 for Maschine and AppData\Local\Native Instruments\Komplete Kontrol\komplete.db3 for Komplete Kontrol.
|
| dist\_database\\\\\\\\ | categories.json
Contains information about the plugin categories
color.json
Contains the background color for the visual browser, not sure if it can also contain the background color for Maschine Studio
shortname.json
The shortnames for different hardware (see above)
\.meta
A metadata file containing vendor and product name
|
| image\\\\\\\\ | \.meta
A metadata file containing vendor and product name
MST\_artwork.png
A 134x66 pixel PNG image containing the artwork displayed when using the Maschine Studio/MK3 plugin browser
MST\_logo.png
A 240x96 pixel PNG image containing the logo displayed in the Maschine Studio/MK3 preset browser.
MST\_plugin.png
A 190x75 pixel PNG image displayed when viewing the plugin chain on the Maschine Studio/MK3 hardware
OSO\_logo.png
A 417x64 pixel PNG image. Currently unknown where this is used.
VB\_artwork.png
A 96x47 pixel PNG image displayed in the visual browser.
VB\_logo.png
A 279x47 pixel PNG image displayed as bank header when browsing a plugin for presets.
|
| | |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://presetmagician.gitbook.io/help/old/faq/nks.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.