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: 3 months 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 (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-12-18T23:12:54.000Z (4 months ago)
- Last Synced: 2024-12-19T00:20:49.961Z (4 months ago)
- Topics: android, audio, forwarding, microphone, pulseaudio
- Language: Java
- Homepage:
- Size: 318 KB
- Stars: 181
- Watchers: 6
- Forks: 10
- Open Issues: 2
-
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%).
## Build and install
Run `./gradlew tasks` to list the available commands.
### Debug
```shell
$ ./audiosource build
$ ./audiosource install
```
### Release
1. Generate a Java KeyStore:
```shell
$ 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:
```
storeFile=/home/user/android.jks
storePassword=STORE_PASS
keyAlias=release
keyPassword=KEY_PASS
```
3. Build and install:
```shell
$ 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).