Skip to content

Commit c9096cb

Browse files
committed
Create README.md
1 parent 02a056a commit c9096cb

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

README.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Patchrrr
2+
3+
Patchrrr is a minimalist Python based patchbay for Jack audio and ALSA MIDI on Linux. It takes lists of input/output pairs and tries to keep them connected at all times.
4+
5+
This project was created for a headless audio processing setup, with no X or Wayland present.
6+
7+
### Features
8+
9+
* 800 lines of Python with no dependencies (thanks to `ctypes`)
10+
* Easy install — just download the single file
11+
* Linux only
12+
13+
### Maybe future features
14+
15+
* Dynamic patching, including the ability to disconnect clients
16+
* Run in the background so the main thread isn't blocked
17+
* Support for Jack MIDI (assuming it doesn't just work already)
18+
19+
## Usage
20+
21+
Just copy or download the `patchrrr.py` file. You can then use it in two ways:
22+
23+
1. Edit the examples at the top to specify the clients you want to patch together, then run:
24+
```
25+
python patchrrr.py
26+
```
27+
2. Import `patchrrr` into your own file and create an instance of the manager class
28+
29+
## Notes
30+
31+
Patchrrr is designed around blocking IO, threads, and queues. It should be fairly lightweight in terms of resource consumption, but running super fast isn't the main goal.

0 commit comments

Comments
 (0)