sdrplay-service-fix

Restart SDRplay API service when device enumeration hangs.

1|Updated Oct 25, 2025

Search Tags:#macOS #service #restart #Linux #SoapySDR #enumeration #sdrplay

Ready to run

npx skills add https://github.com/TobiasWooldridge/WaveCap-SDR --skill sdrplay-service-fix

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: sdrplay-service-fix
Source: https://github.com/TobiasWooldridge/WaveCap-SDR/tree/main/.claude/skills/sdrplay-service-fix
Command: npx skills add https://github.com/TobiasWooldridge/WaveCap-SDR --skill sdrplay-service-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and fix stuck SDRplay API service issues that prevent device enumeration, improving reliability when SoapySDRUtil --find hangs or the SDRplay RSP is unresponsive.

Core Features & Use Cases

OS-specific Restart: Restart the SDRplay service on macOS or Linux using preferred methods (kickstart, systemd, or kill).
Enumeration Test: Run tests to verify device enumeration completes quickly.
Guided Fixes: Provide steps to verify service and device connectivity.

Quick Start

To fix enumeration issues, run the fix script:

macOS: sudo /bin/launchctl kickstart -kp system/com.sdrplay.service
Linux: sudo systemctl restart sdrplayService
Then re-run enumeration: SoapySDRUtil --find

Frequently Asked Questions about sdrplay-service-fix

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

FAQPage Schema

How do I fix SDRplay device enumeration when SoapySDRUtil --find hangs?▼

Restart the SDRplay API service to resolve enumeration hangs. On macOS, run `sudo /bin/launchctl kickstart -kp system/com.sdrplay.service`; on Linux, run `sudo systemctl restart sdrplayService`. Then re-run `SoapySDRUtil --find` to verify the device enumerates quickly.

Why is my SDRplay RSP not responding after connecting the USB device?▼

An unresponsive SDRplay API service often prevents device detection even when the USB is present. Restarting the service using OS-specific commands (launchctl on macOS, systemctl on Linux) restores connectivity and allows proper enumeration.

Can I restart the SDRplay service without entering a password each time?▼

Yes. Configure passwordless sudo for the service restart commands by adding the specific launchctl or systemctl commands to your sudoers file, enabling automated or rapid restarts without password prompts.

What's the best way to verify SDRplay service and device connectivity after a restart?▼

Run `SoapySDRUtil --find` to confirm enumeration completes and the SDRplay RSP is detected. Check service status using `launchctl print` on macOS or `systemctl status sdrplayService` on Linux to ensure the service is active.

Does this service restart method work on Windows as well as macOS and Linux?▼

The Skill provides cross-platform service management commands for macOS and Linux. Windows support uses equivalent service management methods; consult platform-specific documentation for Windows service control syntax.