ADN DMR Peer Server

ADN DMR conference bridge server. Configuration is YAML; the codebase follows clean architecture (domain, application, infrastructure).

License

GPL v3. Derived from FreeDMR / HBlink.

Requirements

• Python 3.10+
• Dependencies: pip install -r requirements.txt
• ffmpeg (system package) — required for voice/TTS. Install via your distro:
  • Debian/Ubuntu: apt install ffmpeg
  • openSUSE: zypper install ffmpeg
  • Fedora/RHEL: dnf install ffmpeg or yum install ffmpeg

Configuration

Copy adn-server.example.yaml to adn-server.yaml and edit with your settings. Production config is not committed.

Voice configuration

Voice features (announcements, TTS, recording) use a separate config file. Copy adn-voice.example.yaml to adn-voice.yaml and edit. If the file does not exist, voice features are disabled (no error). Changes are hot-reloaded every 15 seconds.

• Each item (ANNOUNCEMENTS, TTS_ANNOUNCEMENTS) has its own LANGUAGE and ENABLED: true to activate.
• ANNOUNCEMENT_LANGUAGES is optional (for voice ident only); announcements/TTS work without it.
• TTS requires ffmpeg + vocoder (TTS_VOCODER_CMD or TTS_AMBESERVER_HOST). Pipeline: .txt → gTTS → .mp3 → ffmpeg → .wav → vocoder → .ambe. First time: create Audio/<LANG>/ondemand/<FILE>.txt with the text. See Voice, announcements, and TTS.

Documentation (MkDocs)

Documentation (MkDocs): English under docs/en/, Spanish under docs/es/ (server/ and monitor/ in each). Install the doc stack first (includes Material); otherwise you may see Unrecognised theme name: 'material' if mkdocs on your PATH is not the same environment.

python3 -m pip install -r requirements-docs.txt
python3 -m mkdocs build -f mkdocs.yml          # → site/en/
python3 -m mkdocs build -f mkdocs.es.yml       # → site/es/

Use the same python3 you use for the project (e.g. pyenv’s 3.11.8). Preview the combined tree: cd site && python3 -m http.server then open /en/ and /es/, or run python3 -m mkdocs serve -f mkdocs.yml for English only.

Output: site/en/ and site/es/ under gitignored site/.

Run

pip install -r requirements.txt
python adn-server.py

Options:

python adn-server.py -c /path/to/adn-server.yaml
python adn-server.py --logging DEBUG

Parrot (Playback)

A separate entrypoint records incoming group voice and plays it back (echo/parrot).

cp adn-parrot.example.yaml adn-parrot.yaml
python adn-parrot.py

See Parrot (playback) in the docs site for an overview; extended notes may exist in private docs-priv/ checkouts.