Repository navigation
feat: Add comprehensive device parameter access beyond remote control limitations #15
Description
Hi there. This is an amazing project with so much possibilities. The most exciting aspect would be opening up the internal parameters of Bitwig devices (or VST's if they expose any) to AI-based sound design, effectively programming these devices via prompts. Below is an AI generated description I created after checking out the repo. Not sure if the assumptions are correct.
I may try to create a POC out of it, I think this feature would be a game changer.
🎯 Feature Request: Comprehensive Device Parameter Access
Problem Statement
Currently, WigAI can only access device parameters through remote control pages, limiting AI agents to 8 parameters per page. This severely restricts AI-driven sound design capabilities, as most devices have 50-300+ internal parameters that remain inaccessible.
Proposed Solution
Implement direct access to ALL device parameters using Bitwig's internal parameter API methods, bypassing remote control page limitations entirely.
Technical Approach
Instead of relying on cursorDevice.createCursorRemoteControlsPage(128), use direct parameter access:
// Current limitation (Epic 2 implementation):
RemoteControlsPage deviceParameterBank = cursorDevice.createCursorRemoteControlsPage(128);
// Proposed enhancement:
public List<InternalParameterInfo> getAllDeviceParameters() {
List<InternalParameterInfo> params = new ArrayList<>();
Device device = cursorDevice;
// Direct parameter enumeration (needs API research)
for (int i = 0; i < getDeviceParameterCount(); i++) {
Parameter param = device.getParameter(i); // or similar method
if (param.exists()) {
params.add(new InternalParameterInfo(
i,
param.name().get(),
param.value().get(),
param.displayedValue().get(),
param.getUnit(),
param.getMinValue(),
param.getMaxValue()
));
}
}
return params;
}Benefits
- 🚀 Complete Parameter Universe: Access to 100s of parameters vs 8
- 🎵 True AI Sound Design: AI can manipulate every aspect of a device
- ⚡ Simpler Architecture: No page navigation complexity
- 🔄 Immediate Access: No UI state dependencies
API Enhancement Proposal
Add new MCP tools:
get_all_device_parameters- Returns ALL device parametersset_device_parameter_by_name- Set parameters by name (more intuitive)get_device_parameter_metadata- Get parameter constraints and units
Example Output
{
"device": "Wavetable",
"total_parameters": 247,
"parameters": [
{
"index": 0,
"name": "Osc1.Wavetable.Position",
"value": 0.5,
"display_value": "50%",
"unit": "%",
"min_value": 0.0,
"max_value": 1.0
},
{
"index": 1,
"name": "Osc1.Unison.Voices",
"value": 0.3,
"display_value": "3 voices",
"unit": "voices",
"min_value": 1,
"max_value": 16
}
// ... 245 more parameters
]
}Implementation Plan
- Research exact Bitwig API methods for direct parameter access
- Create
InternalParameterControllerclass - Implement parameter enumeration and access methods
- Add new MCP tools for comprehensive parameter control
- Update documentation and tests
Research Sources
- Bitwig Controller Scripting Tutorial confirms
getParameter()method exists - Multiple sources confirm direct parameter access bypasses remote control limitations
Relationship to Existing Roadmap
This enhancement would:
- Complement Epic 8: Provide alternative to complex page navigation
- Extend Epic 2: Enhance current parameter control with comprehensive access
- Enable Epic 9: Advanced AI sound design capabilities
Impact
This would make WigAI the most comprehensive AI-DAW integration available, enabling true AI-driven sound design that's impossible in other DAWs due to their closed architectures.
Activity
zsoltcs1123 commentedon Aug 14, 2025
Ok, I just realized the AI hallucinated a bit as on the page linked the
getparameter()method is still within the context of a remote page. bummer.zsoltcs1123 commentedon Aug 14, 2025
🎯 OFFICIAL CONCLUSION:
YES, comprehensive parameter access IS possible! Not through direct internal parameter access, but through multiple parameter page types:
✅ Available Parameter Access:
setParameterPage(int)getEnvelopeParameter(int)getCommonParameter(int)previousParameterPage(),nextParameterPage()🚀 Potential Parameter Count:
fabb commentedon Aug 15, 2025
getEnvelopeParameterandgetCommonParameterare deprecated.It would be great to be able to modify parameters without switching between remote control pages, but i‘m not yet sure if that is possible. Open for suggestions!
Ideally all MCP tool calls would work independent of the current UI state (except when targeting the currently selected device/track/clip), so tool calls can work independent of the parallel without getting into each other’s way. But not sure if that‘s how the bitwig api works.
zsoltcs1123 commentedon Aug 15, 2025
Oh you can certainly create a parameter bank for any device on any track, not just the currently selected one. That's something the Bitwig API is capable of. I've done it in some of my controller scripts. You can also target any page on that bank without switching pages on the UI. Let me see if I can dig up some examples!
fabb commentedon Aug 15, 2025
Thank you!
fabb commentedon Aug 15, 2025
Btw I now added feature/bug ticket templates with some rules for AI to keep the tiresome enthusiasm of Sonnet and others down and the output short ;-)
zsoltcs1123 commentedon Aug 15, 2025
Yeah sorry about that! I was in a hurry.
Here's what I dig up from my Controller Script. It is in Javascript, but it's subset of what a Java extension can do, so in theory anything that's possible in a script should be possible in an extension.
This is from the
init()method:`...
`
So you create a
trackbankwith all the tracks in the project. Then you get a reference to thecurrentTrackby index. This is different than the user selected track!So next what you do is create separated variables for the different Remote Control Pages by calling
createCursorRemoteControlsPageand the setting theselectedPageIndexon each. So now you have reference to all pages!zsoltcs1123 commentedon Aug 15, 2025
You can do the same on Devices. Continuing the script:
// Setup child track 1 controls childTrack1 = childTrackBank.getItemAt(0); // Track-level remote controls (middle row knobs page 0, faders page 1) childTrack1RemotePage0 = childTrack1.createCursorRemoteControlsPage("Child1Page0", 8, null); childTrack1RemotePage0.selectedPageIndex().set(0); childTrack1RemotePage1 = childTrack1.createCursorRemoteControlsPage("Child1Page1", 8, null); childTrack1RemotePage1.selectedPageIndex().set(1); // Primary device remote controls (bottom row knobs page 0, buttons page 1) childTrack1PrimaryDevice = childTrack1.createCursorDevice("Primary"); childTrack1PrimaryDevicePage0 = childTrack1PrimaryDevice.createCursorRemoteControlsPage("Child1PrimaryPage0", 8, null); childTrack1PrimaryDevicePage0.selectedPageIndex().set(0); childTrack1PrimaryDevicePage1 = childTrack1PrimaryDevice.createCursorRemoteControlsPage("Child1PrimaryPage1", 8, null); childTrack1PrimaryDevicePage1.selectedPageIndex().set(1);This is navigating to child track 1 inside the currentTrack and then setting track-level and Primary Device Remote controls using the same method.
And when I'm handling the incoming MIDI I'll just route it to the Remote Page I want to control
`
// Handle MUTE button
if (note === NOTE.MUTE) {
if (DEBUG) {
host.println('MUTE button pressed - note=${note}, NOTE.MUTE=${NOTE.MUTE}');
}
const muteParam = currentTrackRemotePage1.getParameter(0);
if (muteParam.exists().get()) {
const currentValue = muteParam.value().get();
const newValue = currentValue > 0 ? 0 : 127;
muteParam.value().set(newValue, 128);
`
(sorry about the formatting idk whats wrong)
fabb commentedon Aug 15, 2025
Ah thanks, there are 2 overloads of
createCursorRemoteControlsPage, one with 1 parameter, and one with 3 parameters, and the one with 3 parameters does NOT correspond to the one selected in bitwig:vs. the one with 1 parameter:
Thanks, will look into this!
fabb commentedon Aug 15, 2025
Hm, somehow changing between pages does not work. I tried like this:
But the
deviceParameterBank.selectedPageIndex().set(p)seems not to have an impact, and then I just get the params of the first page repeated a few times (as often as there are pages) :-/fabb commentedon Aug 16, 2025
Looks like it’s a common problem: https://youtu.be/Mg12mR9RSus
The timeout of 500ms used in the solution in the video is a problem though when requesting the parameters synchronously. On the discord server i heard the solution can be buggy too.
zsoltcs1123 commentedon Aug 19, 2025
In this code:
`
currentTrackIndex =1
// Setup track bank
trackBank = host.createTrackBank(8, 0, 0, false);
currentTrack = trackBank.getItemAt(currentTrackIndex);
// Setup current track remote controls (top row knobs -> page 0)
currentTrackRemoteControls = currentTrack.createCursorRemoteControlsPage("TopKnobs", 8, null);
currentTrackRemoteControls.selectedPageIndex().set(0);
// Setup current track remote controls page 1 (MUTE/SOLO buttons -> page 1)
currentTrackRemotePage1 = currentTrack.createCursorRemoteControlsPage("MuteSolo", 8, null);
currentTrackRemotePage1.selectedPageIndex().set(1);
`
Setting the page works and it stays set... maybe because I have different variables for each? idk... but I can route the incoming MIDI to the appropriate page no problem... been using this script and it works
zsoltcs1123 commentedon Aug 19, 2025
Ideally bitwig should fix these stupid limitations. And expose ALL internal params of the devices too. That could make them the first AI - enabled Sound Design environment ever... I hope they realize this.
fabb commentedon Aug 19, 2025
I asked support and they replied that they don’t offer support for the controller extension api, but they will look into it if they have time.
fabb commentedon Aug 19, 2025
You need to use 3 ` characters for code blocks:
https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#quoting-code
fabb commentedon Aug 19, 2025
Maybe it’s a timing issue because I’m changing the page index in a loop and the bitwig api needs some time to switch the page asynchronously? I hope not, because then I would need to change the while MCP tool response to work asynchronously.
glassdimly commentedon Oct 17, 2026
We've implemented this as far as the API allows, in PR #21 and in a fork with releases: https://github.com/glassdimly/wigai-full
get_device_parameters/set_device_parametersread and write every remote-control page of any device on any track, by parameter name or by page + index, without moving the user's selection. Parameters that aren't on any remote-control page are still out of reach; the API doesn't expose them.On the timing question above: yes, page switching is asynchronous. Waiting synchronously inside the tool call works fine: select the page, poll
selectedPageIndex()until it reports the new page, then read. One more catch:value().set()is silently ignored for these controls, whilesetImmediately()works.We'd prefer this merged here and the fork deleted.
fabb commentedon Oct 18, 2026
@glassdimly very nice! Unfortunately i don’t have the time to maintain this repo and verify PRs in Bitwig anymore, especially since i don’t use this extension actively. I should update the readme accordingly and mention some forks as replacement, like yours. The way of open source i guess.