Modern web interface for managing DAB/DAB+ multiplexes with ODR-mmbTools.
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.
| Status | |
|---|---|
| Debian 12 (bookworm) / Debian 13 (trixie), amd64 | ✅ in production |
| Raspberry Pi OS 64-bit (arm64), Raspberry Pi 5 | ✅ |
| Ubuntu 26.04 LTS | |
| EasyDAB V2 (ZMQ output) | ✅ |
| HackRF One (SDR output, SoapySDR) | ✅ on air |
| LimeSDR / BladeRF / PlutoSDR (SDR output) | |
| Commercial modulators / converters (EDI, ETI) |
- Dependencies
- Installation
- Quick start
- Automatic startup (systemd)
- Features
- Configuration
- Project structure
- Tests
- Security
- Contributing
- Support DABcast
- Third-Party Software
- License
| 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) |
| 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 |
# 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 requiredThe 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-freeenabled automatically (odr-audioenc uses fdk-aac) - Debian 12: bookworm-backports
- Ubuntu 26.04+: universe / multiverse
- Debian 13+: standard repository,
- ✅ 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.
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 PiUpdates: the web interface offers new releases and installs them in one click.
# 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 testsOpen http://:9090, sign in (first time: admin / dabcast, then choose a password),
add your services, add a transmitter output in Multiplex & modulator, then Start.
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/*.
sudo dpkg -i dabcast_X.Y.Z_amd64.deb
sudo systemctl status dabcastThe service starts automatically at boot. Logs are accessible via:
journalctl -u dabcast -fThe 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.
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.: 1000Uncomment and adapt in /etc/default/dabcast:
DISPLAY=:0
XAUTHORITY=/home/odr/.Xauthority
XDG_RUNTIME_DIR=/run/user/1000 # replace 1000 with your UIDThen restart the service: sudo systemctl restart dabcast
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 dabcastThe dabcast.service file at the root contains commented Environment= lines for
DISPLAY, XAUTHORITY and XDG_RUNTIME_DIR (required for the Dablin button).
- ✅ 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
dablinandffmpegon the server (installed byinstall-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
- ✅ 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
- Dot-path (
- 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
- ✅ 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) UNSTABLEin yellow = underruns increased in the last 30 s (listeners may hear dropouts,▲= since the previous reading); an input dabmux still reportsUnstablefor past glitches only (e.g. start-up prebuffering) is shown asBUFFER OK- "Mux inputs" card in the summary row;
SILENCE/NO DATAinputs 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
- Per-service tag in the Status column:
- ✅ Detailed logs:
data/logs/dabweb.log(append-only, with timestamps)/api/logs/metadataendpoint 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
- ✅ Full backup: export of multiplex configuration as JSON
- ✅ Preset loading: full configuration import
- ✅ Individual import/export: copy/paste a service between presets
- ✅ Integrated player (Dablin): real-time listening to the DAB+ multiplex
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
- ✅ 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
- ✅ 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
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"
}
}| 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 |
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.
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 dabcastThe 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 --showRestart the server after the reset to apply changes.
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)
└── ...
cd server
npm test # 298 tests, run on every pull request by GitHub ActionsCovering: 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.
- 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.logare append-only (never truncated). - Crash recovery: The
data/runtime/pids.jsonfile 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-onlyvaluescommand (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.txtincluded indata/to avoid ENOENT errors on other machines.
- 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 9090gives HTTPS with a valid certificate) or behind a reverse proxy with HTTPS (Caddy, nginx). - Sign-in with bcrypt-hashed password, signed
HttpOnly/SameSite=Strictsession 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.
See the GitHub Releases.
Bug reports, hardware feedback (SDR, modulators, converters) and pull requests are welcome — see CONTRIBUTING.md.
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.
Thank you for your support! 🙏
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.
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.
- Bug reports, questions and suggestions: GitHub Issues
- ODR-mmbTools
- ETSI EN 300 401 (DAB standard)
- Dablin
- EasyDAB
- HackRF
