Learn Raspberry Pi Debug Interface

Getting Started

Welcome to RNBO


RNBO Basics

Key Differences

Why We Made RNBO


Audio IO

Messages to rnbo~

Using Parameters


Messages and Ports

Polyphony and Voice Control

Audio Files in RNBO

Using Buffers

Using the FFT

Export Targets

Export Targets Overview

Max External Target
Raspberry Pi Target
The Web Export Target
The C++ Source Code Target

Code Export

Working with JavaScript
Working with C++

Special Topics

Sample Accurate Patching
Scala and Custom Tuning

RNBO and Max for Live

RNBO Raspberry Pi OSCQuery Runner

Raspberry Pi Debug Interface


Export Description

Raspberry Pi GPIO

Updating the RNBO Package

Raspberry Pi Debug Interface

The RNBO Runner on the Raspberry Pi can be controlled directly using OSCQuery, by sending messages over HTTP, UDP or WebSockets .

The OSCQuery package, which allows users to interact with the OSC namespace of RNBO patches running on the Raspberry Pi, includes an easy-to-use debug interface that can be accessed from a web browser called the rnbo-runner-panel. This debug interface exposes some of the most useful parts of the exported RNBO patcher through a simple interface.

Accessing the Debug Interface

The RNBO disk image for the Raspberry Pi includes this debug interface, and runs an HTTP server that serves the page on port 3000. The interface can be accessed using either the device hostname or IP address followed by the port number. So if your pi had the hostname c74rpi and the IP address , then from any device on your local network you could visit http://c74rpi:3000 or to see this page. The Raspberry Pi configuration page in the export sidebar includes a link to the debug interface, and you can click on this link to launch the page in your default browser.


After a successful export to the Raspberry Pi, you will also see an Open Interface button that will open the debug interface in your default browser.



The primary purpose of this page is to help debug a RNBO export once it's running on a Raspberry Pi. It provides a simple interface to most of the endpoints exposed by the RNBO Runner. The interface should automatically include any parameters, inports, and outports in your RNBO patch. Note that this interface is not really intended to be used in a performance, and is mostly a thin wrapper around a handful of API calls to the RNBO Runner.

How to find out more

The debug interface is just one way to query and control the exported patch using OSCQuery. Any application that can interface with the runner over HTTP, UDP or WebSockets can interact with the exported patch in the same way. If you wanted to build your own custom web interface, you could fork the RNBO Runner Debug Interface repository and modify it however you want. Of course, a website is just one possible interface. See the OSCQuery reference guide for more information about how to query the RNBO Runner, and how to control it.