Though we can always console.log in the MIDI Remote Script Console, chances are, especially when dealing with complex situations, that we want to somehow copy/paste the output of this console.
Sometimes we want to grab a very specific processValue, and it can get tedious to rewrite it by hand, other times, we may want to inspect elements, such in the case of latest additions to MIDI Remote API.
Anyway, I’ve prepared a tiny HTML file, which when opened in Chromium based browsers (Chrome, Edge, don’t know about others) will try to listen to MIDI Ports and log in its page, the MIDI Messages. At the same time, when getting a sysEx of the format [0xF0,0x7F,0x00,ascii code char 1, ASCII code char 2,…,0xF7], it will recognise its content as a string and log it properly.
Here’s the code of the HTML:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>MIDI Logger</title>
</head>
<body>
<h2>MIDI Logger</h2>
<h3>Please use loopBack ports (e.g. loopMIDI)</h3>
<h3>Use sysex of the format [0xF0,0x7F,0x00,your ASCII byte1, your ASCII byte2,...,0xF7] to log messages</h3><br><br>
<p id="status">Waiting for MIDI...</p>
<pre id="log"></pre>
<script>
const statusEl = document.getElementById("status");
const logEl = document.getElementById("log");
function logMessage(message) {
console.log(message);
logEl.textContent += message + "\n";
logEl.scrollTop = logEl.scrollHeight;
}
function handleMIDIMessage(event) {
const data = Array.from(event.data);
if (data[0] === 0xF0 && data[1] === 0x7F && data[2] === 0x00 && data[data.length - 1] === 0xF7) {
// Extract middle bytes (ASCII payload)
const payload = data.slice(3, -1);
const text = String.fromCharCode(...payload);
logMessage("SysEx Text Received: " + text);
} else {
logMessage("Other MIDI: " + data.map(x => x.toString(16).padStart(2,"0")).join(" "));
}
}
function onMIDISuccess(midiAccess) {
statusEl.textContent = "MIDI ready!";
for (let input of midiAccess.inputs.values()) {
logMessage(`Listening to: ${input.name}`);
input.onmidimessage = handleMIDIMessage;
}
}
function onMIDIFailure(err) {
statusEl.textContent = "MIDI failed.";
logMessage("Error: " + err);
}
if (navigator.requestMIDIAccess) {
navigator.requestMIDIAccess({ sysex: true }).then(onMIDISuccess, onMIDIFailure);
} else {
statusEl.textContent = "Web MIDI API not supported.";
}
</script>
</body>
</html>
And here’s a snippet demonstrating logging using sysex:
var midiremote_api = require('midiremote_api_v1')
var deviceDriver = midiremote_api.makeDeviceDriver("Test","Log Using Sysex","m.c")
var midiInput = deviceDriver.mPorts.makeMidiInput("anInput")
var midiOutput = deviceDriver.mPorts.makeMidiOutput("anOutput")
var detectionUnit=deviceDriver.makeDetectionUnit()
detectionUnit.detectPortPair(midiInput, midiOutput)
.expectInputNameEquals("Bome MIDI Translator 1")
.expectOutputNameEquals("loopMIDI Port")
var surface=deviceDriver.mSurface
var mapping=deviceDriver.mMapping
var button=surface.makeButton(0,0,1,1)
button.mSurfaceValue.mMidiBinding
.setInputPort(midiInput)
.bindToControlChange(0,0)
var label=surface.makeLabelField(1,0,4,1)
var page=mapping.makePage('Default')
page.setLabelFieldText(label,"Hello SysEx")
var selectedTrack=page.mHostAccess.mTrackSelection.mMixerChannel
selectedTrack.mOnTitleChange=function(activeDevice,activeMapping,trackName){
logBySysex(activeDevice,trackName)
}
button.mSurfaceValue.mOnProcessValueChange=function(activeDevice,value,diff){
if(value==1){
logBySysex(activeDevice,"Hello SysEx :)")
}
}
function logBySysex(activeDevice,textMessage){
console.log(textMessage)
var sysexMessage = [0xF0, 0x7F, 0x00].concat(textMessage.split('').map(function(c) {var code=c.charCodeAt(0); return code<=127 ? code : 32;})).concat([0xF7])
midiOutput.sendMidi(activeDevice,sysexMessage)
}
And here’s a short video demonstrating logging:
