Scroll to navigation

QTDMM(1) User Commands QTDMM(1)

NAME

qtdmm - read out and record digital multimeters

SYNOPSIS

qtdmm [--config-id id] [--config-dir dir] [--debug]
qtdmm -h | --help | -v | --version

DESCRIPTION

QtDMM reads digital multimeters and bench meters and shows the reading as an LCD display and an analog meter. A configurable recorder draws the readings as a graph. It can start by hand, at a set time or when a threshold is crossed, and exports to CSV, Excel (.xlsx), OpenDocument (.ods), SVG, PDF, PNG and JPEG.

More than 150 meters are supported, connected over:

  • serial ports and USB-serial cables;
  • USB-HID cables such as the UNI-T UT-D04/UT-D09 and Brymen BU-86X;
  • the network (RFC 2217, for example through qtdmm-bridge);
  • Bluetooth LE (UNI-T UT60BT, Victron battery monitors, solar chargers and inverters);
  • sigrok-cli(1) for SCPI bench meters.

Further features are a readings table, alarms with actions, calculated values across several meters, a simulated meter for trying QtDMM without hardware, and an SCPI server through which other programs read the meter over the network. The complete handbook is built into the program (Help) and online at https://qtdmm.de/docs/.

OPTIONS

Use the configuration id instead of default. Each id has its own settings file, so one meter can be set up per id; several instances with different ids run side by side and know about each other. An id of letters, digits and underscores (not starting with a digit) can be used in the formula of a calculated value.
Keep the configuration files in dir instead of the platform's user configuration directory.
Print every frame received from the meter as a line of hex bytes on standard output. Include this output, together with what the meter displayed, in a bug report about a meter that is not decoded correctly.
Show the options and exit.
Show the version and exit.

FILES

~/.config/QtDMM/QtDMM.conf
Settings of the default configuration (Linux, FreeBSD and macOS).
~/.config/QtDMM/QtDMM_id.conf
Settings of the configuration id.
%APPDATA%\QtDMM\QtDMM.ini
Settings on Windows; further ids as QtDMM_id.ini.
~/.config/QtDMM/devices.conf
My devices: the meters with their connections, shared by all instances (on Windows %APPDATA%\QtDMM\devices.conf).

EXAMPLES

Start a second instance for another meter:

qtdmm --config-id psu

Capture the raw frames of a meter for a bug report:

qtdmm --debug > frames.txt

SEE ALSO

sigrok-cli(1)

Handbook: https://qtdmm.de/docs/
Source and bug reports: https://github.com/qtdmm/QtDMM
Contact: hello@qtdmm.de

AUTHORS

QtDMM was written by Matthias Toussaint (up to 0.9.3) and has been continued since 0.9.5 by tuxmaster and other contributors; see the AUTHORS file.

LICENSE

GNU General Public License, version 3 or later.

2026-10-15 QtDMM 26.2