https://github.com/gdzx/audiosource
:microphone: Use an Android device as a USB microphone
https://github.com/gdzx/audiosource
android audio forwarding microphone pulseaudio
Last synced: 16 days ago
JSON representation
:microphone: Use an Android device as a USB microphone
- Host: GitHub
- URL: https://github.com/gdzx/audiosource
- Owner: gdzx
- License: mit
- Created: 2021-01-31T23:45:15.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-07-20T20:20:55.000Z (3 months ago)
- Last Synced: 2025-07-20T22:11:25.789Z (3 months ago)
- Topics: android, audio, forwarding, microphone, pulseaudio
- Language: Java
- Homepage:
- Size: 334 KB
- Stars: 253
- Watchers: 5
- Forks: 10
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/gdzx/audiosource - Use an Android device as a USB microphone (Linux / Other)
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/gdzx/audiosource - Use an Android device as a USB microphone (Jump To / Linux)
README
# Audio Source
Audio Source forwards Android microphone audio input to the PulseAudio daemon
through ADB, so you can use your Android device as a USB microphone.
## Requirements
- Device with at least Android 4.0 (API level 14), but fully tested only on
Android 10 (API level 29) so your mileage may vary.
- GNU/Linux machine with:
- Android SDK Platform Tools (requires `adb` in `PATH`).
- PulseAudio or PipeWire with PulseAudio support (requires `pactl` in
`PATH`).
- Python 3 (requires `python3` in `PATH`).
## Installation
[
](https://f-droid.org/packages/fr.dzx.audiosource/)
[
](https://github.com/gdzx/audiosource/releases/latest)
1. Install the Audio Source APK on your Android device through
[F-Droid](https://f-droid.org/packages/fr.dzx.audiosource/), or from the
[releases](https://github.com/gdzx/audiosource/releases/latest), or by
following the [build instructions](#build-and-install).
2. Download the
[`audiosource`](https://github.com/gdzx/audiosource/blob/master/audiosource)
client script on your computer from the
[releases](https://github.com/gdzx/audiosource/releases/latest), and mark it
executable with `chmod a+x ./audiosource`.
## Usage
1. Enable *Android Debug Bridge* (ADB) from the *Developer options* and connect
the device to your computer.
2. Run `./audiosource run` to start Audio Source and forward the audio
automatically. You may have to grant the permission to record audio in
Android.
3. Run `./audiosource volume LEVEL` to set the PulseAudio source volume to
`LEVEL` (for instance `200%`). You will likely need to set the volume higher
than `100%`.
## Multi-device
If you have multiple devices connected then you will have to specify the serial
number of the device you would like to forward audio to with `./audiosource -s
SERIAL COMMAND` or by setting the `$ANDROID_SERIAL` environment variable.
Device serial numbers can be found by running `adb devices`.
You can utilize job control to forward audio from multiple devices
simultaneously as follows:
```console
$ ./audiosource -s shiba run & # press ENTER to regain control of your terminal
$ ./audiosource -s 192.168.1.188:39857 run
```
## Build and install
Run `./gradlew tasks` to list the available commands.
### Debug
```console
$ ./audiosource build
$ ./audiosource install
```
### Release
1. Generate a Java KeyStore:
```console
$ keytool -keystore /home/user/android.jks -genkey -alias release \
-keyalg RSA -keysize 2048 -validity 30000
```
2. Create `keystore.properties` in the project root directory containing:
```ini
storeFile=/home/user/android.jks
storePassword=STORE_PASS
keyAlias=release
keyPassword=KEY_PASS
```
3. Build and install:
```console
$ export AUDIOSOURCE_PROFILE=release
$ ./audiosource build
$ ./audiosource install
```
## Acknowledgement
[sndcpy](https://github.com/rom1v/sndcpy) for the initial implementation of
audio playback forwarding.
## License
This project is licensed under the MIT license ([LICENSE](LICENSE) or
http://opensource.org/licenses/MIT).