agc-tuner

Analyze RMS and peak dynamics to recommend AGC parameters for WaveCap-SDR channels.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, scipy, requests, matplotlib, and includes scripts (resource) components.

What problem does it solve?

Incorrect Automatic Gain Control (AGC) settings lead to audio that's too quiet, too loud, or suffers from distracting "pumping" artifacts. This skill helps fine-tune AGC parameters for optimal listening, ensuring consistent and clear audio output.

Core Features & Use Cases

  • Dynamic Analysis: Measures RMS, peak levels, and crest factor over time to understand signal characteristics.
  • Parameter Suggestions: Recommends optimal attack, release, and target levels based on signal type (e.g., FM broadcast, SSB voice).
  • Use Case: Your FM broadcast audio sounds like it's "breathing." Use this skill to analyze the dynamics and get a recommendation to increase the AGC release time, eliminating the pumping effect and providing smooth audio.

Quick Start

Use the agc-tuner skill to analyze channel 'ch1' on port 8087 for 10 seconds and suggest optimal AGC parameters.

Frequently Asked Questions about agc-tuner

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

FAQPage Schema
How do I fix audio that sounds like it's breathing or pumping in FM and AM demodulation?

Pumping artifacts occur when AGC parameters are misconfigured. AGC tuning analyzes your signal's RMS and peak dynamics to recommend optimal attack_time, release_time, and target_level settings that eliminate breathing effects and stabilize audio output.

What AGC parameters should I use for different demodulation modes like SSB and digital?

Optimal AGC parameters vary by signal type. AGC tuning measures signal characteristics and generates mode-specific parameter recommendations for FM, AM, SSB, and digital demodulation, accounting for each mode's unique dynamic range and response requirements.

How do I analyze and compare AGC performance across different WaveCap-SDR channels?

AGC tuning performs side-by-side A/B comparisons by measuring RMS, peak levels, and crest factor across channels, visualizing gain changes over time, and updating settings via API or configuration files to identify which parameters work best for each channel.

Can I use AGC tuning when audio levels are too quiet or too loud?

Yes. AGC tuning diagnoses both quiet and loud audio by analyzing dynamic characteristics and recommending target_level adjustments alongside attack and release timing to achieve consistent, properly-leveled output for SDR listening scenarios.

What data and setup do I need before running AGC parameter optimization?

You need access to a WaveCap-SDR channel, numpy and scipy for signal analysis, matplotlib for visualization, and the ability to connect via API or modify configuration files. AGC tuning requires live or recorded signal samples to measure dynamics accurately.

Does AGC tuning work with custom channel configurations and parameter ranges?

AGC tuning generates recommendations and performs comparisons based on your current channel setup, then applies updates via API or configuration file modifications, allowing you to test recommended parameters and refine settings for custom modes and channel-specific requirements.