Audio Share can share Windows/Linux computer's audio to Android phone over network, so your phone becomes the speaker of computer. (You needn't buy a new speaker😄.)
- A PC with Windows or Linux as the server.
- Windows 10+ x86_64 with Microsoft Visual C++ 2015-2022 Redistributable (x64) (vc_redist.x64.exe).
- Linux with PipeWire.
- The audio player on PC can work normally. That's to say that you should have a sound card and the audio endpoint is in available state. Otherwise, you need some extra setups.
- The phone with Android 6.0(API 23)+.
- The network (e.g. Wi-Fi or USB tethering) that the phone can connect with the PC.
- Download APK file and AudioShareServer.exe from latest release.
- Open the AudioShareServer.exe on your computer. The default arguments may work well. But you may still have to check the "Host" part. It's normally the LAN address, such as
192.168.xxx.xxx. Make sure your phone can connect your computer over this IP address. Then Click "Start Server" button. - Install APK to your phone and open it. Modify the "Host" part to make sure it's same as the value of previous step, such as
192.168.xxx.xxx. Click "▶" button and enjoy the audio🎶.
- Download the
audio-share-server-cmd-windows.zipfor Windows, theaudio-share-server-cmd-linux.tar.gzfor Linux. - Uncompress the archive file.
- Just run
as-cmd -bto start the server. It will use the first LAN address as the host with the port65530and select a default audio endpoint. Most of the time, it works fine. If not, then useas-cmd -hto see the help, and set the proper arguments. - The Windows will ask you to add firewall rules automatically while Linux won't. So if your Linux distribution enables firewall, you need to configure firewall manually.
- Install APK to your phone and open it. Modify the "Host" part to make sure it's same as the value of previous step, such as
192.168.xxx.xxx. Click "▶" button and enjoy the audio🎶.
address=192.168.3.2 # change it.
port=65530 # change it.
sudo firewall-cmd --add-rich-rule="rule family=ipv4 destination address=$address port port=$port protocol=tcp accept"
sudo firewall-cmd --add-rich-rule="rule family=ipv4 destination address=$address port port=$port protocol=udp accept"
sudo firewall-cmd --runtime-to-permanentsudo firewall-cmd --list-rich-rulesOutput:
rule family="ipv4" destination address="192.168.3.2" port port="65530" protocol="tcp" accept
rule family="ipv4" destination address="192.168.3.2" port port="65530" protocol="udp" acceptaddress=192.168.3.2 # change it.
port=65530 # change it.
sudo firewall-cmd --remove-rich-rule="rule family=ipv4 destination address=$address port port=$port protocol=tcp accept"
sudo firewall-cmd --remove-rich-rule="rule family=ipv4 destination address=$address port port=$port protocol=udp accept"
sudo firewall-cmd --runtime-to-permanentThere are two kinds of audio format:
- Capture audio format
- Transfer audio format
The transfer audio format is uncompressed PCM data and keep same with capture audio format.
You can open server.log to see the transfer audio format.
[2024-10-26 14:52:48.967] [info] AudioFormat:
encoding: ENCODING_PCM_16BIT
channels: 2
sample_rate: 44100
As shown above, the encoding is 16 bit integer PCM, the channel count is 2, and sample rate is 44.1kHz.
On Android, AudioTrack API only support the PCM audio formats listed below:
ENCODING_PCM_FLOAT
ENCODING_PCM_8BIT
ENCODING_PCM_16BIT
ENCODING_PCM_24BIT_PACKED
ENCODING_PCM_32BIT
https://developer.android.com/reference/android/media/AudioFormat#encoding
Audio Share support these 5 kinds of PCM format, but whether specific format is available depends on the audio endpoint.
On Windows, the default capture audio format depends on the audio endpoint's default format. You may change it by setting Sound Panel(mmsys.cpl). In Sound Panel's Playback tab, right click one available endpoint, and open Properties Panel, and select Advanced tab, and change Default Format and click Apply. This can be also done in Realtek Audio Console, if you use a Realtek audio card. The capture audio format must has the same channels and sample rate with the audio endpoint. So if you want to change them, you can only open Sound Panel and set default format. To be compatible with Linux, the as-cmd can still set the --channels or --sample-rate on Windows. However, it will fallback to the proper audio format, because it doesn't support the expected in most cases.
https://learn.microsoft.com/en-us/windows/win32/coreaudio/device-formats
On Linux, the default capture audio format could have been given by PipeWire completely. However, the default audio encoding may be planar, such as SPA_AUDIO_FORMAT_F32P. Android's AudioTrack can't play it. So the default audio encoding is forced to SPA_AUDIO_FORMAT_F32_LE(32 bit float PCM with little endian). The default channels and sample rate are untouched and given by PipeWire.
Note that decrease the encoding bitwise or sample rate can decrease network bandwidth, but can also increase the blank noise, also known as audio loss.
The final volume that you hear is affected by the following volume:
- PC system volume.
- Audio player volume on PC.
- Android system media volume.
- "Audio Volume" on Android app.
- "Loudness Enhancer" on Android app.
They are all independent. If you max the volume of your PC and audio player, and still feel it's not enough, but don't want to change the Android system volume, you can increase "Loudness Enhancer" on app's Settings. It won't affect the system volume. The "Audio Volume" on app can decrease the volume you hear without changing system volume.
Too much loudness will hurt your ear!!! "Loudness Enhancer" has a limit of 3000mB. It's enough for most cases. If you still need more loudness, just directly change Android system volume.
Realtek sound card can make audio endpoint available when speaker doesn't plug in. Just open Realtek Audio Console, select "Device advanced settings" tab, and switch on "Disable front panel front popup dialog" option. Then the audio endpoint will show up. Other sound card may have similar options. If you can't find, then turn to Method 2.
At present, I haven't find a way to create virtual audio endpoint. The only way to achieve it is to write a virtual audio device driver. But it need a EV Code Signing Certificate to sign it. Otherwise, user can't install it. I don't want to pay for it. And there are many existed third-party virtual audio device drivers. You can find one or post one that you know at Virtual Audio Device Driver on Windows. Generally, a driver has an INF file. Right click it and click "Install" to install it.
Thanks to PipeWire, it's very easy for Linux to create a virtual audio endpoint, even without a root privilege. Just copy the below config to ~/.config/pipewire/pipewire.conf.d/audio-share-sink.conf
context.objects = [
{ factory = adapter
args = {
factory.name = support.null-audio-sink
node.name = "Audio Share Sink"
media.class = Audio/Sink
object.linger = true
audio.position = [ FL FR ]
priority.session = 1009
priority.driver = 1009
monitor.channel-volumes = true
monitor.passthrough = true
}
}
]
Then run systemctl --user restart pipewire to restart the PipeWire service.
Finally, you can see the added endpoint "Audio Share Sink".
[abc@localhost ~]$ as-cmd -l
[2024-03-17 22:46:14.563] [info] pipewire header_version: 0.3.48, library_version: 0.3.67
endpoint_list:
* id: 30 name: Audio Share Sink
total: 1Restrictions on starting a foreground service from the background
Turns off or ignore battery optimizations can let it work.
-
Android App
- Android Studio will import all dependencies automatically.
-
Server MFC
- vcpkg is required for install dependencies.
- Run
vcpkg install asio protobuf spdlog[wchar] wil nlohmann-jsonto install deps. The vcpkg triplet isx64-windows-static-md. - Visual Studio 2022 with "Desktop development with C++" workload and "C++ MFC for latest v143 build tools (x86 & x64)" option is required for compiling.
-
Server CMD
- CMake and a compiler support C++20 is required. Linux also need
libpipewire-devorpipewire-devel. - Install vcpkg, and set
VPCKG_ROOTenv. This env is required byCMakePresets.json. - Run
vcpkg install asio protobuf cxxoptsto install deps. The vcpkg triplet isx64-windows-static-mdfor Windows,x64-linuxfor Linux. In addition, Windows need runvcpkg install spdlog[wchar] wil, and Linux need runvcpkg install spdlog. - Run
cmake --preset linux-Releaseto configure. - Run
cmake --build --preset linux-Releaseto build. Theas-cmdis located atout/install/linux-Release/bin/as-cmd. - For Windows, replace
linuxtowindowsin previous two steps.
- CMake and a compiler support C++20 is required. Linux also need
This project is licensed under the Apache-2.0 license .
Copyright 2022-2024 mkckr0 <https://github.com/mkckr0>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
- Asio licensed under the BSL-1.0 license
- nlohmann/json licensed under the MIT license
- WIL licensed under the MIT license
- Protocol Buffers licensed under the LICENSE
- spdlog licensed under the MIT license
- {fmt} licensed under the LICENSE
- cxxopts licensed under the MIT license
- PipeWire licensed under the LICENSE
- Ktor licensed under the Apache-2.0 license
- MaterialKolor licensed under the MIT license
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}