dsg/vhost-device
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
vhost-device/vhost-device-sound
History
Davíð Steinn Geirsson 1ca3fc766c sound: document --streams CLI option in README 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 19:33:57 +00:00
..
src sound: warn when running in capture-only mode 2026-03-17 19:33:57 +00:00
Cargo.toml build(deps): bump the non-rust-vmm group across 2 directories with 54 updates 2026-03-02 09:54:13 +02:00
CHANGELOG.md vhost-device-sound: add --socket-fd argument 2025-11-20 17:24:04 +02:00
LICENSE-APACHE sound: fix symbolic links to license files 2024-01-10 11:23:08 +05:30
LICENSE-BSD-3-Clause sound: fix symbolic links to license files 2024-01-10 11:23:08 +05:30
README.md sound: document --streams CLI option in README 2026-03-17 19:33:57 +00:00

README.md

vhost-device-sound

Synopsis

   vhost-device-sound --socket <SOCKET> --backend <BACKEND>

Description

   A virtio-sound device using the vhost-user protocol.

Options

     --socket <SOCKET>
            vhost-user Unix domain socket path

     --socket-fd <FD>
            listening vhost-user Unix domain socket file descriptor
            (e.g. from a service manager)

     --backend <BACKEND>
            audio backend to be used [possible values: null, pipewire, alsa, gstreamer]

     --streams <STREAMS>
            comma-separated list of stream directions to enable [possible values: output, input]
            (default: output,input)

     -h, --help
            Print help

     -V, --version
            Print version

Examples

Launch the backend on the host machine:

host# vhost-device-sound --socket /tmp/snd.sock --backend null

With QEMU, you can add a virtio device that uses the backend's socket with the following flags:

-chardev socket,id=vsnd,path=/tmp/snd.sock \
-device vhost-user-snd-pci,chardev=vsnd,id=snd

License

This project is licensed under either of