# Install wmbusmeters with Homebrew, dnf

Read wired or wireless mbus protocol to acquire utility meter readings. Version 3.0.0 via Homebrew; verified 2026-06-18.

## Install

```sh
sudo av install brew:wmbusmeters
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install wmbusmeters
```

  Evidence: local Homebrew formula metadata

### Linux

- dnf (92%):

```sh
sudo dnf install wmbusmeters
```

  Evidence: Fedora Rawhide package metadata: wmbusmeters from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

## Package facts

- **Package key:** brew:wmbusmeters
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/wmbusmeters>
- **Version:** 3.0.0
- **Source summary:** Read wired or wireless mbus protocol to acquire utility meter readings
- **Homepage:** <https://github.com/wmbusmeters/wmbusmeters>
- **Repository:** <https://github.com/wmbusmeters/wmbusmeters>
- **Upstream docs:** <https://github.com/wmbusmeters/wmbusmeters#readme>
- **License:** GPL-3.0-or-later
- **Source archive:** <https://github.com/wmbusmeters/wmbusmeters/archive/refs/tags/3.0.0.tar.gz>
- **Last updated:** 2026-06-18T00:56:00Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- wmbusmeters (cli)
- wmbusmetersd (cli)
- wmbusmeters (alias)
- wmbusmetersd (alias)

## Dependencies

- librtlsdr
- libusb

## Build dependencies

- pkgconf

## Uses from macOS

- libxml2

## Install behavior

- Post-install hook: not defined
- Service: declared
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 3.0.0
- Package-manager updated: 2026-06-18
- Local data: ok
- Upstream repository: https://github.com/wmbusmeters/wmbusmeters
- Upstream latest detected: 3.0.0 (current)
## Project history and usage

wmbusmeters is a utility-meter data acquisition tool for wired M-Bus and wireless M-Bus meters. It turns meter telegrams into human-readable, CSV, JSON, MQTT, REST, database, or log-file output, making it a bridge between low-level metering radio protocols and home automation or operations systems.

### Project history

The public GitHub repository was created in August 2017 and has grown into a focused C++ project with a large catalog of meter drivers. Its README frames the program around a concrete transformation: receive raw M-Bus or wireless M-Bus telegrams from meters, decode the manufacturer- and model-specific content, and publish readings in formats that other software can consume.

The project has continued to evolve through driver additions and decoding changes rather than through a single protocol abstraction. Recent release notes show a 2.0.0 release in March 2026 that moved some manufacturer-specific protocol decoders from C++ into editable XMQ files with Invisible XML grammars, described by the maintainers as a major step toward making all drivers editable text files rather than compiled code.

### Adoption history

wmbusmeters has visible adoption in smart-home and utility-monitoring circles because many water, heat, gas, and electricity meters expose wireless M-Bus telegrams but do not provide a convenient local API. The official Home Assistant add-on repository says it lets users acquire readings without a vendor bridge or gateway when meters support C1, T1, or S1 wireless M-Bus telegrams.

The project also maintains an online analyzer at wmbusmeters.org for inspecting telegrams with the same command-line analyzer syntax. That service and the long supported-driver list demonstrate that wmbusmeters has become a shared decoder knowledge base for a messy field of real-world meters.

### How it is used

Typical use combines a supported radio dongle, serial M-Bus interface, RTL-SDR software-radio input, file, or pipe with meter definitions and optional decryption keys. Users run it as an interactive decoder while commissioning meters, or as the wmbusmetersd daemon to publish recurring readings to MQTT, REST endpoints, databases, or logs.

### Why package nerds care

The package is significant because it packages practical reverse-engineering and protocol normalization for a long tail of utility meters. For self-hosting users, it is often the component that turns a cheap receiver and a meter key into local, scriptable energy and water telemetry.

### Timeline

- 2017: wmbusmeters/wmbusmeters public repository created on GitHub.
- 2023: GitHub release history records the 1.13.x release line.
- 2024: 1.17 and 1.18 releases document continued driver additions and XMQ driver changes.
- 2026: 2.0.0 release notes describe moving selected manufacturer protocol decoders toward editable XMQ grammar files.
- 2026: 3.0.0 appears as the latest GitHub release in June.

### Related projects

- wmbusmeters-ha-addon is the official Home Assistant add-on repository for running wmbusmeters in a smart-home deployment.
- rtl-wmbus and RTL-SDR workflows commonly supply wireless telegrams that wmbusmeters decodes.

### Sources

- <https://api.github.com/repos/wmbusmeters/wmbusmeters>
- <https://api.github.com/repos/wmbusmeters/wmbusmeters/releases?per_page=100>
- <https://github.com/wmbusmeters/wmbusmeters>
- <https://github.com/wmbusmeters/wmbusmeters-ha-addon>
- <https://github.com/wmbusmeters/wmbusmeters/releases>
- <https://wmbusmeters.org/>


## Security Notes

formula declares a Homebrew service.

- **Geiger risk:** orange / medium
- formula declares a Homebrew service


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: /etc/wmbusmeters/wmbusmeters.conf, /etc/wmbusmeters/wmbusmeters.d, /home/me/.config/wmbusmeters/wmbusmeters.conf, /home/me/.config/wmbusmeters/wmbusmeters.d
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** wmbusmeters
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- dnf - wmbusmeters - 2.0.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: wmbusmeters from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Read the wireless mbus protocol to acquire utility meter readings | https://github.com/weetmuts/wmbusmeters


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [librtlsdr](https://www.automicvault.com/pkg/brew/librtlsdr/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [ansiweather](https://www.automicvault.com/pkg/brew/ansiweather/) - Shares av.db curated category or tags: cli, monitoring, system.
- [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: cli, monitoring, system.
- [bottom](https://www.automicvault.com/pkg/brew/bottom/) - Shares av.db curated category or tags: cli, monitoring, system.
- [bpytop](https://www.automicvault.com/pkg/brew/bpytop/) - Shares av.db curated category or tags: cli, monitoring, system.
- [btop](https://www.automicvault.com/pkg/brew/btop/) - Shares av.db curated category or tags: cli, monitoring, system.
- [collectd](https://www.automicvault.com/pkg/brew/collectd/) - Shares av.db curated category or tags: cli, monitoring, system.
- [ctop](https://www.automicvault.com/pkg/brew/ctop/) - Shares av.db curated category or tags: cli, monitoring, system.
- [devcockpit](https://www.automicvault.com/pkg/brew/devcockpit/) - Shares av.db curated category or tags: cli, monitoring, system.

## Combined YAML source

View the package source record on GitHub. [combined/wmbusmeters.yml](https://github.com/automic-vault/db/blob/main/combined/wmbusmeters.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
