bmxtg.py v1.3 (10/04/2017)

Released under the GNU General Public License v3.0

Permissions of this strong copyleft license are conditioned on making available
complete source code of licensed works and modifications, which include larger
works using a licensed work, under the same license. Copyright and license
notices must be preserved. Contributors provide an express grant of patent
rights.

INSTALLATION

Download the .deb package:

wget https://github.com/K2DLS/bmxtg/releases/download/1.3/bmxtg-1.3.deb

To install:

sudo dpkg -i bmxtg-1.3.deb

After installing, copy the desktop file to your Desktop directory.  This will
make the desktop icon available.

cp /usr/local/share/bmxtg/bmxtg.desktop ~/Desktop/

CONFIGURATION

The following configuration files must be stored in /etc/bmxtg:

	talkgroups.conf
	masters.conf
	buttons.conf

To configure bmxtg.py for use, open the masters.conf file in an editor.  Look
for the [My Master] section at the top of the file.  The bm_master option
should be set to the number of the master that your dv4mini client software
connects to.  As of version 1.2, masters.conf no longer contains the list of
all Brandmeister master servers.  This is downloaded dynamically when bmxtg.py
is started.  As of December 2018, the USA master servers no longer work with
the DV4mini.  Choose a bm_master that is not located in the USA.

There are 12 memory buttons.  Place the names of the memories you want to use
in the buttons.conf file.  The name that you use in the buttons.conf file
must EXACTLY match the name for that talkgroup as listed in the Brandmeister
groups file at https://api.brandmeister.network/v1.0/groups/.  As of version
1.2, talkgroups.conf contains only those talkgroups that you wish to override.

The talkgroup list contains some long names.  Long names used on a button will
cuase the keypad to become wider.  You can shorten or abbreviate the names
if you wish to have a narrower memory keypad.  For example, "New Jersey" can
become "NJ".  The longest talkgroup name in use will determine the buton width.
However, if you change the text in button.conf you must add or change the
corresponding text in talkgroups.conf or that button will not function.  You
only need entries in talkgroups.conf for those labels that you are overriding.

Make certain that bmxtg.py is executable (chmod +x bmxtg.py) or you will
have to execute it by first running python (python ./bmxtg.py).

73 de K2DLS