PatchOS

<p align="right" width="100%"><a href="https://paypal.me/RuneWarhuus" alt="Donate"><img src="https://img.shields.io/badge/Donate-PayPal-green.svg"></a></p> <img src="./assets/logo.svg" width="300"/> <img src="./assets/diagram.svg" width="100%"/>

What is patchOS?

patchOS is an operating system for the Raspberry PI 4 that makes two modular synths patchable over the internet.

Requirements

• Raspberry PI 4 (Raspberry PI 3b+ should also work, but is untested)
• 4GB+ SD card

One of these audio devices

• Expert Sleepers ES-8 module
• Expert Sleepers ES-9 module

How to install

1. Grab the latest release of patchOS.
2. Use etcher to burn patchOS to the SD card.
3. Boot your Raspberry PI with the new patchOS SD card.

How to use

1. Connect an ethernet cable to the Raspberry PI 4 network port.
2. Connect your audio device to one of the USB ports of the Raspberry PI 4.
3. On your phone open your web browser and navigate to http://patchos.local.

You will be met with a simple control panel:

<p align="center"> <img src="./assets/screenshot.svg" width="300"/> </p>

Input 1-4 on the audio device are sent to the peer,
and output 1-4 receives signals from the peer.

Special note for Android users

Android doesen't support mDNS in the browser. You will therefore not be able to connect to http://patchos.local.

Thankfully there's an easy fix by installing a network discovery app.
A good suggestion is BonjourBrowser

Install the app and it will find patchOS control panel for you.

If you are behind a NAT or a firewall

patchOS uses UDP port 4464 to stream audio.
If you're behind a NAT router or a firewall you need to forward UDP port 4464 to the IP of http://patchos.local.
This is done by logging into your internet modem/router and finding the NAT or firewall settings.

Notes

patchOS is an experiment; not a product.
Feedback is most welcome, and pull requests – even more so!