Home

sds200-python Wiki

Important

This wiki is a task-oriented guide. The version-controlled documentation in the main repository is authoritative when a wiki page and repository document differ.

sds200-python is an alpha Python library and command-line toolkit for the Uniden SDS100, SDS150, and SDS200 scanners. It provides the model-neutral sdsctl command, a typed Python API, USB serial control for all supported models, and native Ethernet control and RTSP/RTP audio for the SDS200.

The project is not affiliated with or endorsed by Uniden.

Start here

• Installation — install the package and optional features.
• Troubleshooting — diagnose USB, network, TUI, and audio problems.
• Repository README — canonical overview, examples, and project status.
• Supported scanner models — capability and hardware-validation matrix.
• Textual TUI guide — full-screen monitoring, controls, recording, and playback.
• Network audio guide — SDS200 playback, recording, Broadcastify, and Asterisk integration.

Supported scanners

Model	USB control	Native Ethernet control	RTSP/RTP audio
SDS100	Yes	No	No
SDS150	Yes	No	No
SDS200	Yes	Yes	Yes

SDS200 USB, Ethernet control, and network audio have been validated on physical hardware. SDS100 core USB behavior has also been hardware-validated. SDS150 support is specification-backed and awaits physical-hardware validation. See the canonical supported-models guide for exact validation scope and tested firmware.

Common tasks

Find scanners

sdsctl discover
sdsctl discover --network 192.168.0.0/24 --network-only

Only probe networks you own or are authorized to scan.

Show scanner information

sdsctl info
sdsctl --host SCANNER_IP info

Start monitoring

sdsctl monitor
sdsctl --host SCANNER_IP monitor
sdsctl --host SCANNER_IP tui

Play or record SDS200 network audio

sdsctl --host SCANNER_IP audio --play

sdsctl --host SCANNER_IP audio \
  --output scanner-audio.wav \
  --duration 30

Project documentation

• Roadmap
• Changelog
• Operational logging
• Capture and replay
• Linux udev rule

Getting help

Review Troubleshooting first. Reproducible bugs and feature requests belong in GitHub Issues. Include the package version or commit, Python and operating-system versions, scanner model and firmware, transport, exact command, and complete sanitized error.

The project support scope is defined in SUPPORT.md. Report security vulnerabilities through SECURITY.md.