Add Qt dock UI for MoQ streaming (#41)

* Add Qt dock UI for MoQ streaming

OBS's stable Settings -> Stream UI does not surface third-party services
(pending obsproject/obs-studio#12911), so the registered MoQ service/output
are invisible in the UI. Add a dockable panel that drives the MoQ output
directly instead, working on stable OBS today.

The dock (moq-dock.cpp/h, registered via obs_frontend_add_dock_by_id) lets
the user enter a relay URL and broadcast path and start/stop streaming. It
creates its own service/output and reuses the encoders configured in OBS's
Output settings (both Simple and Advanced modes), so no encoder options are
exposed in the dock. Settings persist via obs_module_config_path, and a live
statistics panel shows status, duration, bitrate, data sent, dropped frames,
and connect time. The bundled libmoq version is shown from MOQ_VERSION.

Enable ENABLE_FRONTEND_API and ENABLE_QT (gated so the dock only builds when
both are on, via MOQ_FRONTEND_ENABLED). Add a build-time workaround for the
AGL framework: recent macOS SDKs ship no linkable AGL binary (it exists only
in the runtime dyld shared cache), but the obs-deps Qt6 build references it
transitively via WrapOpenGL; generate a stub whose install name points at the
real framework so the link succeeds and dyld resolves AGL at load.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* Apply clang-format and gersemi formatting

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* Fix audio mixer index and preserve stop error message

- Use the configured TrackIndex (1-based) as the libobs audio mixer index
  (0-based) instead of hardcoding mixer 0, so Advanced mode with Track 2+
  publishes the correct audio track.
- Set the stop failure message after StopStream() resets status to Idle, so
  the failure reason is actually shown.

Addresses CodeRabbit review feedback.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

Author: kixelated

CMakeLists.txt

@@ -46,6 +46,36 @@ else()
   target_link_libraries(obs-moq PRIVATE moq::moq)
 endif()
 
+# The obs-deps Qt6 build references the AGL framework transitively (via
+# WrapOpenGL), but recent macOS SDKs ship no linkable AGL binary -- it exists
+# only in the runtime dyld shared cache. Generate a stub whose install name
+# points at the real framework so the link succeeds; dyld resolves AGL at load.
+if(
+  (ENABLE_QT OR ENABLE_FRONTEND_API)
+  AND APPLE
+  AND NOT EXISTS "${CMAKE_OSX_SYSROOT}/System/Library/Frameworks/AGL.framework/Versions/A/AGL"
+)
+  set(_agl_stub_dir "${CMAKE_BINARY_DIR}/agl-stub")
+  set(_agl_stub_lib "${_agl_stub_dir}/AGL.framework/AGL")
+  if(NOT EXISTS "${_agl_stub_lib}")
+    file(MAKE_DIRECTORY "${_agl_stub_dir}/AGL.framework")
+    set(_agl_arch_flags "")
+    foreach(_arch IN LISTS CMAKE_OSX_ARCHITECTURES)
+      list(APPEND _agl_arch_flags "-arch" "${_arch}")
+    endforeach()
+    execute_process(
+      COMMAND
+        xcrun clang -dynamiclib ${_agl_arch_flags} -install_name /System/Library/Frameworks/AGL.framework/Versions/A/AGL
+        -o "${_agl_stub_lib}" -x c /dev/null
+      RESULT_VARIABLE _agl_stub_result
+    )
+    if(NOT _agl_stub_result EQUAL 0)
+      message(WARNING "Failed to build AGL stub (${_agl_stub_result}); Qt link may fail")
+    endif()
+  endif()
+  target_link_options(obs-moq PRIVATE "-F${_agl_stub_dir}")
+endif()
+
 if(ENABLE_FRONTEND_API)
   find_package(obs-frontend-api REQUIRED)
   target_link_libraries(obs-moq PRIVATE OBS::obs-frontend-api)
@@ -76,6 +106,12 @@ target_sources(
     src/moq-source.h
 )
 
+# The dock requires both the frontend API (to register it) and Qt (to build it).
+if(ENABLE_FRONTEND_API AND ENABLE_QT)
+  target_sources(obs-moq PRIVATE src/moq-dock.cpp src/moq-dock.h)
+  target_compile_definitions(obs-moq PRIVATE MOQ_FRONTEND_ENABLED MOQ_VERSION_STRING="${MOQ_VERSION}")
+endif()
+
 if(${BUILD_PLUGIN})
   set_target_properties_plugin(obs-moq PROPERTIES OUTPUT_NAME ${_name})
 else()

CMakePresets.json

@@ -10,8 +10,8 @@
       "name": "template",
       "hidden": true,
       "cacheVariables": {
-        "ENABLE_FRONTEND_API": false,
-        "ENABLE_QT": false,
+        "ENABLE_FRONTEND_API": true,
+        "ENABLE_QT": true,
         "CMAKE_EXPORT_COMPILE_COMMANDS": true,
         "BUILD_PLUGIN": true,
         "MOQ_VERSION": "0.2.14",