Skip to content
Alejandro Mora edited this page Nov 12, 2026 · 2 revisions

Linux

Readout.Linux runs the same app on Linux, on Microsoft's GTK4 backend for .NET MAUI (dotnet/maui-labs, a preview). It compiles the app's own pages and code; only the Bluetooth connection and a few fixes for gaps in the preview backend are Linux's own. Bluetooth goes through BlueZ over D-Bus. The MCP server for AI assistants works there too.

Running it

Get a tarball from the GitHub releases (or build one with ./publish-linux.sh), unpack it and start readout/Readout. It's self-contained (no .NET install); the machine needs GTK 4.12 or later (libgtk-4-1) and, for the meter, BlueZ running with a powered Bluetooth LE adapter. BlueZ's default policy lets any local user scan and connect, so nothing needs root.

READOUT_FAKE_BLE=1 uses the simulated meter, and Try the demo meter works as everywhere else.

What's different

  • Tabs sit at the top, and pages pushed on top of a tab get a back button in the title bar.
  • Graphs zoom with the mouse wheel (or a touchpad), pan by dragging, and reset on a double-click.
  • Export CSV opens a save dialog instead of a share sheet.
  • BlueZ reports a meter's signal strength only while scanning, so once connected the signal bars show the strength from the scan and hide after 30 seconds without a new one.
  • No continuity beep or vibration yet (as on Windows). Alert boxes show no title.

Tested with

A real 121GW on Fedora 43 (KDE on Wayland, GTK 4.20, BlueZ 5.87): it found the meter, connected in about 2 seconds, showed live readings and the graph, sent short and long key presses, followed dial changes, and reconnected by itself when the meter's Bluetooth came back.

Testing in Docker

tools/linux-test/ runs the app in Docker (Ubuntu 24.04, GTK 4.14, Xvfb) with the simulated meter, or against mock-bluez.py, a stand-in for BlueZ that plays a 121GW. Docker's VM has no Bluetooth, so this is how the BlueZ code gets tried without a meter.

docker build -t readout-linux-test tools/linux-test
dotnet publish Readout.Linux -c Release -r linux-arm64 --self-contained -o <dir> -p:DebugType=none
docker run -d --name ro -v <dir>:/app -v <out>:/out readout-linux-test <mode>

Use linux-x64 on an x86 machine. The modes are fake (the simulated meter), mock (the BlueZ code against mock-bluez.py) and none (no system bus). The app's log is <out>/app.log. Pass -e SCREEN=1280x800x24 to try a small screen.

Readout

Home


Developing

Platforms

Reference (in the repo)

Clone this wiki locally