'\" t
.\"     Title: qdmr
.\"    Author: Hannes Matuschek <dm3mat@darc.de>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 01/30/2023
.\"    Manual: User Commands
.\"    Source: qdmr 0.11.2
.\"  Language: English
.\"
.TH "QDMR" "1" "01/30/2023" "qdmr 0\&.11\&.2" "User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
qdmr \- Graphical tool for programming DMR radios\&.
.SH "SYNOPSIS"
.HP \w'\fBqdmr\fR\ 'u
\fBqdmr\fR [\fBOPTIONS\fR] [\fBCODEPLUG_FILE\fR]
.SH "DESCRIPTION"
.PP
\fBqdmr\fR
is a graphical tool to program DMR radios\&. That is, reading, editing, generating and uploading codeplugs to these radios\&.
.PP
The configuration of these radios is usually stored in a highly vendor and device specific binary codeplug\&.
\fBqdmr\fR
stores this configuration in a human\-readable and device independent format, thus allowing for sharing codeplugs across devices\&.
.SH "OPTIONS"
.PP
\fBCODEPLUG_FILE\fR
.RS 4
If the optional codeplug file is passed to qdmr, it gets loaded on startup\&. Otherwise, the application starts with an empty codeplug\&.
.RE
.PP
\fB\-style=STYLE\fR
.RS 4
This option allows to set a Qt style for the application\&. This can be used to alter the style of the widgets\&. So call
<cmd>qdmr \-style=windows</cmd>
if you fancy\&.
.sp
However, this option is of real use if you want to use a dark theme\&. By installing a dark Qt theme like kvantum\-dark and starting qdmr by passing this theme to the style option\&. That is
.sp
qdmr \-style=kvantum\-dark
.sp
You may set the Qt style for all Qt applications using the
<env>QT_STYLE_OVERRIDE</env>
environment variable\&.
.RE
.PP
\fB\-stylesheet=FILENAME\fR
.RS 4
This option allows for specifying a style sheet to alter the appearance of some or all widgets of qdmr\&.
.RE
.SH "LOGGING"
.PP
Qdmr writes a lot of debug and error messages to
<io>stderr</io>\&. This can be used to inspect some issues during reading/writing the a codeplug to the device\&. There is also a log file containing these messages usually at
<file>~/\&.local/share/DM3MAT/qdmr/qdmr\&.log</file>\&.
.SH "BUGS"
.PP
This program is still under development and may contain bugs that may cause harm to the radios and may even destroy them\&. Hence you may use this software on your own risk\&. If you want to have guaranties, consider using the CPS (code\-plug programming software) supplied with your radio\&.
.PP
There are some issues with the so\-called dark mode under Linux\&. The Qt library is not able to detect that the desktop has a dark mode theme\&. To this end, qdmr cannot react to it too\&. To enable a dark theme for qdmr, see the
\fB\-style\fR
option above\&.
.PP
Writing a single application supporting several radios of different manufacturers is a hard task\&. To this end, there are plenty of bugs to be expected\&. If you stumble across one of them, consider opening an issue at
<xlink></xlink>\&.
.SH "AUTHOR"
.PP
\fBHannes Matuschek\fR <\&dm3mat@darc\&.de\&>
.RS 4
Main author
.RE