Skip to content

Implement Bonjour/mDNS discovery of VDMX OSCQuery endpoint #14

@joaodotwork

Description

@joaodotwork

Description

Discover VDMX's OSCQuery HTTP endpoint automatically via Bonjour/ZeroConf (mDNS service type _oscjson._tcp), eliminating hardcoded URLs.

Tasks

  • Add zeroconf dependency to pyproject.toml
  • Implement mDNS browser for _oscjson._tcp services
  • Resolve discovered service to HTTP URL (host + port)
  • Handle VDMX not running / service not found gracefully
  • Auto-reconnect when VDMX restarts and re-publishes

Acceptance Criteria

  • Automatically discovers VDMX's OSCQuery endpoint without user configuration
  • Falls back to manual URL if Bonjour discovery fails
  • Logs discovered endpoint details

Technical Notes

  • VDMX publishes OSCQuery on a dynamic port (found in Preferences → OSC → OSCQuery)
  • Use Python zeroconf library for mDNS
  • Spec: github.com/Vidvox/OSCQueryProposal

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions