baton

Relay messages between UDP and a websocket. Faster together.

This code base has been developed by ZKM | Hertz-Lab as part of the project »The Intelligent Museum«.

BSD Simplified License.

Description

This script acts as a websocket relay server which creates a local websocket and forwards messages to/from a set of UDP ports. This is useful for creative coding tools which work with OSC (Open Sound Control) messages natively, but do not have built-in websocket support.

Dependencies

Python 3
websockets library

Setup

Install Python 3, if not already available. For instance, on macOS using Homebrew:

brew install python3

Create a virtual environment and install the script's dependencies:

make

Running

Next, start the server on the commandline via the virtual environment wrapper script:

./baton

It can simply sit in the background and automatically handles the websocket connection. Websocket clients can then connect to send/receive messages while baton is active.

To configure the send/receive address and ports, see the commandline argument help for baton by running:

./baton -h

Defaults are:

websocket: ws://localhost:8081
udp recv: 127.0.0.1 9999
udp send: 127.0.0.1 8888

Note: To connect external devices to the machine running baton, "localhost" cannot be used and only clients running on the same machine will be able to connect. Use the network IP address or local DNS hostname instead for baton and both local and remote clients, ie. 192.168.0.101, etc.

To stop baton, use CTRL+C to issue an interrupt signal.

Calling Python script directly

The Python script can be called directly without the wrapper script, but requires manually enabling or disabling the virtual environment:

Aactivate the virtual environment before the first run in a new commandline session:

source venv/bin/activate

Use:

./baton.py -h

When finished, deactivate the virtual environment with:

deactivate

Example Clients

A couple of example clients are included:

html/client: HTML+JS websocket client, open index.html in your browser
pd/osclient.pd: Pure Data patch which sends and receives OSC messages over UDP

Both examples should work together with the default address & ports on the same localhost:

pd/client.pd <-UDP-> baton.py <-WS-> html/client/index.html

First start baton, then start the clients. If the html client was started first, reload the page to reestablish the connection.

To connect clients running on different computers, you may need to change the websocket and/or UDP address and port values.

The Intelligent Museum

An artistic-curatorial field of experimentation for deep learning and visitor participation

The ZKM | Center for Art and Media and the Deutsches Museum Nuremberg cooperate with the goal of implementing an AI-supported exhibition. Together with researchers and international artists, new AI-based works of art will be realized during the next four years (2020-2023). They will be embedded in the AI-supported exhibition in both houses. The Project „The Intelligent Museum” is funded by the Digital Culture Programme of the Kulturstiftung des Bundes (German Federal Cultural Foundation) and funded by the Beauftragte der Bundesregierung für Kultur und Medien (Federal Government Commissioner for Culture and the Media).

As part of the project, digital curating will be critically examined using various approaches of digital art. Experimenting with new digital aesthetics and forms of expression enables new museum experiences and thus new ways of museum communication and visitor participation. The museum is transformed to a place of experience and critical exchange.

zkmkarlsruhe/baton