nks-presets-collection

NKS(Native Kontrol Standard) presets collection

Fully assembled NKSF files can be downloaded from here.

Status

(28167-5331)/28551 (80%)

	raw presets	mappings	meta	resources	.adg 6	.bwpreset 6
Alchemy	✔️	✔️	✔️	✔️	✔️	✔️
AnalogLab	✔️	✔️	✔️	✔️	✔️	✔️
AnalogLab 2	✔️	3	✔️	✔️	✔️	✔️
BassStation	✔️	✔️	✔️	✔️	7	7
Cyclop	-	-	-	-	7	7
DB-33	✔️	✔️	✔️	✔️	✔️	✔️
Diva	-	-	-	-	✔️	✔️
EightyEight	✔️	✔️	✔️	✔️	7	7
Hive	✔️	✔️	✔️	✔️	✔️	✔️
Hive2	-	-	-	-	✔️	✔️
Hybrid	✔️	✔️	✔️	✔️	✔️	✔️
iris 2	✔️	✔️	✔️	✔️1	✔️	✔️
Key Suite Digital	✔️	✔️	✔️	✔️1	✔️	✔️
Keyscape 5	8	✔️	✔️	✔️	✔️	✔️
KORG Gadget	-	-	-	-	✔️	✔️
Loom	✔️	✔️	✔️	✔️	✔️	✔️
LuSH-101 5	✔️	✔️4	✔️	✔️	✔️	✔️
Mini V2	-	-	-	-	✔️	✔️
MiniGrand	✔️	✔️	✔️	✔️	✔️	✔️
Ohmicide	✔️		✔️
Repro-1	-	-	-	-	✔️	✔️
Repro-5	-	-	-	-	✔️	✔️
Serum	8	✔️	✔️	✔️	✔️	✔️
SerumFX
Spark	-	-	-	-	✔️	✔️
SparkVerb	8	✔️	✔️	✔️	✔️	✔️
Spire 1.0.x	✔️	✔️2	✔️	✔️	-	-
Spire 1.1.x	✔️	✔️2	✔️	✔️1	✔️	✔️
Strike	✔️	✔️	✔️	✔️	✔️	✔️
Structure	✔️	✔️	✔️	✔️	✔️	✔️
Stutter Edit
Synth Anthology 2	✔️	✔️	✔️	✔️1	✔️	✔️
SynthMaster2	8	✔️2	✔️	✔️	✔️	✔️
theRiser	✔️	✔️	✔️	✔️	✔️	✔️
Thorus	8	✔️	✔️	✔️	✔️	✔️
Twin 2	✔️	-	✔️	-	-	-
V-Station	✔️	✔️	✔️	✔️	7	7
Vacuum Pro	✔️	✔️	✔️	✔️	✔️	✔️
Velvet	✔️	✔️	✔️	✔️	✔️	✔️
Xpand!2	✔️	✔️	✔️	✔️1	✔️	✔️

1. Plugin name(root of bankchain) or vendor name were changed from original name, beacuse resource folder name can not contain some characters.
2. Contributed from Kymeia@NI Forum.
3. Temporary build. Parameter mapping is not optimized yet.
4. Based on tomduncalf/ubermap.
5. Custom build options are available, see $.buildOpts in tasks/*.coffee.
6. Exporting feature is currently experimental.
7. Discontinued for some reasons.
8. build directly from vendor's patch files.

Build Instructions

Software Requirements

• git
• node.js

I recommend to use nvm.

# I have no plan to migrate this project to gulp4, so need to stay v10.
nvm install v10
nvm use v10

• gulp

  npm install gulp-cli -g
  

Cloning this repository

git clone https://github.com/jhorology/nks-presets-collection.git

# install dependencies
cd nks-presets-collection
npm install

Configuration

Modify configuration file config.coffee and configuration section of each plugin's task file 'tasks/*.coffee' to suit your environment.

Workflows

In case of Serum.

• I want to use own mappings.

1. Edit parameter mappings in Komplete Kontrol, and save preset as _Default.nksf.

2. Execute following command to generate src/Serum/mappings/default.json

   gulp serum-generate-default-mapping
   

3. Edit src/Serum/mappings/default.json whatever you want. (Optional) - Sorry, I can't say nothing about json format, because officially not opened. Following command may help you. shellscript gulp serum-print-default-mapping

4. Execute following command to build and deploy presets to your environment.

   gulp serum-deploy-presets
   

• I want to categorize presets by own policy.

  1. Edit each .meta files in src/Serum/presets folder. It's a nightmare.

  2. Another option is modifying serum-generate-meta task of tasks/serum.coffee.

  • Sorry again, I can't say nothing about meta format, because officially not opened. Following command may help you.

  gulp serum-print-default-meta
  

  For some more information, refer to gulp-nks-rewrite-meta.

  1. Execute following command to generate meta files in src/Serum/presets folder.

     gulp serum-generate-meta
     

  2. Execute following command to build and deploy presets to your environment.

     gulp serum-deploy-presets
     

How-to

• How to automate saving preset in Komplete Kontrol.

  • I'm using Keybord Maestro. Example macro files exits in src/Velvet/macros and src/Serum/macros.
  • Caution, executing macro without adjusting mouse positions is very danger.

• How to rip raw preset files.

  • from Komplete Kontrol .nksf file
    • Please see the example task velvet-extract-raw-presets.
    • For some more information, refer to gulp-riff-extractor.
  • from Ableton Live rack .adg file
    • Please see the example task analoglab-extract-raw-presets.
    • It doesn't work on windows, because using shell script 'adg2pchk'.
  • from Bitwig Studio .bwpreset file
    • Please see the example task xpand2-extract-raw-presets.
    • It doesn't work on windows, because using shell script 'bwpreset2pchk'.

• How to auto generate meta information.

  • Many plugin vendors uses SQLite database for own plugin browser.
  • Please see the example task serum-generate-meta and analoglab-generate-meta.

What is NKSF File (Unofficial)

NKSF file is the only type of RIFF (Resource Interchange File Format). File has 4 chunks inside.

  - NISI  (Native Instruments Summary Information)
  - NICA  (Native Instruments Controller Assignments)
  - PLID  (Plugin ID)
  - PCHK  (Plugin Chunk)

*naming is my guess.

It seems that first 3 chunks are encoded using MessagePack. PCHK chunk is the only pluginstates.

License

Raw preset data (*.pchk files) and some image files are not my property. I'm not a lawyer, but I think the use of these come under fair-use.

Download files are completely free under your own responsibility if you trust and believe fair-use. And of course you must be a legal user of these VSTi plugins.

All other script codes are licensed under MIT.