You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
M0VUB 36c9b1b690
Update docker-compose.yml
3 months ago
.github/workflows Add workflow for docker-build 3 months ago
.gitattributes Update to sync dev system 3 years ago
.gitignore Update and rename gitignoreHASH to .gitignore 3 months ago
Dockerfile Update Dockerfile 3 months ago
HBlink.png Adding Official Logo Images 3 years ago
HBlink.svg Adding Official Logo Images 3 years ago
LICENSE.txt non-programatic updates 4 years ago Merge branch 'HBLink-org:master' into master 1 year ago Allow bridging between time slots on same systme 2 years ago Changed initial state values for some reporting variables. Cosmetic, but avoids unecessary tracabacks. 3 years ago Cosmetics 2 years ago Add log entry for RPTSBKN Site Beacon. 2 years ago
docker-compose.yml Update docker-compose.yml 3 months ago
entrypoint Set permissions 1 year ago
hblink-SAMPLE.cfg Re-add needed code removed when diffing to restore XLX 2 years ago Update 2 years ago non-programatic updates 4 years ago non-programatic updates 4 years ago update copyrights 4 years ago Cleaned up Processing and logging 4 years ago Mostly kinda works now 4 years ago
requirements.txt Update requirements.txt 1 year ago READY FOR TESTING 3 years ago Update to sync dev system 3 years ago

### FOR SUPPORT, DISCUSSION, GETTING INVOLVED ### Please join the DVSwitch group at for online forum support, discussion, and to become part of the development team. A voluntary registrty for HBlink systems with public access has been created at Please consider listing your system if you allow open access.

PROJECT: Open Source HomeBrew Repeater Protocol Client/Master.


PURPOSE: Thanks to the work of Jonathan Naylor, G4KLX; Hans Barthen, DL5DI; Torsten Shultze, DG1HT we have an open protocol for internetworking DMR repeaters. Unfortunately, there's no generic client and/or master stacks. This project is to build an open-source, python-based implementation. You are free to use this software however you want, however we ask that you provide attribution in some public venue (such as project, club, organization web site). This helps us see where the software is in use and track how it is used.

For those who will ask: This is a piece of software that implements an open-source, amateur radio networking protocol. It is not a network. It is not intended to be a network. It is not intended to replace or circumvent a network. People do those things, code doesn't.

This work represents the author's interpretation of the HomeBrew Repeater Protocol, based on the 2015-07-26 documents from DMRplus, "IPSC Protocol Specs for homebrew DMR repeater" as written by Jonathan Naylor, G4KLX; Hans Barthen, DL5DI; Torsten Shultze, DG1HT, also licenced under Creative Commons BY-NC-SA license.

WARRANTY None. The owners of this work make absolutely no warranty, express or implied. Use this software at your own risk.

This document assumes the reader is familiar with Linux/UNIX, the Python programming language and DMR.

Using docker version

Docker file included for own image build To work with provided docker setup you will need:

  • A private repository with your configuration files (all .cfg files in repo will be copyed to the application root directory on start up)
  • A service user able to read your private repository (or be brave and publish your configuration, or be really brave and give your username and password to the docker)
  • A server with docker installed
  • Follow this simple steps:

Build your own image from source

docker build . -t hblink3/hblink3:latest

Or user a prebuilt one in docker hub: shaymez/hblink3:latest This image is multi-arch

Wake up your container

touch /var/log/hblink.log
chown 54000 -R /var/log/hblink.log
 run -v /var/log/hblink/hblink.log:/var/log/hblink/hblink.log -e GIT_USER=$USER -e GIT_PASSWORD=$PASSWORD -e GIT_REPO=$URL_TO_REPO_WITHOUT_HTTPS://  -p 54000:54000  shaymez/hblink3:latest


0x49 DE N0MJS

Copyright (C) 2016-2020 Cortney T. Buffington, N0MJS

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, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA