Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/004helix/vban2pipe
https://github.com/004helix/vban2pipe
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/004helix/vban2pipe
- Owner: 004helix
- License: other
- Created: 2017-11-29T12:59:52.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-11-13T13:10:40.000Z (over 5 years ago)
- Last Synced: 2024-01-16T21:22:03.168Z (5 months ago)
- Language: C
- Size: 51.8 KB
- Stars: 26
- Watchers: 8
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: COPYING
Lists
- awesome-stars - 004helix/vban2pipe - (C)
README
# VBAN receiver
This program receives audio data sent using [VB-Audio software](https://www.vb-audio.com/)
and send it to named pipe.
# Usage:
```
vban2pipe [exec-on-connect] [exec-on-disconnect]
```
# Example for pulseaudio:
Load pipe-source module
```
$ pactl load-module module-pipe-source source_name=pipe \
file=/tmp/vban.input format=s16le rate=48000 channels=2
```
Start vban2pipe
```
$ vban2pipe 6980 /tmp/vban.input
```
Enable VBAN stream on sender side and you should see
```
$ vban2pipe 6980 /tmp/vban.input
[Stream1] stream connected from 172.16.0.2:59708, s16le, 48000 Hz, 2 channel(s)
[Stream1] stream online, primary
...
```
This program can receive several streams simultaneously. All streams should use
the same format and sample rate. Backup streams will be used to restore lost
packets after streams synchronization:
```
$ vban2pipe 6980 /tmp/vban.input
[Stream1] stream connected from 172.16.0.2:56503, s16le, 48000 Hz, 2 channel(s)
[Stream1] stream online, primary
[Stream2] stream connected from 172.16.0.2:56504, s16le, 48000 Hz, 2 channel(s)
[Stream2] stream online, offset -180480 frames
[Stream3] stream connected from 172.16.0.2:56505, s16le, 48000 Hz, 2 channel(s)
[Stream3] stream online, offset -435456 frames
...
```
If lost packets cannot be restored, vban2pipe reports lost output:
```
$ export DEBUG=1
$ vban2pipe 6980 /tmp/vban.input
...
[Stream2] expected 3490818, got 3490821: lost 3 packets
[Stream3] expected 3490818, got 3490821: lost 3 packets
lost 256 frames
[Stream2] expected 3490843, got 3490845: lost 2 packets
[Stream3] expected 3490843, got 3490845: lost 2 packets
...
```
Output latency is only 2 packets in stream.
The pipe name parsed each time the primary stream is connected.
The following placeholders in pipe name can be used:
| Character | Replacement |
| --------- | ------------------------------------------ |
| `%%` | single character `%` |
| `%f` | sample format, i.e. s16le, s24le, etc |
| `%r` | sample rate, i.e. 44100, 48000, 96000, etc |
| `%c` | channels number |