log-viewer

View and analyze WaveCap-SDR server logs with configurable filters.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill makes it easy to view, filter, and analyze WaveCap-SDR server logs (API, SDR messages, and debug output) to quickly identify failures and performance issues, saving time during troubleshooting.

Core Features & Use Cases

  • View Recent Logs: Display recent API, startup, and error messages from server stdout and stderr, along with debug traces.
  • Search & Filter: Filter logs by keyword or time window to pinpoint root causes.
  • Troubleshooting Guidance: Correlate log patterns across sources (API errors with SDR messages) to diagnose issues faster.

Quick Start

Run the log viewer to inspect recent errors:

  • Use the helper view_logs.py script to show errors: PYTHONPATH=backend backend/.venv/bin/python .claude/skills/log-viewer/view_logs.py --errors
  • Check server status: PYTHONPATH=backend backend/.venv/bin/python .claude/skills/log-viewer/view_logs.py --status
  • Inspect API requests: PYTHONPATH=backend backend/.venv/bin/python .claude/skills/log-viewer/view_logs.py --requests

Frequently Asked Questions about log-viewer

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

FAQPage Schema
How do I view and filter WaveCap-SDR server logs to troubleshoot errors?

View and filter WaveCap-SDR server logs using the log-viewer helper script with keyword and time-window filters to pinpoint API errors (4xx/5xx), SDR driver messages, and server health issues across stdout, stderr, and debug sources.

Can I diagnose WaveCap-SDR API errors and SDR driver issues from log analysis?

Yes. Log-viewer correlates API errors with SDR device messages and debug traces to identify root causes, covering API request history, capture state, channel state, and SoapySDR driver output.

What's the fastest way to check WaveCap-SDR server status and recent errors?

Run the log-viewer script with --status or --errors flags to instantly display server health, recent startup messages, and error traces without manual log parsing.

Do I need to configure host and port settings to view logs from a remote WaveCap-SDR server?

Yes. Log-viewer accepts configurable host and port parameters to connect to and analyze logs from remote WaveCap-SDR server instances running SoapySDR.

What log sources does WaveCap-SDR log-viewer pull from when troubleshooting?

Log-viewer aggregates stdout, stderr, debug logs, and SoapySDR driver messages from the WaveCap-SDR server to provide comprehensive visibility into API, capture, and device state.

Can I export or filter API request history from WaveCap-SDR logs for performance analysis?

Yes. Log-viewer includes an --requests flag to retrieve and inspect API request history with time-window and keyword filters for identifying latency and error patterns.