Sampleflut - for the sake of chaos

Sampleflut is a network-driven audio art project inspired by Pixelflut, but instead of pixels on a screen, it manipulates audio samples in real time. Clients send commands to modify an audio buffer, which is then played back, allowing for collaborative or chaotic sonic creation.

Connect to the server and manipulate audio samples in real-time. Where Pixelflut uses pixels as a canvas, Sampleflut uses audio samples as its medium.

Get Started - It's Easy!

Simple Text-Based Protocol

Sampleflut uses a simple, human-readable protocol. The full protocol documentation is available in the README on GitLab.

Here's a simple Python example client to get you started:

import socket
import wave
import struct
import sys

import numpy as np


def client_func(wav_file: str, server_ip: str, port: int):
    with wave.open(wav_file, "rb") as wav_file:
        frames = wav_file.readframes(wav_file.getnframes())
        samples = np.array(
            struct.unpack("<" + "h" * (len(frames) // 2), frames),
            dtype=np.int16,
        )
        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as sck:
            sck.connect((server_ip, port))
            sck.send(b"CONFIG\n")
            sck.settimeout(2)
            buffer = sck.recv(200)
            max_size = int(buffer.split()[0])
            print(f"max_size: {max_size}")
            while True:
                for position in range(0, min(max_size, len(samples) - 1)):
                    sample = samples[position]
                    value = sample / 32768.0  # 16-bit PCM-values from -32768 bis 32767
                    message = f"SMPL {position} {value:.7f}\n"
                    sck.sendall(message.encode("utf-8"))


if __name__ == "__main__":
    wav_file = sys.argv[1]
    server = "sampleflut.de"
    port = 8080
    print(f"using {wav_file=} {server=} {port=}")

    client_func(wav_file=wav_file, server_ip=server, port=port)