Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
FL Studio Python scripting for MIDI controller development, piano roll manipulation, Edison audio editing, workflow automation, and FLP file parsing with PyFLP. Use for programmatic configuration, device customization, MIDI transport, macros, and save file manipulation. Covers all 427+ API functions across 14 MIDI scripting modules plus piano roll, Edison, and PyFLP contexts.
FL Studio Python scripting for MIDI controller development, piano roll manipulation, Edison audio editing, workflow automation, and FLP file parsing with PyFLP. Use for programmatic configuration, device customization, MIDI transport, macros, and save file manipulation. Covers all 427+ API functions across 14 MIDI scripting modules plus piano roll, Edison, and PyFLP contexts.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Complete reference for FL Studio's Python API: MIDI controller scripting (14 modules, 427+ functions), piano roll note manipulation, Edison audio editing, and FLP file parsing with PyFLP.
FL Studio 20.8.4+, Python 3.6+
import general print(f"API Version: {general.getVersion()}")
Place scripts in Shared\Python\User Scripts folder.
Purpose: Control FL Studio through hardware MIDI controllers and send feedback to devices. Runs: Continuously while FL Studio is open. Available modules: transport, mixer, channels, arrangement, patterns, playlist, device, ui, general, plugins, screen, launchMapPages, utils, callbacks Entry points: def OnInit(): """Called when script starts.""" pass def OnDeInit(): """Called when script stops.""" pass def OnMidiMsg(msg): """Called for incoming MIDI messages.""" pass def OnControlChange(msg): """Called for CC messages.""" pass def OnNoteOn(msg): """Called for note-on messages.""" pass def OnRefresh(flags): """Called when FL Studio state changes.""" pass
Purpose: Manipulate notes and markers in the piano roll editor. Runs: Once when user invokes through Scripts menu. Available modules: flpianoroll, enveditor import flpianoroll score = flpianoroll.score for note in score.notes: note.velocity = 0.8 # Set all velocities to 80%
Purpose: Edit and process audio samples in Edison. Runs: Once within Edison's context. Available modules: enveditor
Navigate to the appropriate reference file based on what you need to control. Read these files ONLY when you need specific API signatures.
ModuleFunctionsWhat It ControlsReferencetransport20Play, stop, record, position, tempo, loopingapi-transport.mdmixer69Track volume/pan/mute/solo, EQ, routing, effectsapi-mixer.mdchannels48Channel rack, grid bits, step sequencer, notesapi-channels.md
ModuleFunctionsWhat It ControlsReferencearrangement + patterns9 + 25Markers, time, pattern control, groupsapi-arrangement-patterns.mdplaylist41Playlist tracks, live mode, performance, blocksapi-playlist.md
ModuleFunctionsWhat It ControlsReferencedevice34MIDI I/O, sysex, dispatch, hardware refreshapi-device.md
ModuleFunctionsWhat It ControlsReferenceui + general71 + 24Windows, navigation, undo/redo, version, snapapi-ui-general.md
ModuleFunctionsWhat It ControlsReferenceplugins13Plugin parameters, presets, names, colorsapi-plugins.md
ModuleFunctionsWhat It ControlsReferencescreen + launchMapPages9 + 12AKAI Fire screen, launchpad page managementapi-screen-launchmap.md
ModuleFunctionsWhat It ControlsReferenceutils + constants21Color conversion, math, note names, MIDI tablesapi-utils-constants.md
ModuleFunctionsWhat It ControlsReferencecallbacks26All callback functions, FlMidiMsg class, event flowapi-callbacks.md
Note, Marker, ScriptDialog, score classes for piano roll manipulation plus Edison enveditor utilities. See piano-roll-edison.md
External library for reading/writing .flp project files without FL Studio running. Batch processing, analysis, automated generation. See pyflp.md
# name=My Controller # url=https://example.com import device import mixer import transport def OnInit(): if device.isAssigned(): print(f"Connected: {device.getName()}") def OnDeInit(): print("Script shut down") def OnControlChange(msg): if msg.data1 == 7: # Volume CC mixer.setTrackVolume(mixer.trackNumber(), msg.data2 / 127.0) msg.handled = True def OnNoteOn(msg): track = msg.data1 % 8 mixer.setActiveTrack(track) msg.handled = True def OnRefresh(flags): pass # Update hardware display here
def OnInit(): if not device.isAssigned(): print("No output device linked!") return # Safe to use device.midiOutMsg() etc.
def OnControlChange(msg): if msg.data1 == 7: mixer.setTrackVolume(0, msg.data2 / 127.0) msg.handled = True # Prevent FL Studio from also processing this
def OnRefresh(flags): if device.isAssigned(): # Update volume fader LED vol = int(mixer.getTrackVolume(0) * 127) device.midiOutMsg(0xB0, 0, 7, vol) For complete examples (MIDI learn, scale enforcer, LED feedback, batch quantization, sysex handling, performance monitoring, automation engine, debugging): See examples-patterns.md
Cache module references at top level (import once) Avoid tight loops in MIDI callbacks (keep under 10ms) Batch UI updates; use device.directFeedback() for controller echo
Always check device.isAssigned() before device functions Implement two-way sync for all controls (send feedback on state change) Test on real hardware (virtual ports behave differently)
Separate MIDI mapping from business logic (use a controller class) Keep callbacks responsive; offload complex work Handle edge cases: invalid indices, missing devices, out-of-range values
Check device.isAssigned() returns True Verify MIDI input port in FL Studio MIDI Settings Ensure callback functions are defined at module level (not nested) Check MIDI message status bytes match expected values
Verify script is in Shared\Python\User Scripts folder Ensure a pattern is open in piano roll before running Access notes via flpianoroll.score.notes
Avoid complex calculations inside OnIdle() (called every ~20ms) Don't repeatedly query values that haven't changed Use device.setHasMeters() only if peak meters are needed
Double-click detection: Use device.isDoubleClick(index) Inter-script communication: Use device.dispatch(ctrlIndex, message) LED control: device.midiOutMsg(0x90, 0, note, velocity) for note-on LEDs processMIDICC vs OnControlChange: Use On* callbacks for modern code GUI access: Limited through ui module; full UI automation not available Multiple devices: Check device.getName() to identify, handle per-port
Official FL Studio API: https://www.image-line.com/fl-studio/modules/python-scripting/ PyFLP GitHub: https://github.com/demberto/PyFLP API Functions: 427+ across 14 modules | Last Updated: 2025
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.