Skip to content

About

Web interface to run a DAB+ multiplex with ODR-mmbTools (encoders, mux, EDI/ETI/ZMQ outputs, SDR)

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

DABcast — DAB+ broadcast manager for ODR-mmbTools

DABcast - WebUI for DAB/DAB+ (ODR-mmbTools)

Modern web interface for managing DAB/DAB+ multiplexes with ODR-mmbTools.

Tests Latest release · Website · User guide

Free software — GNU AGPL v3. DABcast drives the ODR-mmbTools (odr-audioenc, odr-padenc, odr-dabmux, odr-dabmod) for the usual cases of a DAB+ multiplex; it does not replace their advanced configuration.

Tested on

Status
Debian 12 (bookworm) / Debian 13 (trixie), amd64 ✅ in production
Raspberry Pi OS 64-bit (arm64), Raspberry Pi 5 ✅
Ubuntu 26.04 LTS ⚠️ not tested yet (ODR packages in universe / multiverse)
EasyDAB V2 (ZMQ output) ✅
HackRF One (SDR output, SoapySDR) ✅ on air
LimeSDR / BladeRF / PlutoSDR (SDR output) ⚠️ offered, not tested — feedback welcome
Commercial modulators / converters (EDI, ETI) ⚠️ outputs follow the ODR formats, not tested with commercial hardware

DABcast screenshot


📋 Table of contents


📦 Dependencies

Required

Dependency Description
Node.js Only to run from the sources (v24); the .deb embeds its own Node.js 24
odr-dabmux DAB multiplexer
odr-audioenc DAB+ audio encoder
odr-padenc PAD encoder (metadata)
odr-dabmod OFDM modulator (for TX transmission)
ImageMagick SLS image conversion and resizing (320×240 JPEG)
dablin_gtk DAB+ player/decoder for real-time multiplex monitoring
socat Network stream relay for monitoring support
wmctrl X11 window manager for monitoring support
xdotool Alternative to wmctrl for monitoring support (fallback)

Optional

Dependency Description Usage
SoapySDR + driver module (soapysdr-tools, soapysdr0.8-module-hackrf / -lms7 / -bladerf…) SDR plugged into the server SDR output (HackRF, LimeSDR, BladeRF, PlutoSDR…)
dablin, ffmpeg Decoding the multiplex Web Player

🚀 Installation

Recommended: one command

# Debian 12 / 13, Raspberry Pi OS 64-bit, Ubuntu 26.04+
wget https://dabodr.github.io/DABcast-diffusion-software/download/install-tools.sh
sudo bash install-tools.sh
# Open http://<server-ip>:9090 — first sign-in: admin / dabcast, a new password is required

The script installs everything DABcast can use, so that adding a desktop or an SDR later needs nothing more:

  • ✅ ODR-mmbTools (odr-dabmux, odr-audioenc, odr-padenc, odr-dabmod)
    • Debian 13+: standard repository, non-free enabled automatically (odr-audioenc uses fdk-aac)
    • Debian 12: bookworm-backports
    • Ubuntu 26.04+: universe / multiverse
  • ✅ ImageMagick (SLS conversion), Dablin and ffmpeg (web Player), Dablin window helpers
  • ❓ SDR support (asked, default yes): SoapySDR and every driver (HackRF, LimeSDR, BladeRF, USRP, RTL-SDR…); the user is added to plugdev / audio
  • ✅ sudo (one-click updates), a time synchronisation if none runs, the build tools
  • ❓ DABcast (asked, default yes, unless already up to date): the latest release for the machine (amd64 / arm64), started as a service

ODR tools already installed: the installed / available versions are shown and the update is asked. ODR tools compiled from sources: keep or replace them (asked). --yes answers every question with its default.

By hand

sudo bash install-tools.sh --tools-only        # the tools only
# then the package of your machine from https://github.com/DABodr/DABcast-diffusion-software/releases/latest
sudo dpkg -i dabcast_X.Y.Z_amd64.deb            # dabcast_X.Y.Z_arm64.deb on a Raspberry Pi

Updates: the web interface offers new releases and installs them in one click.

From the sources (development)

# Node.js 24 and the ODR-mmbTools (install-tools.sh above) are needed
git clone https://github.com/DABodr/DABcast-diffusion-software.git
cd DABcast-diffusion-software/server
npm ci
npm start          # http://localhost:9090
npm test           # 298 tests

⚡ Quick start

Open http://:9090, sign in (first time: admin / dabcast, then choose a password), add your services, add a transmitter output in Multiplex & modulator, then Start.

First configuration

A new installation starts with one example service, OFF: public domain classical music from Public Domain Radio (http://relay.publicdomainradio.org/classical.mp3), for tests. Turn it ON and press Start to hear a first multiplex, then replace its stream URL with yours (or add your own services) — use streams you have the rights to broadcast. Nothing is broadcast until a service is ON. Existing installations keep their configuration.

MOT directories (DLS/SLS) are in data/mot/*.


🖥️ Automatic startup (systemd)

Installation via .deb package (recommended)

sudo dpkg -i dabcast_X.Y.Z_amd64.deb
sudo systemctl status dabcast

The service starts automatically at boot. Logs are accessible via:

journalctl -u dabcast -f

Configuration /etc/default/dabcast

The package installs /etc/default/dabcast with commented default values. This file is preserved during upgrades (dpkg conffile): your changes are never overwritten.

sudo nano /etc/default/dabcast
sudo systemctl restart dabcast
Variable Description Default
DABCAST_DATA_DIR Data directory (presets, logs, runtime, mot) /var/lib/dabcast
PORT WebUI port 9590
HOST Listen address 0.0.0.0
DABCAST_TELEGRAM_BOT_TOKEN Telegram bot token (keep secret) (not set)
DABCAST_TELEGRAM_CHAT_ID Destination user/group/channel ID (not set)
DABCAST_TELEGRAM_MIN_LEVEL Forwarded log level: DEBUG, INFO, WARN, or ERROR ERROR
DABCAST_TELEGRAM_SILENT Send Telegram messages silently false
DISPLAY X11 display — required for the Dablin button (not set)
XAUTHORITY X11 authority file (not set)
XDG_RUNTIME_DIR PulseAudio/D-Bus runtime dir — required for Dablin audio (not set)

To enable Telegram alerts from the WebUI, open Telegram in the top bar, enter the BotFather token and destination chat ID, enable notifications, and select Send test. The token is stored separately in data/.telegram.json with mode 0600; it is never returned by the API or included in configuration exports. Only ERROR messages are forwarded by default. Environment variables in /etc/default/dabcast remain available as a deployment-time fallback.

Dablin button under systemd

The "Launch Dablin" button requires the service to have access to your X11 session and PulseAudio audio. Without configuration, dablin_gtk launches but closes immediately (no DISPLAY, no PulseAudio).

# Get your values
echo $DISPLAY        # e.g.: :0
echo $XAUTHORITY     # e.g.: /home/odr/.Xauthority
id -u                # e.g.: 1000

Uncomment and adapt in /etc/default/dabcast:

DISPLAY=:0
XAUTHORITY=/home/odr/.Xauthority
XDG_RUNTIME_DIR=/run/user/1000   # replace 1000 with your UID

Then restart the service: sudo systemctl restart dabcast

Installation from sources

A systemd file is provided for installations from the git repository:

# Adapt WorkingDirectory and ExecStart to your installation path
sudo cp dabcast.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now dabcast

The dabcast.service file at the root contains commented Environment= lines for DISPLAY, XAUTHORITY and XDG_RUNTIME_DIR (required for the Dablin button).


✨ Features

DAB+ service management

  • ✅ Create/edit/delete services
  • ✅ Drag & drop to reorder services in the multiplex
  • ✅ ETSI EN 300 401 validation (PI, PS8, PS16, bitrates, CU)
  • ✅ Automatic Capacity Unit calculation (CU) with ETSI EEP-A and EEP-B formulas
  • ✅ ON AIR locking: certain critical fields (bitrate, PI, PS) are protected during broadcast
  • ✅ Multi-source support: HTTP(S), local file, ALSA sound card, GStreamer pipeline
  • ✅ Backup sources: automatic failover on failure (watchdog)
  • ✅ Mono and stereo support: adaptive VU meter (single "M" bar in mono, "L/R" dual in stereo)
  • ✅ Web Player: listen to any service of the running multiplex from the browser (PC or phone) — audio decoded from the mux output (dablin → ffmpeg MP3, a few seconds behind live), real-time L/R meter with peak hold, DLS / DL+ / slide of the service. Needs dablin and ffmpeg on the server (installed by install-tools.sh)
  • ✅ Audio levels assistant: click the "Mux inputs" card to compare the peaks of every service over a sliding 5-minute window and get a suggested gain (target -3 to -12 dBFS); Apply saves the gain, a mux restart applies it

Metadata (DLS/SLS)

  • ✅ DL+ (Dynamic Label Plus): structured metadata display (artist, title)
    • DL+ badge shown only when tags are actually transmitted
    • Support for "Artist - Title" format with automatic parsing
  • ✅ 4 metadata modes:
    • Stream: automatic extraction from Icecast/Shoutcast headers
    • JSON: retrieval from an external API with:
      • Dot-path (now.artist), arrays (data.0.name), fallbacks (artist|name)
      • Automatic cover art download (cover.jpg)
      • JSON test and cover preview in the UI
      • Detailed metadata logs
    • FILE: reading from local or HTTP text files
    • Manual DLS: manual DLS text entry with "Show default DLS" option
  • ✅ Slideshow (SLS):
    • Automatic image download from URLs
    • Automatic conversion to DAB format (JPEG 320×240)
    • Drag & drop support for manual upload
    • Automatic rotation: slideshow every 5 seconds between all images (logo.jpg, cover.jpg)
    • Clickable preview: click on thumbnail to display full size (320x240) with continuous rotation

Monitoring and logs

  • ✅ Real-time audio levels: visual level indicators per service
    • Mono VU meter (M bar) or stereo (L/R bars)
    • Correct parsing of odr-audioenc mono format
  • ✅ Status dots: visual indicator of active stream (green/red)
  • ✅ Watchdog: process health monitoring and audio stream surveillance
  • ✅ Mux input buffer monitoring (read-only): DABcast queries the odr-dabmux management port (ZMQ, managementport) every 5 s while ON AIR
    • Per-service tag in the Status column: BUFFER OK, UNSTABLE, SILENCE, NO DATA (hover for fill, underruns, overruns, peaks); STARTING (blue, no alarm) after Start, until one stats reading (5 s) shows no new underrun for that input (typically ~15 s, at most 60 s)
    • UNSTABLE in yellow = underruns increased in the last 30 s (listeners may hear dropouts, ▲ = since the previous reading); an input dabmux still reports Unstable for past glitches only (e.g. start-up prebuffering) is shown as BUFFER OK
    • "Mux inputs" card in the summary row; SILENCE / NO DATA inputs count as alarms; full table in the About (?) dialog
    • Detects dropouts the process watchdog cannot see (encoder alive but not delivering audio); no automatic action is taken
  • ✅ Detailed logs:
    • data/logs/dabweb.log (append-only, with timestamps)
    • /api/logs/metadata endpoint with filtering
    • JSON metadata logs (fetch, parse, download, resize)
  • ✅ ODR command display: inspection of odr-audioenc/padenc arguments
  • ✅ About dialog: real-time system information (CPU, RAM, uptime, ODR versions) and mux input buffer stats

Import/Export

  • ✅ Full backup: export of multiplex configuration as JSON
  • ✅ Preset loading: full configuration import
  • ✅ Individual import/export: copy/paste a service between presets

Monitoring

  • ✅ Integrated player (Dablin): real-time listening to the DAB+ multiplex

Transmitter outputs

One or several transmitters fed at once by the same multiplex (Multiplex & modulator panel):

  • ✅ ZMQ — EasyDAB V2 (dabmux listens), optional timestamps
  • ✅ EDI/UDP to a commercial modulator (unicast or multicast, PFT / FEC)
  • ✅ EDI/TCP for transmitters, converters (digris-edi-tcp-converter) or a remote odr-dabmod
  • ✅ ETI/TCP (raw ETI)
  • ✅ SDR on the server (HackRF, LimeSDR, BladeRF, PlutoSDR or any SoapySDR device): odr-dabmod drives the device itself through SoapySDR; Check device lists it (SoapySDRUtil --find)
  • ✅ Connection state of every output; a raw ETI copy (port 9901) is always kept for the Player / Dablin

Supervision and alerts

  • ✅ SDR: the watchdog reads the frames sent by odr-dabmod; unplugged or stalled device → one error, odr-dabmod alone restarted every 30 s until it transmits again (the rest of the multiplex stays on air)
  • ✅ Network outputs: a transmitter that was connected and is gone for 15 s is reported
  • ✅ Telegram: errors forwarded to a bot (minimum level, silent mode, test button), optional ✅ RESOLVED messages when a transmitter output or a service is back on air

Robustness and security

  • ✅ Safe startup: detection of missing binaries (ODR-mmbTools, and hackrf_transfer for a HackRF output saved by an older version)
    • Pre-check before mux startup
    • Toast error messages (5s) with precise details
    • No crash if odr-audioenc/padenc/hackrf_transfer not found
  • ✅ Error handling:
    • child.on('error') handler to prevent ENOENT crashes
    • Automatic cleanup of temporary files (cover.jpg) on mode changes
    • Runtime reset (currentSlsUrl, dlplusActive) on config changes

⚙️ Configuration

data/settings.json file

The data/settings.json file is automatically generated on first launch with default values.

{
  "host": "0.0.0.0",
  "port": 9090,
  "odrBinDir": "",
  "dataDir": "./data",
  "dabmux": {
    "telnetPort": 12721,
    "managementPort": 12720,
    "zmqEndpoint": "tcp://lo:12722",
    "txMode": "EASYDAB",
    "easyDabOutput": {
      "ip": "0.0.0.0",
      "port": 18081,
      "netPort": 9901
    },
    "ediTcpListenPort": 13000,
    "ediPftEnabled": false,
    "ediFec": 2,
    "ediTistOffsetSec": 0,
    "hackrf": {
      "dabBlock": "7A",
      "maxFramesQueued": 580,
      "gainmode": 2,
      "digitalGain": 1,
      "rate": 4096000,
      "txGain": 47
    }
  },
  "auth": {
    "username": "admin",
    "password": "dabcast",
    "mustChangePassword": true
  },
  "ensemble": {
    "idHex": "0xFEFE",
    "eccHex": "0xE1",
    "label": "DABcast WebUI",
    "shortlabel": "DABcast",
    "internationalTable": 1,
    "localTimeOffset": "auto"
  }
}

Key parameters

Parameter Description Default
port WebUI port 9090
odrBinDir ODR binaries path (if not in PATH) ""
txMode NETWORK = the transmitter outputs list dabmux.outputs (what the web UI uses). EASYDAB, EDI, HACKRF are kept for older settings (shown as outputs in the UI); USRP1 is no longer offered EASYDAB
easyDabOutput.port ZMQ port for EasyDAB 18081
easyDabOutput.netPort TCP port for the raw ETI monitoring stream (Dablin/socat, including EDI mode) 9901
ediTcpListenPort EDI-over-TCP port 13000
ediPftEnabled Enable EDI PFT/FEC compatibility (e.g. GatesAir) false
ediFec Number of recoverable PFT fragments (0-5) 2
ediTistOffsetSec EDI timestamp offset in seconds (GatesAir uses 5) 0
hackrf.dabBlock DAB Band III block 7A
hackrf.txGain HackRF TX gain (0-47 dB) 47
hackrf.rate HackRF sample rate (Hz) 4096000

Authentication

WebUI access uses a DABcast-branded sign-in page and a signed HttpOnly, SameSite=Strict session cookie. On first launch, the default credentials are admin / dabcast. The password is automatically hashed with bcrypt in settings.json.

Sessions last 12 hours by default, or 30 days when Keep me signed in is selected. Login attempts are rate-limited, the session signing secret is stored in data/.auth-secret with mode 0600, and changing the password invalidates previously issued sessions.

An alert banner prompts the user to change the default password. Sensitive endpoints are blocked (HTTP 423) until the password has been changed. The new password must be at least 10 characters and must not appear in the weak password list.

Password reset

If credentials are lost, on an installed server (.deb package):

# Factory password 'dabcast' (username kept); a new password is required at the next sign-in
sudo /opt/dabcast/bin/dabcast --reset-password
# Same, with a new username
sudo /opt/dabcast/bin/dabcast --reset-password myuser
# Apply it (briefly interrupts the broadcast; autoStart puts the multiplex back on air)
sudo systemctl restart dabcast

The command writes settings.json in the service data directory (DABCAST_DATA_DIR, else /etc/default/dabcast, else /var/lib/dabcast) and keeps the file owner.

From a source checkout, the reset script is also available:

# Reset to default values (admin / dabcast)
node server/src/reset-password.js

# Set custom credentials
node server/src/reset-password.js myuser MyPassword123

# Display current username
node server/src/reset-password.js --show

Restart the server after the reset to apply changes.


📁 Project structure

DABcast/
├── server/                   # Node.js backend
│   ├── src/
│   │   ├── index.js          # Express API entry point
│   │   ├── appState.js       # State machine (startMux/stopMux)
│   │   ├── defaults.js       # ETSI constants (bitrates, PTY, etc.)
│   │   ├── cu.js             # Capacity Unit calculation
│   │   ├── odr/
│   │   │   ├── processManager.js   # ODR process management
│   │   │   ├── muxBuilder.js       # .mux file generation
│   │   │   ├── dabmuxStats.js      # dabmux management port client (ZMQ, read-only)
│   │   │   ├── outputs.js          # transmitter outputs (ZMQ, EDI, ETI, SDR): validation, .mux lines
│   │   │   ├── dabmodRc.js         # odr-dabmod remote control client (read-only, SDR supervision)
│   │   │   └── commandBuilder.js   # ODR command building
│   │   └── utils/
│   │       ├── validate.js   # ETSI validation
│   │       ├── dlplus.js     # DL+ parsing and tag generation
│   │       └── logger.js     # Timestamped logs
│   ├── tests/                # Unit tests (298 tests)
│   └── package.json
├── web/                      # Vanilla JS frontend
│   ├── index.html
│   ├── app.js                # Interface logic
│   └── style.css
└── data/                     # Runtime data
    ├── presets/              # Saved configurations
    ├── logs/                 # Application logs
    ├── runtime/              # Generated .mux files
    ├── filtertaps.txt        # FIR filter for HackRF
    └── mot/                  # DLS/SLS per service
        ├── SERVICE_ID/
        │   ├── SERVICE_ID.dls
        │   └── slide/
        │       ├── logo.jpg       # Static logo
        │       └── cover.jpg      # Dynamic cover art (JSON mode)
        └── ...

🧪 Tests

cd server
npm test           # 298 tests, run on every pull request by GitHub Actions

Covering: ETSI validation, CU calculation (EEP-A/B), .mux / dabmod.ini generation, ODR command building, transmitter outputs, watchdog / failover / SDR supervision, import/export, DL+ parsing, metadata, slide conversion, sessions, Telegram.


📝 Important notes

  • ON AIR locking: During broadcast, certain critical fields (bitrate, PI, PS8/PS16, protection, buffer) are locked to prevent dropouts. PTY, Language, Channels, Gain and metadata fields remain editable.
  • Append-only logs: Logs in data/logs/dabweb.log are append-only (never truncated).
  • Crash recovery: The data/runtime/pids.json file allows cleaning up orphan processes after a crash.
  • Watchdog: Automatic process monitoring and failover to backup sources.
  • dabmux management port: managementport (default 12720) speaks ZMQ, not HTTP. DABcast only sends the read-only values command (1 s timeout, cached 2 s). Setting the port to 0 disables the stats.
  • Mono/Stereo: Mono mode is supported with correct VU meter parsing (single bar). Tested up to 88 kbps in HE-AAC mono.
  • DL+: DL+ tags (ITEM.ARTIST, ITEM.TITLE) are only transmitted if the DLS follows the "Artist - Title" format. Otherwise, plain text DLS without tags.
  • JSON metadata: Full support with dot-path, fallbacks, automatic cover download, obsolete file cleanup.
  • Portability: filtertaps.txt included in data/ to avoid ENOENT errors on other machines.

🔒 Security

  • Do not expose port 9090 directly on the Internet. The interface is served over plain HTTP: use it on a trusted network, through a VPN (e.g. tailscale serve --bg 9090 gives HTTPS with a valid certificate) or behind a reverse proxy with HTTPS (Caddy, nginx).
  • Sign-in with bcrypt-hashed password, signed HttpOnly / SameSite=Strict session cookie, rate-limited login, password change required at first sign-in.
  • One-click update: a root helper (sudo rule installed by the package) downloads the official GitHub release itself and checks the package before installing it.
  • Report a vulnerability privately: see SECURITY.md.

📰 Release notes

See the GitHub Releases.

🤝 Contributing

Bug reports, hardware feedback (SDR, modulators, converters) and pull requests are welcome — see CONTRIBUTING.md.


☕ Support DABcast

DABcast is a free, open-source project built with passion to make DAB+ broadcasting more accessible to everyone. If DABcast is useful to you and you'd like to help keep it growing, you can buy me a coffee! Supporting the project is entirely optional: DABcast is and will always remain free for everyone.

Buy me a coffee

Thank you for your support! 🙏


Third-Party Software

DABcast is a management interface that controls external tools from the ODR-mmbTools project. These tools are not included in the DABcast source code — they are installed separately and invoked as independent system processes.

Component Role License
ODR-DabMux DAB multiplexer GPL v2
ODR-AudioEnc Audio encoder GPL v2
ODR-PadEnc PAD encoder GPL v2
ODR-DabMod Modulator GPL v3

The DABcast license does not modify, limit, or override the rights granted by the GPL to users of these tools.

DABcast also depends on the following Node.js packages, each governed by their own license:

Package License
express MIT
bcryptjs BSD 3-Clause
morgan MIT
nanoid MIT
archiver MIT
jose MIT

Full license texts are available in the node_modules directory of a development installation, or in the THIRD_PARTY_NOTICES file when present.


License

Copyright © 2026 Aurélien Picart (DABodr)

DABcast is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

DABcast is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

In brief:

  • ✅ Use freely, personally and professionally — commercial broadcasters included
  • ✅ Read, study and modify the source code
  • ✅ Redistribute DABcast, modified or not
  • ⚖️ A modified version that you distribute or make available over a network (for example a hosted DABcast used by others) must be released under the AGPL v3 too, with its complete source code
  • ⚖️ Copyright and license notices must be preserved

Versions published up to 1.7.4 were released under the former DABcast Source-Available License 1.0.

See the LICENSE file for the complete terms.


🔗 Useful links

About

Web interface to run a DAB+ multiplex with ODR-mmbTools (encoders, mux, EDI/ETI/ZMQ outputs, SDR)

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages