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	✔️	✔️	✔️	✔️
Cyclop	-	-	-	-	7	-
DB-33	✔️	✔️	✔️	✔️	✔️	✔️
Diva	-	-	-	-	✔️	✔️
EightyEight	✔️	✔️	✔️	✔️
Hive	✔️	✔️	✔️	✔️	✔️	✔️
Hybrid	✔️	✔️	✔️	✔️	✔️	✔️
iris 2	✔️	✔️	✔️	✔️1	✔️	✔️
Keyscape	✔️	✔️	✔️	✔️	✔️	✔️
Loom	✔️	✔️	✔️	✔️	✔️	✔️
LuSH-101	✔️	✔️4	✔️	✔️	✔️	✔️
Mini V2	-	-	-	-	✔️	✔️
MiniGrand	✔️	✔️	✔️	✔️	✔️	✔️
Spark	-	-	-	-	✔️	✔️
Serum	✔️	✔️	✔️	✔️	✔️	✔️
Spire 1.0.x	✔️	✔️2	✔️	✔️	-	-
Spire 1.1.x	✔️	✔️2	✔️	✔️1	✔️	✔️
Strike	✔️	✔️	✔️	✔️	✔️	✔️
Structure	✔️	✔️	✔️	✔️	✔️	✔️
Synth Anthology 2	✔️	✔️	✔️	✔️	✔️	✔️
SynthMaster2	✔️	✔️2	✔️	✔️	✔️	✔️
theRiser	✔️	✔️	✔️	✔️	✔️	✔️
Twin 2	✔️	-	✔️	-	-	-
V-Station	✔️	✔️	✔️	✔️
Vacuum Pro	✔️	✔️	✔️	✔️	✔️	✔️
Velvet	✔️	✔️	✔️	✔️	✔️	✔️
Xpand!2	✔️	✔️	✔️	✔️1	✔️	✔️

Plugin name(root of bankchain) or vendor name were changed from original name, beacuse resource folder name can not contain some characters.
Contributed from Kymeia@NI Forum.
Temporary build. Parameter mapping is not optimized yet.
Based on tomduncalf/ubermap.
Custom build options are available, see $.buildOpts in tasks/lush101.coffee.
Exporting feature is currently experimental.
Discontinued for some reasons.

Build Instructions

Software Requirements

git
nodejs

I recommend to use nvm. shellscript nvm install v5 nvm use v5 *Some tasks will may not work on node v6.x.x due to dep issue. Please use node v5.x.x

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.

Edit parameter mappings in Komplete Kontrol, and save preset as _Default.nksf.
Execute following command to generate src/Serum/mappings/default.json
```
gulp serum-generate-default-mapping
```
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
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.

fyyyyy/nks-presets-collection