Korg nanoKONTROL2 and Wirecast 6

I'm hoping this guide will get you started with your Korg nanoKONTROL2 as a hardware switching panel for Wirecast 6. The first thing you need to know is that all of this is based on the TTFN midi work and has been modified by me for newer hardware and software. 

If you have any questions about this stuff, you can shoot me an email or comment at the bottom and I'll try to see what I can do for you. Should you have any improvements, let me know as it would be great to improve this over time.

Anyway, let's get started...

Things to buy

All you need to spend money on is the nanoKONTROL2 and Wirecast 6, however my guess is that you have already bought at least one them. Everything else is free.

If you haven't already bought the Korg nanoKONTROL2, you can pick it up on Amazon here (affiliate link).

Things to download

Follow all the links to download what you need:
(1) My tweaked version of TTFN Midi (zipped file)
(2) Korg KONTROL Editor (for making your own custom layout)
(3) MidiPipe (this passes the Midi commands to the TTFN application)

(You can download all the original TTFN work here if you want to start from scratch instead).

Setting up the hardware

Plug in your nanoKONTROL2 and open the 'korg-sample-layout.nktrl2_data' file within download 1 above. Use these default settings for now to get going. 

To load the settings onto your device, choose Communication > Write Scene Data. I'll show you how to make custom settings later.

The default mapping looks like this:

Remember: You only need to run this file when making changes to you nanoKONTROL2 - not every time you use it to switch.


Now it's time to launch 'TTFN Midi Setup.mipi' from within download 1 from earlier. You will need to run this every time you want to use the nanoKONTROL2 alongside Wirecast.

Make sure that the MIDI Input option is set to 'nanoKONTROL2 - SLIDER/KNOB' as seen below.

MidiPipe in action


Next, launch the TTFN Midi app (within download 1). Again, this must be open every time you want to use your nanoKONTROL2 with Wirecast.

Try pressing some buttons on your nanoKONTROL2 and you should already start to see some things happening within TTFN Midi.

For a full overview of this excellent piece of software, check out this video:

TTFN Midi overview (I recommend starting at 5:50 to jump straight to the app overview)

Wirecast time

This is possibly the most tedious part as it requires some naming conventions that you need to stick to for the switching to work. 

All shots, lower thirds, logos, etc need to be given their correct name or else you'll get an error in the TTFN Display Log.

To help out, I have included the names in the 'Wirecast Shot Names' column in the table later in this guide.

A quick look at what shots should be named - Click to expand! 

Modifying the buttons

You probably don't want to have your nanoKONTROL2 work the same way as mine, so this part will hopefully be a pretty comprehensive guide to what each button can be programmed to control.

To do this, open 'korg-sample-layout.nktrl2_data' in the original zipped download file. From here, all you have to do is click on any of the buttons to start editing.

Use the Korg KONTROL Editor to make your dream switching panel!

In the tables below, you will see all of the settings that you need to add into the Korg KONTROL Editor. Make sure you pay close attention to the naming within the 'Wirecast Shot Name' column.

I've grouped the following into sections based on what the button will actual do within Wirecast.

Main Controls

Wirecast Action Assign Type Button Behavior CC/Note Number Off Value On Value
Recording Start/Stop Control Change Toggle 44 0 127
Take/Cut Control Change Momentary 45 0 127
Auto On/Off Control Change Toggle 46 0 127
Streaming Start/Stop Control Change Toggle 49 0 127
Smooth On/Off Control Change Toggle 22 0 127

General switching

Wirecast Shot Name Assign Type Button Behavior CC/Note Number Off Value On Value
Shot 1 Control Change Momentary 33 0 127
Shot 2 Control Change Momentary 34 0 127
Shot 3 Control Change Momentary 35 0 127
Shot 4 Control Change Momentary 36 0 127
Shot 5 Control Change Momentary 37 0 127
Shot 6 Control Change Momentary 38 0 127
Shot 7 Control Change Momentary 39 0 127
Shot 8 Control Change Momentary 40 0 127
Shot 1b Control Change Momentary 23 0 127
Shot 2b Control Change Momentary 24 0 127
Shot 3b Control Change Momentary 25 0 127
Shot 4b Control Change Momentary 26 0 127
Shot 5b Control Change Momentary 27 0 127
Shot 6b Control Change Momentary 28 0 127
Shot 7b Control Change Momentary 29 0 127
Shot 8b Control Change Momentary 30 0 127
Lower Third 1 Control Change Toggle 2 0 127
Lower Third 2 Control Change Toggle 3 0 127
Lower Third 3 Control Change Toggle 4 0 127
Lower Third 4 Control Change Toggle 5 0 127
Lower Third 5 Control Change Toggle 6 0 127
Lower Third 6 Control Change Toggle 7 0 127
Lower Third 7 Control Change Toggle 8 0 127
Lower Third 8 Control Change Toggle 9 0 127
Lower Third 9 Control Change Toggle 10 0 127
Lower Third 10 Control Change Toggle 11 0 127
Logo 1 Control Change Toggle 41 0 127
Logo 2 Control Change Toggle 31 0 127
Video Intro Control Change Momentary 47 0 127
Video Outro Control Change Momentary 48 0 127

Best for the top row of rotatory buttons

Wirecast Action Knob/Slider Enable CC Number Left/Lower Value Right/Upper Value
Transition Speed Enable 13 0 127

That's it

I really hope that helped you out and should give you something to go and have a play with. I've been using my setup for live editing and streaming for a while now and everything seems to be workings really well.

Like I mentioned, get in touch with any thoughts/questions!