Skip to content

Config

Jump to bottom
Robin Calvin edited this page Mar 19, 2024 · 16 revisions

Configuration

  • The nanometer script can easily be configured through the config.py file which contains various options and settings that can be enabled or disabled.

  • Edit config.py in a text-editor of your choice (i.e. Notepad in Windows works fine). Some options takes a numeric value while others consist of a statement that tells the script whether that option is True or False.

Notes:

  1. True and False must always begin with capital letters to be recognized correctly. If you write it: "true" or "FALSE" etc, the option will simply be ignored and will fall back to its default value.

  2. The nanometer script needs to be restarted for any changes you've made to take effect. You can restart the script from the Script output window which is located in FL Studios View-menu.

MIDIChannel

Values accepted: Default value: Description:
1 to 16 1 This tells the script which MIDI channel is used for communication with the nanoKONTROL2 unit. Don't change this unless you know what you're doing.

TransportChan

Values accepted: Default value: Description:
1 to 16 14 The MIDI channel used for the transport controls. Don't change this unless you have a reason to.

SleepTimer

Values accepted: Default value: Description:
0 to 300 5 The number of minutes before the nanometer script enters the pause mode. Setting this to 0 will disable the pause-mode.

PlayBlinkTempo

Values accepted: Default value: Description:
True or False True This enables/disables the flashing of the Play button during playback. If you set this to False, the Play button will stay lit during playback and the Record button will instead flash in sync with the tempo during recording.

BlinkFullTempo

Values accepted: Default value: Description:
True or False False This changes the speed of the flashing of the Play/Record button (depending on the option PlayBlinkTempo). If you set this to True, the flashes will be synced to full tempo. When set to False the flashes will instead be synced to half tempo.

ModeBlink

Values accepted: Default value: Description:
True or False True This enables/disables the flashing effect on the transport buttons when switching modes with the Cycle button.

PeakMeter

Values accepted: Default value: Description:
True or False True This enables/disables the peak meter light function. Set this to False if you don't want the Solo, Mute and Rec button lights to be used as a peak meter.

PlayingOnly

Values accepted: Default value: Description:
True or False False If you set this to True, the peak meter will only react to sounds while pattern/song mode is playing.

ReversePeak

Values accepted: Default value: Description:
True or False False Set this to True if you want the peak meter lights to move in the reverse direction (right to left).

BigMeter

Values accepted: Default value: Description:
True or False False If set to True, this option will replace the stereo/mono lightbars with one big lightbar that uses all 3 lightrows.

Clipping

Values accepted: Default value: Description:
True or False True Enables or disables the clipping feature of the peak meter lightbars. The peak meter reacts to sounds between -48dB to 0dB. When a sound goes above 0dB (i.e is "clipping"), the script will leave the last light on the peak meter lit for 3 seconds to indicate that the signal was clipping. Set this to False if you don't want the lights to react this way when the audiosignal is clipping.

SelectedPeak

Values accepted: Default value: Description:
True or False False By default, the peak meter will only react to sound coming out of the master track in the mixer. Set this to False to make it react to the currently selected track instead, i.e. you can set which track should be the active "peak meter track" by just clicking on it in the mixer.

MixerMode

Values accepted: Default value: Description:
True or False True This enables/disables the mixer controls. Set this to False if you for some reason don't want/need to control the mixer from the nanoKONTROL2.

ArmedTracks

Values accepted: Default value: Description:
True or False False Decides what the R-buttons in the 8 control groups should be used for. Enable this to use the R-buttons for arming tracks instead of just selecting tracks.

MultiSelect

Values accepted: Default value: Description:
True or False False Enables or disables multiple track selection. Enable this if you want to select more than one track at a time with the R-buttons. This option only works if "ArmedTracks" is set to False.

ExclusiveSelect ** DEPRECATED **

Values accepted: Default value: Description:
True or False True Enables or disables exclusive track selection. Disable this if you want to select more than one track at a time with the R-buttons. This option is deprecated since v1.3. Use MultiSelect instead.

TrackRangeOnly

Values accepted: Default value: Description:
True or False False By default, the PREV/NEXT TRACK buttons can be used to select any track in the mixer. This option (when enabled) will limit the selection to the mixertracks currently controlled by the nanoKONTROL2.

StickyMaster

Values accepted: Default value: Description:
True or False False Setting this to True will lock the master track to the first control group.

RangeDisplayRect

Values accepted: Default value: Description:
True or False True This toggles whether the mixer tracks controlled by the script should be marked with a red rectangle that doesn't interfere with the tracks coloring. Set this to False if you want the script to use the ColoredRange option instead.

RangeRectTimer

Values accepted: Default value: Description:
0 to 10 0 Sets the number of seconds the mixer controls can stay idle before the RangeRectDisplay rectangle is hidden. If set to 0, the RangeRectDisplay rectangle will be visible permanently.

ColoredRange

Values accepted: Default value: Description:
True or False True This enables/disables the coloring of the mixertracks controlled by the nanoKONTROL2. If you feel that the coloring clashes with your own color scheme, you can disable it with this option.

HighlightColor

Values accepted: Default value: Description:
-15461356 to -1 -11835046 This sets the color of the mixer tracks controlled by the script. Please see the FAQ page for more details.

BracketedRange

Values accepted: Default value: Description:
True or False True By default, the script will add brackets to the names of the controlled tracks to make them more easy to identify. Disable this if you don't want the brackets.

PreserveMixDiff

Values accepted: Default value: Description:
True or False False Sets the default behaviour of the multi volume control. Setting this to True will stop all the mixer tracks when the loudest track reach +5.6dB. This also reverses the function of the Set Marker button (i.e. hold it down to NOT preserve the volume).

ChannelrackMode

Values accepted: Default value: Description:
True or False True This enables/disables the channelrack controls. Set this to False if you for some reason don't want/need to control the channelrack from the nanoKONTROL2.

ChannelRectCtrl

Values accepted: Default value: Description:
True or False False Sets the default behaviour of the Channel Rectangle. Setting this to True will enable the channel rectangle when the script starts.

PlaylistMode

Values accepted: Default value: Description:
True or False True This enables/disables the playlist controls. Set this to False if you for some reason don't want/need to control the playlist from the nanoKONTROL2.

TempoBase

Values accepted: Default value: Description:
10 to 397 80 This affects the tempo-knob in the Playlist control-mode. The knob has a range of 125 BPM which means that if you set a base value of 100, the knob will be able to change the tempo between 100 to 225 BPM.

ControllerLinkMode

Values accepted: Default value: Description:
True or False False This enables/disables the controller link mode. Set this to True if you want an extra control mode that gives exclusive control over the linked buttons, sliders and knobs. This only works if "LinkOverriding" is set to False.

LinkOverriding

Values accepted: Default value: Description:
True or False False If enabled, this will make it possible to link buttons, sliders and knobs directly from any mode without holding down the Cycle button at the same time. Use with caution as the links will override the scripts normal functions.

TranspBtnLink

Values accepted: Default value: Description:
True or False False By default, the transport buttons cannot be linked while the script is active. If you wish to link the transport buttons to other things, set this option to True. CAUTION: the transport buttons will be unassigned by default if this is used as the same time as "LinkOverriding" or when using the Controller Link Mode.

Support for multiple units ** EXPERIMENTAL **

The options below can be used to set up additional nanoKONTROL2 units with the script. These options should be omitted when only one unit is installed. Please read more about using additional units here.

MIDIChannel_Unit2

Values accepted: Default value: Description:
1 to 16 N/A This tells the script which MIDI channel is used for communication with the second nanoKONTROL2 unit.

MIDIChannel_Unit3

Values accepted: Default value: Description:
1 to 16 N/A This tells the script which MIDI channel is used for communication with the third nanoKONTROL2 unit.

MIDIChannel_Unit4

Values accepted: Default value: Description:
1 to 16 N/A This tells the script which MIDI channel is used for communication with the fourth nanoKONTROL2 unit.

TransportChan_Unit2

Values accepted: Default value: Description:
1 to 16 N/A The MIDI channel used for the transport controls on the second nanoKONTROL2 unit.

TransportChan_Unit3

Values accepted: Default value: Description:
1 to 16 N/A The MIDI channel used for the transport controls on the third nanoKONTROL2 unit.

TransportChan_Unit4

Values accepted: Default value: Description:
1 to 16 N/A The MIDI channel used for the transport controls on the fourth nanoKONTROL2 unit.

Port_Unit2

Values accepted: Default value: Description:
0 to 255 N/A The PORT number in FL Studio used for the second nanoKONTROL2 unit.

Port_Unit3

Values accepted: Default value: Description:
0 to 255 N/A The PORT number in FL Studio used for the third nanoKONTROL2 unit.

Port_Unit4

Values accepted: Default value: Description:
0 to 255 N/A The PORT number in FL Studio used for the fourth nanoKONTROL2 unit.

Table of contents

Clone this wiki locally