https://github.com/rom1v/usbaudio

Forward audio from Android devices
https://github.com/rom1v/usbaudio

Last synced: about 2 months ago
JSON representation

Forward audio from Android devices

• Host: GitHub
• URL: https://github.com/rom1v/usbaudio
• Owner: rom1v
• License: mit
• Created: 2019-06-20T07:07:20.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-06-09T20:01:46.000Z (over 4 years ago)
• Last Synced: 2024-06-23T23:43:23.520Z (3 months ago)
• Language: C
• Size: 8.79 KB
• Stars: 354
• Watchers: 18
• Forks: 32
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# USBaudio

This tool forwards audio from an Android device to the computer over USB. It

works on _Linux_ with _PulseAudio_.

The purpose is to enable [audio forwarding][issue14] while mirroring with

[scrcpy]. However, it can be used independently, and does not require USB

debugging enabled.

_Note that AOA audio, the feature used by USBaudio, is [deprecated] since

Android 8.0. For Android 10, use [sndcpy] instead._

[deprecated]: https://source.android.com/devices/accessories/aoa2

[issue14]: https://github.com/Genymobile/scrcpy/issues/14

[scrcpy]: https://github.com/Genymobile/scrcpy

[sndcpy]: https://github.com/rom1v/sndcpy

## Build

Install the following packages (on _Debian_):

    sudo apt install gcc git meson vlc libpulse-dev libusb-1.0-0-dev

Then build:

    git clone https://github.com/rom1v/usbaudio

    cd usbaudio

    meson x --buildtype=release

    cd x

    ninja

To install it:

    sudo ninja install

## Run

Plug an Android device.

If USB debugging is enabled, just execute:

```

usbaudio

```

You can specify a device by _serial_ or by _vendor id_ and _product id_:

```bash

# the serial can be found via "adb device" or "lsusb -v"

usbaudio -s 0123456789abcdef

# the vid:pid is printed by "lsusb"

usbaudio -d 18d1:4ee2

```

To stop playing, press Ctrl+C.

To stop forwarding, unplug the device (and maybe restart your current audio

application).

To only enable audio accessory without playing, use:

```bash

usbaudio -n

```

## Blog post

 - [Introducing USBaudio][blogpost]

[blogpost]: https://blog.rom1v.com/2019/06/introducing-usbaudio/