Skip to content

Add low-latency mode and Android EQ for rootless processing - #349

Closed
PEQHUB wants to merge 3 commits into
timschneeb:masterfrom
PEQHUB:low-latency-mode
Closed

PEQHUB wants to merge 3 commits into
timschneeb:masterfrom
PEQHUB:low-latency-mode

Conversation

@PEQHUB

@PEQHUB PEQHUB commented Sep 23, 2026 •

Copy link
Copy Markdown
Contributor

Rootless mode adds a lot of delay between the original audio and what you hear, so video (YouTube etc.) goes out of sync. This adds two options under Audio processing.

Low-latency mode (on by default)

  • reads in 960-frame blocks instead of the whole buffer
  • caps the output track queue and requests the low-latency output path
  • drops a block (with a short fade) when the output queue grows past its target, so latency can't get stuck high after a slow start

Bluetooth, cold start: A/V offset about 340 ms before, about 120 ms after.

Android EQ (off by default)
Instead of capturing, the GEQ/PEQ curve runs inside each app with Android's DynamicsProcessing effect, so video stays in sync. The curve is fitted to the effect's pre-EQ, MBC and post-EQ stages (up to 380 bands) against its actual block response. Settings: latency (~10/20/40 ms), limiter. Other effects are off in this mode.

Measured on the speaker with a mic: 10/21/42 ms added depending on the latency setting, and a -10 dB preamp comes out at -9.4 dB.

The measuring tools are included: a small probe app (latencyprobe), loop telemetry in debug builds, and tools/latency/run_latency_test.py. See tools/latency/README.md.

The rootless capture loop added up to ~0.5 s of delay, which puts video
out of sync. The new "Low-latency mode" setting (on by default) reads in
small blocks, caps the output queue, uses the low-latency output path and
drops a block whenever the output queue grows past its target.

Also adds a latency test harness: a probe app, loop telemetry in debug
builds and tools/latency/run_latency_test.py.
Runs the EQ curve (GEQ + PEQ) inside each app with Android's
DynamicsProcessing effect instead of capturing audio, so video stays in
sync. The curve is fitted to the effect's pre-EQ, MBC and post-EQ stages
(up to 380 bands) against its actual block response.

Settings: Android EQ on/off, latency (~10/20/40 ms) and a limiter.
@PEQHUB PEQHUB changed the title Add low-latency mode for rootless processing Add low-latency mode and Android EQ for rootless processing Sep 23, 2026
@PEQHUB

PEQHUB commented Sep 24, 2026

Copy link
Copy Markdown
Contributor Author

Moved into #350, which bundles this with Live EQ, per-channel PEQ and a song tonality analyzer.

@PEQHUB PEQHUB closed this Sep 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant