Feature Request: Expose HTTP/WebSocket API for External Control

[dazdaz]

Feature Request: Expose HTTP/WebSocket API for External Control

Summary

Request to expose EqMac's internal API as a network-accessible HTTP or WebSocket endpoint, enabling third-party applications to programmatically control EQ settings.

Use Case

Those folks developing music player apps that integrates with Roon and Plex or others. I want users to control system-wide EQ from within their app, applying the same EQ settings to all audio sources including Roon playback.

Currently, Roon's API doesn't expose DSP/EQ control, so system-wide EQ via EqMac is the ideal solution.

What I Discovered

While investigating EqMac v1.8.12 Pro, I found that:

1. A full HTTP-style API already exists internally:

   GET /enabled, /gain, /balance, /presets, /info, /effects
   POST /open-url, /reset
   DELETE /presets, /effects
   

2. The API uses WebViewJavascriptBridge for Swift ↔ JavaScript communication within the WKWebView-based UI.

3. No network port is exposed - the API is only accessible from EqMac's internal web UI.

Proposed Solution

Expose the existing API on a localhost HTTP or WebSocket port (e.g., http://127.0.0.1:37765/).

Minimal Endpoints Needed:

GET  /api/enabled          → { enabled: true/false }
POST /api/enabled          ← { enabled: true/false }
GET  /api/presets          → [{ name: "flat", ... }]
POST /api/preset/:name     ← Apply preset by name
GET  /api/bands            → [{ frequency, gain, q, type }]
POST /api/bands            ← [{ frequency, gain, q, type }]

Optional: WebSocket for Real-time Updates

ws://127.0.0.1:37765/ws
→ Subscribe to EQ state changes
← Push band/preset updates

Benefits

• Enables home automation integration (Home Assistant, etc.)
• Allows music apps to sync EQ settings
• Supports accessibility tools
• Matches EqMac's roadmap goal: "API - Control all aspects of eqMac"

Alternatives Considered

• AppleScript: EqMac is not scriptable
• URL Scheme (eqmac://): Exists but commands are undocumented
• CamillaDSP: Has API but complex setup vs. EqMac's simplicity

I'm Happy to Help

If the team is interested, I can:

• Help test API implementations
• Provide feedback on API design
• Contribute documentation

Thank you for the amazing work on EqMac!

---

Environment:

• EqMac Version: v1.8.12 Pro
• macOS: 15.x (Sequoia)
• Use case: Roon/Plex music player integration

[ragauskl]

There have been some talks about this and it's in the upcoming features section of the website. Feature/task priorities change over time, but if I had to guess at the moment I'd say there's some chance it may be added in around v1.11 (not confirmed by dev, just my personal guess based on last update and the upcoming update)

[dazdaz]

Thanks, is there a date or timeline for this feature or 1.11 ?

[ragauskl]

There are no timelines past next minor/feature update, and times for next update are also very approximate and change based on circumstances including but not limited to incoming customer support requests and unexpected compatibility changes. Can probably only say as much as - it's unlikely to happen within this year as there's at least 3 large updates (excluding small patches) until 1.11 including multiple new features each.