flowchart LR
classDef perf fill:#3b1d0e,stroke:#e8a060,color:#ffe8d0
classDef relay fill:#0e2238,stroke:#60a8e8,color:#d8ecff
classDef box fill:#12301a,stroke:#6ad07a,color:#dcffe2
classDef prod fill:#2e1236,stroke:#c07ae0,color:#f4e0ff
classDef ctl fill:#333,stroke:#bbb,color:#eee
subgraph P["PERFORMER: Marcus, Windows laptop ddenison-lpt6"]
MIC["HyperX SoloCast 2 mic"]
FF["ffmpeg capture
wasapi / dshow
48000 Hz, 2 ch, f32le"]
SND["sender.py (LSTN v2) via pythonw, hidden
%LOCALAPPDATA%\\Listen
block 960 frames = 20 ms
--daemon --mic --play-cue"]
CUEPLAY["cue player (ffmpeg)
to headphones / speakers"]
STAMP["UDP 127.0.0.1:19351
song-position stamps (optional)"]
REAPM["Marcus REAPER (local monitor)"]
MIC --> FF --> SND
MIC -.-> REAPM
STAMP -.-> SND
SND --> CUEPLAY
end
subgraph R["RELAY: supernode 'gesherel', marcusx.fun"]
CADDY["Caddy :443
handle_path /listen/*
/listen/setup/* static installers"]
SRV["server.py, user service listento
127.0.0.1:19350, store-nothing
tiers: pcm pcm24 mid low flac opus64-256
maxBufSec 2.0, chirp marker every 2 s"]
API["/listen/ws?role=send | listen | cue
/listen/api/stream?mode=pcm24
/listen/api/sync (NTP 4-stamp)
/listen/api/lock, /listen/health
X-Listen-Password: [redacted]"]
CADDY --> SRV --- API
end
subgraph B["BOX LISTENER: /home/box/listen-feed"]
RCV["receiver.py
GET /api/stream?mode=pcm24
snap buffer target 80 ms, max 200 ms
sync every 2 s; lock deadband 5 ms"]
PULSE["private PulseAudio
unix:/home/box/listen-feed/pulse/native
null sink listen_feed 48 kHz 2 ch
source listen_mic = listen_feed.monitor"]
RPR["REAPER ~/ListenSession/ListenSession.rpp
track 2 'Marcus (Listen)', armed
48000 Hz"]
HELP["reaper-www-helper.py 127.0.0.1:8091
OSC 127.0.0.1:8000 / HTTP 127.0.0.1:8090"]
TUN["ssh -R tunnel
supernode 127.0.0.1:18090 to box 127.0.0.1:8091"]
STAT["status.json
fill_ms, frames, rtt_us, nudge"]
RCV -->|pacat| PULSE --> RPR
RCV --> STAT
HELP -->|OSC actions| RPR
TUN --> HELP
end
subgraph U["URL CODER"]
UC["urlcoder.axismundi.fun/go/FLV_KQ
buttons /rec /play /stop /save /arm"]
end
subgraph L["PRODUCER: Lu, Lus-iMac, macOS 10.15.8"]
AU["Listen.component (AU aufx Lstn Mrcx)
~/Library/Audio/Plug-Ins/Components
Logic: Audio FX > MarcusX > Listen
Receiver: /api/stream?mode=pcm24"]
CUEOUT["CueOut: side-chain beat + talkback
wss /listen/ws?role=cue&mode=pcm
960-frame f32 blocks"]
LOGIC["Logic Pro X audio track, armed (R)"]
LT["cliremote.space/lu-terminal (remote shell)"]
AU --> LOGIC
LOGIC -->|side chain| CUEOUT
end
SND ==>|"wss /listen/ws?role=send, f32 LSTN frames"| CADDY
API ==>|"pcm24 stream"| RCV
API ==>|"pcm24 stream"| AU
CUEOUT ==>|"cue frames"| CADDY
API ==>|"cue, forwarded to the sender"| SND
RCV <-.->|"/api/sync clock offset, rtt about 133 ms"| API
UC -->|"URL Coder app on supernode (127.0.0.1:18809) calls 127.0.0.1:18090"| TUN
class MIC,FF,SND,CUEPLAY,STAMP,REAPM perf
class CADDY,SRV,API relay
class RCV,PULSE,RPR,HELP,TUN,STAT box
class AU,CUEOUT,LOGIC,LT prod
class UC ctl