m1no · May 3, 2025 10:12 · m1no · Aug 14, 2023 · amrmjd · Aug 14, 2023
diff --git a/motu-bridge.js b/motu-bridge.js
 // MOTU Ultralite-mk5 API Bridge
 // Author: mino
 // Date: 2023-02-22
 // License: MIT
 //
 // Description:
 // ------------
 // I was looking for a easy way to mute and umute my main speakers via a Stream Deck button on the MOTU Ultralite-mk5. 
 // Unfortunately, Motu does not provide an HTTP API for this series, this feature is only available on the AVB devices.
 // But with a bit of tinkering and reverse engineering of the Motu CueMix 5 app, it is possible to understand the used protocols and to send arbitrary commands. 
 // A quick and dirty program was written to allow the user to toggle the mute state of the main output of the device with automation in mind (e.g. Stream Deck).
 //
 // Installation:
 // ------------
 // Install Node.js and the depdenencies "ws" and "http" with "npm install ws http".
 //
 // Usage:
 // ------
 // Start the server with "node motu-bridge.js" and then call the server with a GET request to the endpoint /toggleMuteMain to toggle the mute state of the main output of the device.
 //
 // Reverse engineering of the Motu Mk5 API:
 // ----------------------------------------
 // MOTU provides at this time for the Ultralite-mk5 only a Windows application called "CueMix 5". 
 // This app is based on Electron and uses in the background a WebSocket connection to communicate with the device over its own network interface.
 // By further looking into the installed source code of the app, as the app is not obfuscated, it is possible to run the index.html in a browser with enabled developer tools.
 // In the developer tools, the network tab can be used to debug the WebSocket traffic between the app and the device and obtain the binary codes that are sent to the device for the different actions.

 let motu_device_ip = '169.254.23.124';
 let motu_device_port = '1280' // On my Windows machine, but another user had to change this to 1281 on his Mac

 const http = require('http');
 const WebSocket = require('ws');
 let messageIndex = 0;

 const server = http.createServer((req, res) => {
  if (req.url === '/toggleMuteMain' && req.method === 'GET') {
    res.writeHead(200, { 'Content-Type': 'text/plain' });
    messageIndex = (messageIndex + 1) % 2;
    let muteToggle = getMuteToggle(messageIndex);
    sendToMotu(muteToggle);
    res.end();
  } else {
    res.writeHead(404, { 'Content-Type': 'text/plain' });
    res.write('Not found.\n');
    res.end();
  }
 });

 server.listen(3000, () => {
  console.log('Server running at http://localhost:3000');
  console.log('[GET] ToggleMute Endpoint: http://localhost:3000/toggleMuteMain');
 });

 function sendToMotu(binaryCode) {
  const ws = new WebSocket(`ws://${motu_device_ip}:${motu_device_port}`);
  ws.binaryType = 'arraybuffer';
  
  ws.on('open', () => {
    console.log('WebSocket connection opened.');
    const buffer = hexStringToBuffer(binaryCode);
    const arrayBuffer = bufferToArrayBuffer(buffer);
    ws.send(arrayBuffer, { binary: true });
  });
  ws.on('close', () => {
    console.log('WebSocket connection closed.');
  });
  return ws;
 }

 function hexStringToBuffer(hexString) {
  return Buffer.from(hexString, 'hex');
 }

 // Convert a Buffer object to an ArrayBuffer
 function bufferToArrayBuffer(buffer) {
  return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
 }

 function getMuteToggle(index) {
  // 03fb0012000101 mute main output
  // 03fb0012000100 unmute main output
  return index === 0 ? '03fb0012000100' : '03fb0012000101';
 }
	// MOTU Ultralite-mk5 API Bridge
	// Author: mino
	// Date: 2023-02-22
	// License: MIT
	//
	// Description:
	// ------------
	// I was looking for a easy way to mute and umute my main speakers via a Stream Deck button on the MOTU Ultralite-mk5.
	// Unfortunately, Motu does not provide an HTTP API for this series, this feature is only available on the AVB devices.
	// But with a bit of tinkering and reverse engineering of the Motu CueMix 5 app, it is possible to understand the used protocols and to send arbitrary commands.
	// A quick and dirty program was written to allow the user to toggle the mute state of the main output of the device with automation in mind (e.g. Stream Deck).
	//
	// Installation:
	// ------------
	// Install Node.js and the depdenencies "ws" and "http" with "npm install ws http".
	//
	// Usage:
	// ------
	// Start the server with "node motu-bridge.js" and then call the server with a GET request to the endpoint /toggleMuteMain to toggle the mute state of the main output of the device.
	//
	// Reverse engineering of the Motu Mk5 API:
	// ----------------------------------------
	// MOTU provides at this time for the Ultralite-mk5 only a Windows application called "CueMix 5".
	// This app is based on Electron and uses in the background a WebSocket connection to communicate with the device over its own network interface.
	// By further looking into the installed source code of the app, as the app is not obfuscated, it is possible to run the index.html in a browser with enabled developer tools.
	// In the developer tools, the network tab can be used to debug the WebSocket traffic between the app and the device and obtain the binary codes that are sent to the device for the different actions.

	let motu_device_ip = '169.254.23.124';
	let motu_device_port = '1280' // On my Windows machine, but another user had to change this to 1281 on his Mac

	const http = require('http');
	const WebSocket = require('ws');
	let messageIndex = 0;

	const server = http.createServer((req, res) => {
	if (req.url === '/toggleMuteMain' && req.method === 'GET') {
	res.writeHead(200, { 'Content-Type': 'text/plain' });
	messageIndex = (messageIndex + 1) % 2;
	let muteToggle = getMuteToggle(messageIndex);
	sendToMotu(muteToggle);
	res.end();
	} else {
	res.writeHead(404, { 'Content-Type': 'text/plain' });
	res.write('Not found.\n');
	res.end();
	}
	});

	server.listen(3000, () => {
	console.log('Server running at http://localhost:3000');
	console.log('[GET] ToggleMute Endpoint: http://localhost:3000/toggleMuteMain');
	});

	function sendToMotu(binaryCode) {
	const ws = new WebSocket(`ws://${motu_device_ip}:${motu_device_port}`);
	ws.binaryType = 'arraybuffer';

	ws.on('open', () => {
	console.log('WebSocket connection opened.');
	const buffer = hexStringToBuffer(binaryCode);
	const arrayBuffer = bufferToArrayBuffer(buffer);
	ws.send(arrayBuffer, { binary: true });
	});
	ws.on('close', () => {
	console.log('WebSocket connection closed.');
	});
	return ws;
	}

	function hexStringToBuffer(hexString) {
	return Buffer.from(hexString, 'hex');
	}

	// Convert a Buffer object to an ArrayBuffer
	function bufferToArrayBuffer(buffer) {
	return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
	}

	function getMuteToggle(index) {
	// 03fb0012000101 mute main output
	// 03fb0012000100 unmute main output
	return index === 0 ? '03fb0012000100' : '03fb0012000101';
	}