https://github.com/philippe44/libraop
RAOP player and library (AirPlay)
https://github.com/philippe44/libraop
airplay
Last synced: 5 months ago
JSON representation
RAOP player and library (AirPlay)
- Host: GitHub
- URL: https://github.com/philippe44/libraop
- Owner: philippe44
- Created: 2016-08-05T05:50:48.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-04-02T22:53:45.000Z (over 1 year ago)
- Last Synced: 2025-04-05T04:12:18.869Z (6 months ago)
- Topics: airplay
- Language: Perl
- Size: 286 MB
- Stars: 101
- Watchers: 8
- Forks: 33
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
Awesome Lists containing this project
README
## RAOP player and library (AirPlay)
This is a RAOP (airplay) player and library for the v2 protocol (with synchro). It works for Windows, OSX, Linux x86 and ARM.
There is a small player can can play raw pcm form any file or stdin (useful for use pipes with a decoder like lame, flac or ffmpeg)
The player is just and example how to use the library, but it has a few interesting options:
```text
usage: ./build/raop_play
[-ntp ] write current NTP in and exit
[-p ]
[-v (0-100)]
[-l (frames]
[-w ] (start after milliseconds)
[-n ] (start at NTP + )
[-nf ] (start at NTP in + )
[-e] (encrypt)
[-s ] (valid secret for AppleTV)
[-r] (do interactive pairing with AppleTV)
[-d ] (0 = silent)
[-i] (interactive commands: 'p'=pause, 'r'=(re)start, 's'=stop, 'q'=exit, ' '=block)
```
It's possible to send synchronous audio to multiple players by using the NTP options (optionally combined with the wait option).
Either get the NTP of the master machine from any application and then fork multiple instances of raop_play with that NTP and
the same audio file, or use the -ntp option to get NTP to be written to a file and re-use that file when calling the instances of
raop_play
## Building using CMake
```sh
# install build libreries
apt-get install build-essential cmake libssl-dev
# Fetch all dependencies
# git submodule update --init
git submodule update --force --recursive --init --remote
# Create build directory
mkdir build
cd build
# Build project
cmake ..
make
```
Note that this is a cross-compiler CMake file so it's better to run it and define HOST and PLATFORM options (see the build.sh) but it's not mandatory.
To better understand how my cross-compilation works, see [here](https://github.com/philippe44/cross-compiling)
## Building using Make
Makefiles are provided for OSX, Linux (x86 and ARM). Under Windows, there is a VS2022 project. You'll need some libraires:
- ALAC codec: https://github.com/macosforge/alac and
- Curve25519 crypto: https://github.com/msotoodeh/curve25519
You need pthread for Windows to recompile the player / use the library here: https://www.sourceware.org/pthreads-win32
## Misc
It's largely inspired from https://github.com/chevil/raop2_play but limit the playback to pcm as it focuses on creating a library and optimizing AirPlay synchronization
Since iOS 10.2, pairing is required with AppleTV. Here is a description of the protocol https://htmlpreview.github.io/?https://github.com/philippe44/RAOP-Player/blob/master/doc/auth_protocol.html