miguelguthridge / universal-controller-script

A free and open source program that integrates with FL Studio to provide deep integration between hardware controllers and software.

Universal Controller Script

A free and open source program that integrates with FL Studio to provide deep integration between hardware controllers and software.

Quick Links

• Read the setup instructions

• Download the latest release

• Join the Discord server for troubleshooting help and to give feedback on the project

• Read the documentation for information how you can use the software and contribute to the project

Supported Devices

The following devices have full support with the script.

Akai

• MPK Mini Mk3

Korg

• NanoKontrol

M-Audio

• Hammer 88 Pro (no LED support, because M-Audio refuses to provide documentation)

Novation

• Launchkey Mk2

• Launchkey Mk3

• Launchkey Mini Mk3

• SL Mk3 (no screen support yet, but most other things work)

Supported Plugins

The following plugins have full support with the script.

FL Studio Windows

• Channel Rack (step sequencer and omni preview)

• Mixer

• Playlist (tool selection)

• Piano Roll (tool selection)

FL Studio Plugins

• FLEX

• FPC

• Harmless

• Parametric EQ 2

• Transistor Bass

• Fruity Slicer

• Slicex

VST Plugins

• Vital by Matt Tytel

• Spitfire Audio plugins

• XFER

  • OTT

  • Serum

• Klevgrand DAW Cassette

• Any plugins with MIDI learn support (CC messages will be automatically forwarded)

Want to help out?

I'd love to have your support! Here's what you can do to help:

• Contribute code to the project: see the documentation for detailed instructions, and feel free to reach out on the Discord server if you need a hand.

• Help with plugin support: join the Discord server and let me know! You'll just need to follow some simple instructions.

• Help with device support: join the Discord server and let me know! You'll probably need to spend some time in a video call with me so we can try and get things working together.

• Help fund my work: you don't have to, but buying me some pasta is a great way to show some love! I want to try to give everyone the same high quality software so don't expect much more than a thankyou, but I really would appreciate it!

universal-controller-script's Issues

Plugin request: Klevgrand Speldosa

Rename the script

The name Universal Controller Script is descriptive, but not creative. It would be nice to have a new name that is a little more fun.

Currently I don't have any ideas, but I'll keep thinking about it. If you have any, feel free to reply on this issue to suggest them!

Clicking reload script with Hammer 88 Pro causes all events to be ignored

Describe the bug
A clear and concise description of what the bug is.

To Reproduce
Steps to reproduce the behavior:

1. Connect a Hammer 88 Pro
2. Click reload script from within the script output

Expected behavior
The script continues to function correctly

Actual behavior
All events are ignored by the script - FL Studio's default MIDI support is used instead

Environment:

• OS: Windows
• Version: 11
• FL Studio Version: 21.0.2]
• Script version: 1.2.0

Master controls are broken in mixer

src/plugs/windows/mixer.py line 135

Support for colour transparency

Performance mode support

Add support for per-device velocity mapping

CC calculations for master faders is identical to those for fader 1 when doing manual mapping

Need to redo the way that it's calculated

Use reflection for event and tick filters to unify them

Support drum pad after touch

Master faders and knobs don't work correctly on the mixer

Add support for mocking events, and add a mock device

This would be very helpful for testing features within FL Studio if the feature requires a control that isn't present on any existing devices

Add support for plugin preset navigation

Add a mapping strategy to map next/previous button to next/previous buttons.

Also make sure that left/right and up/down buttons map to next/previous by default.

It is impossible to manually assign master faders and master knobs

Add screenshots of working configurations

I'm looking to get screenshots of FL Studio's MIDI settings window for each device, showing the correct configuration. Each screenshot should have parts of the configuration that users need to change underlined with red.

• Novation Launchkey Mk3 Mini
• Novation Launchkey Mk3
• Novation Launchkey Mk2
• Novation SL Mk3
• M-Audio Hammer 88 Pro
• Akai MPK Mini Mk3
• Korg NanoKontrol

For example:

Add option to have mixer tracks follow selection more closely

Use a strategy pattern to control how the selection is determined.

• Current strategy (loose follow)
• New strategy (close follow), ensures current selection is always first track in mapped tracks

Window switchers are utterly broken on Launchkey Mk3 series

Describe the bug
When the device select button is used, the window switcher doesn't render until momentarily when the button is released

Things that aren't the problem

• Shift matcher works correctly
• Color events are sent at right time

Photos/Videos
https://youtu.be/IEQMk0acABw

Environment:

• OS: Windows
• Version: 10, 22H2
• FL Studio Version: 21.0.2
• Script version: 1.2.0-beta.5

Graph editor support for channel rack

Cannot use generator plugins outside of the current group

Currently, the script uses group indexes for generator plugins. Refactor it to use global indexes.

Device: Novation Impulse

Add mapping to check which mixer tracks are linked

Pressing the control switch button should show a highlight for which mixer tracks are currently linked with the controller

Slicer improvements

• Use note names to determine which notes are in use
• Allow for jumping up and down between values (controlling more than just the first 16 slices)

[Hammer 88 Pro] Pedal appears to be inverted when using the provided preset

The provided device presets appear to cause an issue where the sustain pedal is inverted each time the device is turned on.

This could be a device firmware issue, but appears to not happen when the presets aren't in use.

To fix this issue, open the device presets and check over how they handle the pedals. Look to see if anything is broken.

Add config option to map undo-redo button to just undo

Revamp contributor documentation

Essentially make it more approachable and easy to understand

Lights don't turn off when switching to an unsupported plugin/window

This should be fixed by making the defaults plugin be used as a fallback rather than as the default.

It is impossible to control the master mixer track with main faders

Make it track the docking side of the track selection

Pitch bend doesn't work nicely in some VST plugins

Need to figure out how to get the values to play nice in VSTs, since it seems to only set it within a range +- 1/12 of a semitone?

Disconnecting device during playback leads to strange playhead behaviour

When closing FL Studio, devices might not shut down correctly

Describe the bug
If the event forwarder script shuts down before the main script, the main script cannot forward messages to it, meaning that the device cannot be shut down.

To Reproduce
Steps to reproduce the behavior:

1. Close FL Studio
2. If it doesn't happen try again
3. And again
4. And again...

Expected behavior
The device consistently shuts down (leaving DAW mode)

Actual behavior
Sometimes the device stays in DAW mode

Rename "plugins" to "integrations" to reduce confusion

Add tool selector

Some controls don't work for LkMk3

Click button: forwarded 0xBF 0x4C

Quantize button: forwarded 0xBF 0x4B

Undo button: forwarded 0xBF 0x4D

Make sure to double check these

Window switcher controls

Add support for Novation Launchpad Mini Mk2

Describe the bug
I'm having a problem with the Launchpad Mini MK2 and the NanoKontrol Studio
The script says the device is not recognized and I can't get it to light up or control any parameter in the DAW.

Errors

• Launchpad:
  Failed to recognize device
  Error details: DeviceRecognizeError('Device not recognized, using device name 4- Launchpad Mini')
• Nanokontrol:
  Failed to recognize device
  Error details: DeviceRecognizeError('Device not recognized, using response pattern [0xF0, 0x7E, 0x00, 0x06, 0x02, 0x42, 0x37, 0x01, 0x00, 0x00, 0x04, 0x00, 0x01, 0x00, 0xF7]')

Photos
Here's the image showing the settings I have in the DAW

Environment:

• OS: Windows
• Version: 11
• FL Studio Version: 21.0.3
• Script version: 1.2.1

Additional context
I've installed all drivers and the controllers work on Ableton

Investigate MIDI-learn functionality

• It should work by default, does it?

Allow for overriding default positions for controls

This will allow users with hardware issues to add workarounds for them, so they can continue to use their device

Cannot activate effect plugins through the activity switcher

Create better issue templates

Wow it is very tedious creating all these issues by hand, we need some good templates

• Integration request
• Device request
• Bug report
• Default template

Add support for pitch wheel scrolling

[Novation LK Mk3] Add support for remaining buttons

• Device select
• Device lock
• Arm/select

Add support for pick-up when adjusting parameters

Allow window switcher to switch between recent plugins

Requires modification of the activity tracker

Novation Launchkey Mk2 25 is Broken

Awaiting details

Using pedals when changing between plugins causes issues

• Make it possible to auto-disable controls when a plugin becomes inactive

Device: Novation SL Mk3

• Basic Controls
  • Drum pads
  • Faders
  • Transport
  • Encoders
  • Mute/solo buttons
  • Tool selector buttons
• Lighting
  • Drum pads
  • Faders
  • Transport
  • Encoders
  • Mute/solo buttons
  • Tool selector buttons
• Display
• Other modes?
  • Investigate
    • Do they exist?
    • How do they work?
  • Implement

Plugin request: Decent sampler

Forward CCs? Macros?

MIDI CC forwarding to VST Plugins that don't easily map for specific parameters

If an exception is raised when initialising a recognised device, a misleading error is given

For example port mix-ups

To fix, add new exception type that has better handling of this case.

Add Novation Launchpad X support