spectrum-analyzer-debug

Diagnose WaveCap-SDR spectrum analyzer issues including WebSocket stream disconnections and FFT resolution problems.

1|Updated Oct 25, 2025
One-click install
npx skills add https://github.com/TobiasWooldridge/WaveCap-SDR --skill spectrum-analyzer-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spectrum-analyzer-debug
Source: https://github.com/TobiasWooldridge/WaveCap-SDR/tree/main/.claude/skills/spectrum-analyzer-debug
Command: npx skills add https://github.com/TobiasWooldridge/WaveCap-SDR --skill spectrum-analyzer-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spectrum and waterfall displays are crucial for SDR, but can suffer from various issues like freezing, incorrect frequencies, or poor resolution. This skill provides a structured approach to diagnose and resolve these problems, restoring your visual insight into the radio spectrum.

Core Features & Use Cases

  • Diagnostic Steps: Guides through checking capture status, WebSocket connections, and browser console for errors.
  • Troubleshooting Guides: Offers solutions for common problems like incorrect frequency labels, poor FFT resolution, excessive noise, and performance issues.
  • Use Case: Your waterfall display is frozen and not showing any activity. Use this skill to quickly identify if the capture is running, if the WebSocket stream is active, or if there are frontend rendering issues, guiding you to a rapid fix.

Quick Start

Use the spectrum-analyzer-debug skill to diagnose why the spectrum display is not updating for capture 'cap_123'.

Frequently Asked Questions about spectrum-analyzer-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why is my spectrum display frozen or not updating in WaveCap-SDR?

Spectrum display freezing typically stems from capture not running, WebSocket stream disconnection, or frontend rendering issues. Check capture status via REST endpoint, verify WebSocket connection in browser console, and inspect for JavaScript errors to identify and resolve the root cause.

How do I fix incorrect frequency labels on my waterfall display?

Incorrect frequency labels indicate inconsistency between frontend frequency calculations and backend spectrum endpoint data. Validate that FFT size, sample rate, and center frequency are consistent across capture settings and frontend calculations to restore accurate labeling.

What causes poor FFT resolution in spectrum analysis?

Poor FFT resolution results from FFT size misconfiguration relative to sample rate. Increase FFT size or reduce sample rate to improve frequency resolution, then verify the change propagates through the spectrum endpoint and updates the display.

How do I diagnose excessive noise floor in my SDR spectrum?

Excessive noise floor can indicate gain misconfiguration, improper sample rate settings, or bandwidth constraints. Validate sample rate matches hardware capability, check gain levels, and confirm the noise floor persists across multiple captures before adjusting hardware parameters.

Can I use this skill to troubleshoot WebSocket disconnections during capture?

Yes. The skill guides checking WebSocket connection status through browser developer tools, verifying REST capture status remains active, and identifying network or frontend errors causing disconnection to enable rapid reconnection or restart.

What performance issues can spectrum analyzer debugging address?

Performance degradation in spectrum display often stems from excessive FFT size, high sample rate overload, or frontend rendering bottlenecks. Optimize FFT configuration, validate WebSocket stream stability, and monitor browser resource usage to restore smooth waterfall updates.