Skip to content

Repository files navigation

Plexus Stats

Small strip. Real counters. No dashboard-industrial complex.

Validation Windows OBS Studio C++

README visits

Plexus Stats adds compact OBS health monitors to the native status bar. It keeps the measurements you need during a stream or recording visible without turning OBS into a wall of charts.

The plugin distinguishes actual health signals from informational values. Missing measurements show as unavailable, inactive outputs are not treated as failures, and render pressure is not advertised as GPU utilization.

What It Watches

Monitor Measurement
CPU CPU used by the OBS process
Render Average OBS render time as a percentage of the current frame budget
Encoder Frames OBS reports as skipped because of encoding lag
Network Output frames OBS reports as dropped by the active output
FPS Active OBS frame rate compared with the configured target
Memory OBS process working set
Output Current throughput for the selected active output
Audio Configured OBS audio-buffer duration
Render lag Frames OBS reports as missed because of rendering lag
Disk Free space on the Windows system drive
Stream Streaming active or inactive
Record Recording active or inactive
Latency Active output delay reported by OBS

CPU and render readings are smoothed for readability. Encoder, network, and render-lag percentages use a configurable rolling window. Informational monitors such as Output, Audio, Stream, Record, and Latency do not pretend to be severity scores.

Click any visible monitor for its current reading, recent range when available, configured thresholds, and a short explanation of what deserves attention.

Scope

Plexus Stats does not profile individual sources. Source-level profiling lives in the separate plexus-profiler plugin.

The plugin also does not estimate whole-system GPU usage, network quality, or encoder health from indirect signals. It reports the counters OBS exposes and labels them accordingly.

Configure

Open Tools → Plexus Stats Settings in OBS Studio.

You can choose visible monitors, compact or full labels, numeric values, text states, sample-window length, smoothing, and health thresholds. The default status row shows Render, Encoder, Network, and FPS.

Install

Download PlexusStats-0.1.1-Setup.exe from the latest release, close OBS Studio, and run the installer.

The release also includes a portable ZIP with the native OBS folder layout and SHA256SUMS.txt for artifact verification.

Build

Requirements:

  • Windows 10 or newer
  • OBS Studio 32.2 development dependencies
  • Qt 6
  • CMake 3.28 or newer
  • Visual Studio 2026 with the x64 C++ toolchain
cmake --preset windows-x64
cmake --build --preset windows-x64-release

The runnable plugin is written to:

build_x64\rundir\Release

Quality Checks

ctest --test-dir build_x64 -C Release --output-on-failure

The test suite verifies rolling totals, percentage ranges, sample eviction, and buffer reconfiguration.

Build a Release

After building the plugin:

.\build-release.ps1 -Version 0.1.1

This produces the Windows installer, portable ZIP, and SHA-256 manifest under release\.

Plugin Identity

About

Compact, honest OBS health monitoring in the native status bar.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages