https://github.com/elektrofon/patchOS

patchOS turns your Raspberry PI 4 into a multi channel, full duplex, low latency audio streamer
https://github.com/elektrofon/patchOS

arch-linux jackaudio jacktrip raspberry-pi

Last synced: 2 months ago
JSON representation

patchOS turns your Raspberry PI 4 into a multi channel, full duplex, low latency audio streamer

• Host: GitHub
• URL: https://github.com/elektrofon/patchOS
• Owner: elektrofon
• License: mit
• Created: 2020-04-16T18:37:28.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-12-11T02:18:06.000Z (almost 2 years ago)
• Last Synced: 2024-06-12T05:41:52.247Z (4 months ago)
• Topics: arch-linux, jackaudio, jacktrip, raspberry-pi
• Language: CSS
• Homepage:
• Size: 2.63 MB
• Stars: 20
• Watchers: 3
• Forks: 3
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        






## 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](https://www.expert-sleepers.co.uk/es8.html)

- [Expert Sleepers ES-9 module](https://www.expert-sleepers.co.uk/es9.html)

## How to install

1. Grab the [latest release](https://github.com/elektrofon/patchOS/releases) of patchOS.

2. Use [etcher](https://www.balena.io/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:



  



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](https://play.google.com/store/apps/details?id=de.wellenvogel.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!