shairplay-rust

Pure Rust AirPlay server library

A complete AirPlay audio and video receiver as a Rust library. Supports both classic AirPlay (AP1) and AirPlay 2 (AP2) with buffered audio, encrypted transport, HomeKit pairing, and screen mirroring. #![forbid(unsafe_code)].

This is a clean-room Rust implementation — not a wrapper or FFI binding. Every protocol handler, codec, and cryptographic primitive has been reimplemented from scratch in safe Rust. No C code from shairplay, shairport-sync, or any other project is linked or called.

⚠️ Pre-1.0 notice: This crate is under active development. Minor version bumps (e.g. 0.1 → 0.2) may include breaking API changes. Pin your dependency to a specific minor version (shairplay = "0.2") and review the CHANGELOG before upgrading.

Features

¹ The crate itself contains no unsafe code. On macOS, mDNS service registration uses astro-dnssd, which internally calls Apple's Bonjour C API via FFI. On Linux, mdns-sd provides a pure Rust mDNS implementation with no native dependencies.

Quick Start

AirPlay 1 (Classic)

use std::sync::Arc;
use shairplay::{RaopServer, AudioHandler, AudioSession, AudioFormat};

struct MyHandler;
impl AudioHandler for MyHandler {
    fn audio_init(&self, format: AudioFormat) -> Box<dyn AudioSession> {
        println!("Stream: {}ch {}bit {}Hz", format.channels, format.bits, format.sample_rate);
        Box::new(MySession)
    }
}

struct MySession;
impl AudioSession for MySession {
    fn audio_process(&mut self, samples: &[f32]) {
        // F32 interleaved PCM — same format for AP1 and AP2
    }
}

#[tokio::main]
async fn main() -> Result<(), shairplay::ShairplayError> {
    let mut server = RaopServer::builder()
        .name("My Speaker")
        .build(Arc::new(MyHandler))?;
    server.start().await?;
    tokio::signal::ctrl_c().await.unwrap();
    server.stop().await;
    Ok(())
}

AirPlay 2

// AP2 adds resampling and multichannel mixdown.
// Output is always f32 interleaved PCM — same as AP1.
let mut server = RaopServer::builder()
    .name("My Speaker")
    .output_sample_rate(48000)
    .output_max_channels(2)
    .build(Arc::new(MyHandler))?;

Builder Options

Feature Flags

Implementation Status

✅ AirPlay 1 — Production Ready

Rock solid. ALAC decoding, AES encryption, DACP remote control, metadata (artwork, progress, track info). Works with iPhone, iPad, Mac, iTunes.

✅ AirPlay 2 Audio — Production Ready

Full pipeline: SRP-6a pairing → encrypted RTSP → FairPlay → PTP timing → buffered AAC decode → f32 PCM output. Multichannel 5.1/7.1 with ITU-R BS.775 mixdown. Automatic resampling. Both stream types implemented:

• Type 103 (buffered) — AAC over TCP with timed playout buffer. Used for music.
• Type 96 (realtime) — ALAC over UDP with immediate delivery. Used for Siri, phone calls, system sounds.

Known issue: ~10 second delay between selecting the AirPlay target and audio starting. The iPhone opens a Remote Control connection first and waits before starting audio. This appears to be related to companion-link integration that third-party receivers cannot replicate. Audio playback itself is fast once connected. See AP2-STATUS.md.

🧪 Video (Screen Mirroring) — Work in Progress

Behind the video feature gate. Audio works, video decryption does not.

The video feature switches to a UxPlay-compatible legacy feature set (0x5A7FFEE6) to receive screen mirroring data from iOS 18+. AP2 buffered audio is not available — the iPhone falls back to legacy ALAC (type 96) which is fully supported with FairPlay key decryption and NTP timing.

Video decryption research is ongoing. The 3-stage FairPlay key derivation pipeline is implemented but not yet producing correct output. See AP2-STATUS.md and VIDEO-RESEARCH.md for details.

🔬 Remote Control

AP1 DACP remote control is fully implemented and works.

Third-party AP2 receivers cannot send playback commands (play/pause/skip) to the iPhone. All paths require Apple ecosystem trust:

• Type 130 MRP data channel — requires HomeKit seed (Home app pairing)
• Companion-link protocol — requires same Apple ID
• DACP — iPhone doesn't send Active-Remote header in AP2

See AP2-STATUS.md for the full research. If you have further insights or want to help investigate, please reach out!

Example Player

The included example plays AirPlay audio through the system's default output device:

# AirPlay 1
cargo run --example player

# AirPlay 2
cargo run --example player --features ap2

# With resampling to match output device rate (e.g. 44100→96000 Hz)
cargo run --example player --features ap2 -- --resample

# With persistent device identity (stable MAC + paired keys across restarts)
cargo run --example player --features ap2 -- --persist state.json

# Custom name and interface binding
cargo run --example player --features ap2 -- --name "Kitchen" --bind 192.168.1.100 --persist state.json --resample

# HLS video (YouTube) — requires mpv installed
cargo run --example player --features hls -- --resample

Without --persist, the device gets a random MAC each run and the iPhone treats it as a new device. With --persist, the MAC and paired keys are saved to a JSON file.

Without --resample, audio is delivered at the source's native rate (44100 Hz). If your output device runs at a different rate (e.g. 96000 Hz), use --resample to convert in the example app.

Architecture

src/
├── raop/                RAOP server, RTSP handlers, RTP streaming
│   ├── buffered_audio   AP2 timed playout buffer with decrypt/decode/resample
│   ├── event_channel    AP2 encrypted event channel
│   ├── video            Video handler traits (experimental)
│   └── video_stream     Video stream receiver (experimental)
├── crypto/              RSA, Ed25519+Curve25519, AES, FairPlay
│   ├── pairing_homekit  AP2 SRP-6a + HomeKit pairing + pair-verify
│   ├── chacha_transport AP2 ChaCha20-Poly1305 encrypted RTSP
│   ├── video_cipher     AES-128-CTR streaming cipher for video
│   └── tlv              AP2 TLV codec for pairing messages
├── codec/               Audio decoders
│   ├── alac             ALAC decoder (AP1)
│   ├── aac              AAC decoder via symphonia (AP2)
│   └── resample         Sample rate conversion + channel mixdown
├── proto/               SDP, HTTP/RTSP, binary plist, HTTP Digest auth
├── net/                 Async TCP server, mDNS, PTP timing, feature flags
├── dacp/                DACP remote control client (AP1)
└── error/               Error types

Test Coverage

152 tests including 17 C-verified pairing vectors from pair_ap and 10 C-verified FairPlay vectors generated from the original shairplay C source:

cargo test                    # AP1 tests
cargo test --features ap2     # AP1 + AP2 tests
cargo test --features video   # All tests

Acknowledgments

This project builds on the work of many contributors to the AirPlay open-source ecosystem:

• shairplay — Original C library this project is a complete rewrite of
• shairport-sync — AirPlay 2 C reference implementation by Mike Brady
• pair_ap — HomeKit pairing reference (SRP-6a, TLV, HKDF) by Scott Ickle / ejurgensen. 17 C-verified test vectors generated from this codebase
• AirPlay 2 Internals — Protocol documentation by Emanuele Cozzi
• Unofficial AirPlay Specification — Legacy protocol documentation
• rairplay — Rust AirPlay 2 receiver with video support
• pyatv — Python Apple TV library (companion-link protocol research)
• Dissecting the Media Remote Protocol — Evan Coleman's Apple TV reverse engineering

License

LGPL-3.0-or-later

Disclaimer

All resources in this repository are written using only freely available information from the internet. The code and related resources are meant for educational purposes only. It is the responsibility of the user to make sure all local laws are adhered to. Parts of this project are generated with the help of AI and the expert-in-the-loop approach.