WebSDR

WebSDR is an open-source TypeScript monorepo that provides libraries and tools for building web applications that work with Software Defined Radios (SDR) using WebUSB and related browser/node tooling.

⚠️ This project is under active development. Some features are experimental and APIs may change.

Supported SDR hardware

Currently supported SDR devices:

1. Wavelet uSDR — can be connected via the Development Board or the USB adapter.

2. Wavelet xSDR — can be connected via the Development Board or the USB adapter.

3. LimeSDR Mini v2 — tested with v2.2; should also work with v2.3 and v2.4.

4. SSDR

5. XTRX

6. RTLSDR - support is in progress

What is WebSDR?

WebSDR contains utilities, UI components, backend modules, and small test apps to make it easier to build browser-based SDR applications and tooling. The primary goal is to enable interaction with SDR devices connected over USB from web applications (via WebUSB), and to provide supporting building blocks for dashboards, demos, and server-side microservices.

Core capabilities include:

• WebUSB device management (requesting devices, selecting devices in UI components).

• A small Vue 3 component library for dashboards and controls (dropdowns, lists, inputs, log viewers).

• NestJS modules for microservices (authentication, API scaffolding) useful for backend parts of an SDR web platform.

• Utility modules: circular buffers, data conversion helpers, string utilities, time helpers and promise helpers used across frontend and backend.

Documentation

• Docs index: docs/README.md

• WebUSB / SDR interaction subsystem: docs/webusb/README.md

• Manual / hardware tests: test-apps/README.md

Repository layout

Top-level structure (important folders):

packages/
├─ core/                # Shared domain types, utilities, constants
├─ frontend-core/       # Front-end utilities and WebUSB adapters
├─ vue3-components/     # Reusable Vue 3 UI components and styles
├─ nestjs-microservice/ # NestJS modules (auth, API helpers, microservice wiring)
docs/                   # Architecture and subsystem documentation
test-apps/              # Small example/test applications and scripts

Brief package descriptions:

• packages/core — Core shared library with domain types, utilities, constants and radio-related helpers.

• packages/frontend-core — Front-end core utilities, WebUSB adapters, and services used by client apps.

• packages/vue3-components — Vue 3 component library (examples: SdrInput, Dropdown, List, LogArea). Built with Vite; ships TypeScript types and styles.

• packages/nestjs-microservice — NestJS integration and helper modules; main entry is WebSDRModule (configurable via environment variables such as WEBSDR_*).

• test-apps — Small scripts and demo pages used to test low-level functionality (e.g., usb-test.ts).

Published npm packages

This monorepo publishes several packages under the @websdr/* scope. If you only want to consume the libraries (not develop inside the monorepo), install them from npm.

• @websdr/core — shared types/constants and small utilities.

  • Docs: @websdr/core

  • Install: npm install @websdr/core

• @websdr/frontend-core — frontend utilities (API helpers, WebUSB abstraction).

  • Docs: @websdr/frontend-core

  • Install: npm install @websdr/frontend-core

• @websdr/vue3-components — Vue 3 UI components + styles.

  • Docs: @websdr/vue3-components

  • Install: npm install @websdr/vue3-components

• @websdr/nestjs-microservice — reusable NestJS modules (auth/users/logging).

  • Docs: @websdr/nestjs-microservice

  • Install: npm install @websdr/nestjs-microservice

Quick setup

Install dependencies for the workspace:

npm install

If you only want to use the libraries as dependencies, see Published npm packages above.

Build the packages:

npm run build

Run tests (runs workspace tests):

npm run test

Run all tests

npm run test:all

Run all tests and watch for changes

npm run test:watch

Run coverage check

npm run test:coverage

Running test applications

Example test apps live in test-apps. To run them:

cd test-apps
npm install
npm run test:usb

Note: WebUSB requires HTTPS or localhost and browser support. Running tests that access USB devices may require additional browser flags or permissions.

Manual test notes and troubleshooting: test-apps/README.md

Environment / Configuration

• packages/nestjs-microservice reads configuration from environment variables (prefixed with WEBSDR_ in places). See the module entry and code for exact variable names.

License

WebSDR is MIT licensed