DABlin – capital DAB experience
DABlin plays a DAB/DAB+ audio service – either from a received live transmission or from a stored ensemble recording (frame-aligned ETI-NI). Both DAB (MP2) and DAB+ (AAC-LC, HE-AAC, HE-AAC v2) services are supported.
The GTK GUI version in addition supports the data applications Dynamic Label and MOT Slideshow (if used by the selected service).
GTK GUI version
Besides Git a C/C++ compiler (with C++11 support) and CMake are required to build DABlin.
On Debian or Ubuntu, the respective packages (with GCC as C/C++ compiler) can be installed using aptitude or apt-get, for example:
sudo apt-get install git gcc g++ cmake
The following libraries are required:
- mpg123 (1.14.0 or higher)
The GTK GUI version in addition requires:
glibc implementation of
iconv is available. If this is
not the case, in addition
libiconv is required.
In rare cases, the target architecture does not support atomics. In
such a case, DABlin is linked against GCC's
libatomic. This lib
usually is an (indirect) dependency of GCC itself.
On Debian or Ubuntu, mpg123, FAAD2, SDL2 and gtkmm are packaged and installed with:
sudo apt-get install libmpg123-dev libfaad-dev libsdl2-dev libgtkmm-3.0-dev
On Fedora, mpg123, SDL2, and gtkmm are all packaged and can be installed thus:
sudo dnf install mpg123-devel SDL2-devel gtkmm30-devel
FAAD2 is not packaged in the main Fedora repository, but it is available in RPM Fusion repository. Once you have added RPM Fusion to the repositories, FAAD2 may be installed by:
sudo dnf install faad2-devel
If you do not wish to, or cannot, add the RPM Fusion repositories, you will have to download FAAD2, perhaps from here, and build and install manually.
Alternative DAB+ decoder
On Debian and Ubuntu, you can install FDK-AAC with:
sudo apt-get install libfdk-aac-dev
On Fedora, RPM Fusion is again needed and, if used, you can:
sudo dnf install fdk-aac-devel
When the alternative AAC decoder is used, the FAAD2 library mentioned above is no longer required.
After installing the library, to use FDK-AAC instead of FAAD2, you have to
-DUSE_FDK-AAC=1 as part of the
The SDL2 library is used for audio output, but you can instead choose to output the decoded audio in plain PCM for further processing (e.g. for forwarding to a streaming server).
In case you only want PCM output, you can disable SDL output and
therefore omit the SDL2 library prerequisite. You then also have to
-DDISABLE_SDL=1 as part of the
To enable the PCM output to
-p parameter has to be used.
It is also possible to disable the output of any decoded audio and
instead output the current service as an untouched MP2/AAC stream to
stdout. This can be achieved by using the
Services with surround sound are only decoded from their Mono/Stereo core, as unfortunately there is no FOSS AAC decoder which supports the required Spatial Audio Coding (SAC) extension of MPEG Surround at the moment.
Precompiled packages and source-based Linux distributions
Official precompiled packages are available for the following Linux distributions (kindly maintained by Gürkan Myczko):
On Ubuntu 18.04 you can simply install DABlin from the official package sources (note that the GitHub version may be newer):
sudo apt-get install dablin
Some users kindly provide precompiled packages on their own:
For other distributions you may also want to check the Repology page.
Source-based Linux distributions:
If the gtkmm library is available both the console and GTK GUI executables will be built. If the gtkmm library is not available only the console executable will be built.
To fetch the DABlin source code, execute the following commmands:
git clone https://github.com/Opendigitalradio/dablin.git cd dablin
Note that by default the
master branch is cloned which contains the
current stable version. The development takes place in the
which can instead be cloned by appending
-b next to the end of the
git clone command line.
You can use, for example, the following command sequence in order to compile and install DABlin:
mkdir build cd build cmake .. make sudo make install
DABlin can also be compiled on Windows using Cygwin. The following Cygwin packages are required:
DABlin specific (using FDK-AAC for DAB+ services):
In addition for the GTK version:
Note that the GTK version requires an X server to run e.g. Cygwin/X!
Also note that Cygwin neither needs nor allows to
sudo commands, so
just execute them without that prefix.
Unfortunately the Cygwin package of FDK-AAC doesn't seem to have been compiled with SBR support, so using FAAD2 for DAB+ services is recommended. However FAAD2 has to be compiled and installed by hand, as there is no Cygwin package. This requires the following additional packages to be installed:
When Cygwin is installed, all the aforementioned packages can be
pre-selected for installation by calling Cygwin's
with the following parameter:
The console executable is called
dablin, the GTK GUI executable
-h to get an overview of all available options.
(Currently no desktop files are installed so it is not easy to start DABlin directly from GNOME Shell. For now, at least, start DABlin from a console.)
DABlin processes frame-aligned DAB ETI-NI recordings. If no filename is
stdin is used for input.
You just should specify the service ID (SID) of the desired service
-s - otherwise initially no service is played. The GUI version
of course does not necessarily need this.
You can replay an existing ETI-NI recording as follows:
dablin -s 0xd911 mux.eti
In this case a progress indicator and the current position is displayed.
As an alternative a service label can be specified with the
Note that if the label contains spaces, it has to be enclosed by quotes
(or the spaces be properly escaped):
dablin -l "SWR1 RP" mux.eti
With the console version, instead of the desired service it is also
possible to directly request a specific sub-channel by using
-R (for DAB+).
In addition to the respective button, the GTK GUI version also allows the
m to toggle muting the audio.
To switch to the previous/next service, the
+ keys can be used.
To switch to the 1st, 2nd, ..., 10th service in the service list, the
0 can be used. In both cases also the respective
keys on the NumPad are supported.
DAB live reception
If you want to play a live station, you can use
dab2eti from dabtools
(ODR maintained fork) and transfer the ETI live stream via pipe, e.g.:
dab2eti 216928000 | dablin_gtk
It is possible to let DABlin invoke
dab2eti or any other DAB live
source that outputs ETI-NI. The respective binary is then called with
the necessary parameters, including the frequency and an optional gain
You therefore just have to specify the path to the
dab2eti binary and
the desired channel.
dablin -d ~/bin/dab2eti -c 11D -s 0xd911
dab2eti the E4000 tuner is recommended as auto gain is supported
with it. If you want/have to use a gain value you can specify it using
dab2eti the tool
eti-cmdline by Jan van Katwijk can be
used, as it has more sensitive reception (however the CPU load is higher
dab2eti) and does not require a E4000 tuner for auto gain.
It is part of his eti-stuff.
In addition to specifying the path to the respective binary you also
have to change the DAB live source type accordingly by using
dablin -d ~/bin/eti-cmdline-rtlsdr -D eti-cmdline -c 11D -s 0xd911
In case of the GTK GUI version the desired channel may not be specified. To
avoid the huge channel list containing all possible DAB channels, one
can also state the desired channels (separated by comma) which shall be
displayed within the channel list. Hereby the specified (default) gain
value can also be overwritten for a channel by adding the desired value
after a colon, e.g.
dablin_gtk -d ~/bin/dab2eti -c 11D -C 5C,7B,11A,11C,11D -s 0xd911
Recording a service
With the GTK GUI version the current service can be recorded into a
file. To start/stop a recording, the red record button has to be
clicked, or instead the keyboard shortcut
r be pressed. During a
recording neither can channel/service be changed, nor can DABlin be
By default all recordings are stored to
/tmp. This can be changed by
-r parameter. The filename of a recording contains the
timestamp of the start of the recording and the service name, e.g.
2018-09-02 - 17-53-54 - SWR3.aac.
All recordings are lossless: A DAB service is directly stored in MP2 format. A DAB+ service is packaged into the LATM/LOAS container format. This format is necessary in order to signal the special 960 samples per frame transformation to the AAC decoder for playback.
As both formats are streamable, a recording can already be played while the actual recording is still in progress.
The AAC recordings can be player e.g. by VLC player. FFmpeg will play them as well, but currently does not support the SBR extension together with the 960 samples per frame transformation and will thus only play the AAC core then.
Secondary component audio services
Some ensembles may contain audio services that consist of additional
"sub services" called secondary components, in addition to the primary
component. That secondary components can initially be selected by using
-x in addition to
In the GTK version in the service list such components are shown
» BBC R5LiveSportX). Meanwhile the related
primary component is suffixed with
BBC Radio 5 Live »).
While playback a number of status messages may appear. Some are quite common (enclosed with round brackets) e.g. due to bad reception, while others are rather unlikely to occur (enclosed with square brackets).
During (re-)synchronisation status messages are shown. Also dropped Superframes or AU are mentioned.
If the Reed Solomon FEC was used to correct bytes of a Superframe, this
is mentioned by messages of the format
(3+) in cyan color. This
shorter format is used as those messages occure several times with
borderline reception. The digit refers to the number of corrected bytes
within the Superframe while a plus (if present) indicates that at least
one byte was incorrectable.
When a FIB is discarded (due to failed CRC check), this is indicated by a
(FIB) message in yellow color.
MP2 frames with invalid CRC (MP2's CRC only - not DAB's ScF-CRC) are
discarded, which is indicated by a
(CRC) message in red color.
Audio Units (AUs) with invalid CRC are mentioned with short format
(AU #2) in red color, indicating that the CRC check on
AU No. 2 failed and hence the AU was dismissed.
When the decoding of an AU nevertheless fails, this is indicated by an
(AAC) message in magenta color. However in that case the AAC decoder
may output audio samples anyway.
If the announced X-PAD length of a DAB+ service does not match the available
X-PAD length i.e. if it falls below, a red
[X-PAD len] message is shown and
the X-PAD is discarded. However not all X-PADs may be affected and hence it may
happen that the Dynamic Label can be processed but the MOT Slideshow cannot.
To anyhow process affected X-PADs, a loose mode can be enabled by using
DABlin implements (at least partly) the following DAB standards:
- ETSI EN 300 401 (DAB system)
- ETSI TS 101 756 (Registered tables)
- ETSI TS 103 466 (DAB audio)
- ETSI TS 102 563 (DAB+ audio)
- ETSI ETS 300 799 (ETI)
- ETSI EN 301 234 (MOT)
- ETSI TS 101 499 (MOT Slideshow)
At the moment, DABlin is kind of a rudimentary tool for the playback of DAB/DAB+ services. It is planned to add support for further Program Aided Data (PAD) features.
The GTK GUI version supports the MOT Slideshow. If Slideshow is enabled and the current service signals to transmit a Slideshow, the Slideshow window is displayed. It shows a slide after it has been received completely and without errors.
Currently the following limitations apply:
- slideshows in a separate sub-channel are not supported (just X-PAD);
- the TriggerTime field does not support values other than Now
Please note that the included FEC lib by KA9Q has a separate license!
DABlin - capital DAB experience Copyright (C) 2015-2018 Stefan Pöschel
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program 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 General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.