About this project

sndcpy is a proof-of-concept tool designed to forward audio from an Android 10 or higher device to a computer, serving as an audio counterpart to scrcpy. It does not require root access and supports GNU/Linux, Windows, and macOS. The tool relies on VLC media player on the computer to play the forwarded audio stream and uses ADB to communicate with the device. Key details and features include: - Simple execution via command line, with optional device serial specification for multi-device setups. - Support for environment variables to customize paths to ADB, VLC, the sndcpy APK, and the local communication port. - Restrictions based on Android's audio playback capture policy, where apps targeting Android 10+ allow capture by default, while older targets require explicit flags to permit audio capture. - Known limitations include potential audio delays and jitter, which may trigger VLC buffering warnings, requiring simple restarts to resolve. Note: As of scrcpy 2.0, native audio forwarding is supported, making sndcpy primarily a reference or alternative implementation.