v0.59.0: LinTunes' own AirPlay 1 sender for third-party speakers

pyatv's handshakes play nothing on a WiiM; Music Assistant's cliairplay
plays on it through libraop's RAOP client. airplay/raop.py reproduces that
client's behaviour on the wire: one RTSP session with auth-setup, an
AppleLossless ANNOUNCE and RECORD carrying RTP-Info, OPTIONS keepalives,
a 2 s buffer, NTP-locked timestamps, a start that sends the first two
seconds at once, the timing responder and resends. Non-Apple speakers
stream through it; pyatv only finds them. Verified against shairport-sync
(decoded tone, flush on pause/seek, volume, metadata). Round 88's pyatv
compat hooks are gone.
This commit is contained in:
2026-10-16 23:12:38 -07:00
parent ab25a6381b
commit efbee5c465
9 changed files with 902 additions and 181 deletions
+199 -1
View File
@@ -1,5 +1,11 @@
"""Round 90: the track list's headings run over the scrollbar's column."""
"""Round 90: the track list's headings run over the scrollbar's column, and
LinTunes' own RAOP sender (airplay/raop.py) for third-party speakers."""
import asyncio
import struct
from lintunes.airplay import raop
from lintunes.airplay.support import alac_verbatim, heard_ms
from lintunes.gui.track_table import TrackTableView
from tests.test_round29 import _local_track
@@ -17,3 +23,195 @@ def test_headings_span_the_scrollbar_and_dont_scroll_sideways(qapp, tmp_path):
assert bar.geometry().top() >= header.height() # starts under them
assert view.horizontalScrollBar().maximum() == 0
view.close()
# ---- LinTunes' own RAOP sender ----
class TestClocks:
def test_ts_and_ntp_round_trip(self):
ntp = raop.ntp_now()
ts = raop.ntp2ts(ntp)
assert abs(raop.ts2ntp(ts) - ntp) < (1 << 32) // 44100 * 2
def test_volume_matches_pyatv(self):
assert raop.percent_to_db(0) == -144.0
assert raop.percent_to_db(100) == 0.0
assert raop.percent_to_db(50) == -15.0
def test_two_second_buffer_plus_the_receivers_own(self):
client = raop.RaopClient("10.0.0.9", 7000, {})
assert client.latency_frames == 88200
assert client.latency == 88200 + 11025
class TestPackets:
def test_sync_says_frame_ts_minus_latency_plays_at_ntp_ts(self):
packet = raop.sync_packet(True, 1_000_000, 88200)
first, kind, seq, minus, sec, frac, ts = struct.unpack(">BBHIIII",
packet)
assert (first, kind, seq) == (0x90, 0xD4, 7)
assert minus == 1_000_000 - 88200 and ts == 1_000_000
assert (sec << 32 | frac) == raop.ts2ntp(1_000_000)
assert raop.sync_packet(False, 5, 1)[0] == 0x80
def test_audio_packet_marks_only_the_first(self):
assert raop.audio_packet(True, 1, 2, 3, b"x")[:2] == b"\x80\xe0"
assert raop.audio_packet(False, 1, 2, 3, b"x")[:2] == b"\x80\x60"
assert struct.unpack(">HII", raop.audio_packet(
False, 0x1_0005, 2**32 + 9, 3, b"")[2:]) == (5, 9, 3)
def test_timing_reply_echoes_the_send_time(self):
request = b"\x80\xd2\x00\x07" + bytes(4) + bytes(16) + b"ABCDEFGH"
reply = raop.timing_reply(request, 0x0102030405060708)
assert reply[:4] == b"\x80\xd3\x00\x07"
assert reply[8:16] == b"ABCDEFGH"
assert reply[16:24] == reply[24:32] == bytes(range(1, 9))
assert raop.timing_reply(b"short", 1) is None
def test_resend(self):
assert raop.parse_resend(b"\x80\xd5\x00\x01\x00\x0a\x00\x03") == (10, 3)
assert raop.parse_resend(b"\x80\xd4\x00\x01\x00\x0a\x00\x03") is None
assert raop.resend_packet(b"P") == b"\x80\xd6\x00\x01P"
def test_daap_item(self):
item = raop.daap_item("Song", "", "Album")
assert item[:4] == b"mlit"
assert struct.unpack(">I", item[4:8])[0] == len(item) - 8
assert b"minm\x00\x00\x00\x04Song" in item
assert b"asal\x00\x00\x00\x05Album" in item and b"asar" not in item
def test_sdp_and_transport(self):
sdp = raop.announce_sdp("0123456789", "10.0.0.2", "10.0.0.9")
assert "a=rtpmap:96 AppleLossless" in sdp
assert "a=fmtp:96 352 0 16 40 10 14 2 255 0 0 44100" in sdp
assert raop.parse_transport(
"RTP/AVP/UDP;unicast;mode=record;server_port=6001;"
"control_port=6002;timing_port=6003") == {
"server_port": 6001, "control_port": 6002, "timing_port": 6003}
def test_metadata_caps(self):
assert raop.metadata_caps("0,1,2") == {"text", "artwork", "progress"}
assert raop.metadata_caps("") == set()
def test_heard_uses_the_senders_own_lag():
assert heard_ms(0, 88200, 1000.0, 44100, lag_ms=200) == 800
assert heard_ms(0, 88200, 1000.0, 44100) == 0 # pyatv's 1.5 s
class _FakeSpeaker:
"""An RTSP + UDP receiver on 127.0.0.1 that records what arrives."""
def __init__(self):
self.requests = []
self.audio = []
self.control = []
async def start(self):
loop = asyncio.get_running_loop()
self.server = await asyncio.start_server(self._client, "127.0.0.1", 0)
self.port = self.server.sockets[0].getsockname()[1]
speaker = self
class Sink(asyncio.DatagramProtocol):
def __init__(self, into):
self.into = into
def datagram_received(self, data, addr):
self.into.append(data)
self.audio_t, _ = await loop.create_datagram_endpoint(
lambda: Sink(speaker.audio), local_addr=("127.0.0.1", 0))
self.control_t, _ = await loop.create_datagram_endpoint(
lambda: Sink(speaker.control), local_addr=("127.0.0.1", 0))
async def _client(self, reader, writer):
while True:
try:
head = await reader.readuntil(b"\r\n\r\n")
except asyncio.IncompleteReadError:
return
lines = head.decode().split("\r\n")
headers = dict(line.split(": ", 1) for line in lines[1:] if line)
body = await reader.readexactly(
int(headers.get("Content-Length", 0)))
method, url = lines[0].split()[:2]
self.requests.append((method, url, headers, body))
extra = ""
if method == "SETUP":
extra = ("Session: 1\r\nTransport: RTP/AVP/UDP;unicast;"
f"server_port={self.audio_t.get_extra_info('sockname')[1]};"
f"control_port={self.control_t.get_extra_info('sockname')[1]};"
"timing_port=1\r\n")
writer.write(f"RTSP/1.0 200 OK\r\nCSeq: {headers['CSeq']}\r\n"
f"{extra}\r\n".encode())
await writer.drain()
def methods(self):
return [(m, u) if m == "POST" else m for m, u, _, _ in self.requests]
def close(self):
self.server.close()
self.audio_t.close()
self.control_t.close()
def _run(coro):
return asyncio.run(asyncio.wait_for(coro, 20))
def test_the_session_is_libraops():
async def go():
speaker = _FakeSpeaker()
await speaker.start()
client = raop.RaopClient("127.0.0.1", speaker.port,
{"et": "0,4", "md": "0"})
await client.set_volume(-15.0)
await client.connect()
client.start()
pcm = bytes(range(256)) * 5 + bytes(128) # one packet
for _ in range(3):
client.send(pcm)
await client.set_metadata("Song", "Artist", "Album")
await asyncio.sleep(0.2)
await client.flush()
await client.close()
speaker.close()
return speaker, pcm
speaker, pcm = _run(go())
assert speaker.methods()[:6] == [
("POST", "/auth-setup"), "ANNOUNCE", "SETUP", "RECORD",
"SET_PARAMETER", "SET_PARAMETER"]
by_method = {m: (h, b) for m, _, h, b in speaker.requests}
assert len(by_method["POST"][1]) == 33 and by_method["POST"][1][0] == 1
assert b"AppleLossless" in by_method["ANNOUNCE"][1]
record = by_method["RECORD"][0]
assert record["Range"] == "npt=0-" and "rtptime=" in record["RTP-Info"]
assert "FLUSH" not in speaker.methods()[:5] # nothing before audio
assert all(h["User-Agent"] == raop.USER_AGENT and "DACP-ID" in h
for _, _, h, _ in speaker.requests)
volume = [b for m, _, h, b in speaker.requests
if h.get("Content-Type") == "text/parameters"]
assert volume[0] == b"volume: -15.000000\r\n"
# The audio: three packets, the first marked, each one ALAC frame.
assert [p[1] for p in speaker.audio] == [0xE0, 0x60, 0x60]
assert speaker.audio[0][12:] == alac_verbatim(pcm)
seqs = [struct.unpack(">H", p[2:4])[0] for p in speaker.audio]
assert seqs == [(seqs[0] + i) & 0xFFFF for i in range(3)]
stamps = [struct.unpack(">I", p[4:8])[0] for p in speaker.audio]
assert [b - a for a, b in zip(stamps, stamps[1:])] == [352, 352]
# …and the first sync went out before them, flagged first.
assert speaker.control and speaker.control[0][:2] == b"\x90\xd4"
def test_a_late_start_sends_the_first_two_seconds_at_once():
client = raop.RaopClient("10.0.0.9", 7000, {})
client.state = "flushed"
client.start()
# The first packet is already ~2 s late: no waiting until the buffer
# is full, then real time.
assert client.ready_for() < -1.9
client.head_ts += raop.ms2ts(2100)
assert client.ready_for() > 0