Start from scratch or import your ETS project. bussard keeps your KNX configuration in TOML files that you edit by hand or with your favorite LLM. It programs your devices, decodes the bus and keeps a history of every edit, so you can undo it.Starte ein neues Projekt oder importiere dein ETS-Projekt. bussard hält deine KNX-Konfiguration in TOML-Dateien, die du von Hand oder mit deinem LLM bearbeitest. Es programmiert deine Geräte, decodiert den Bus und speichert jede Änderung in einer Historie, damit du sie zurücknehmen kannst.
$ bussard import house.knxproj imported 318 group addresses, 72 devices, 540 link entries → the current directory $ claude mcp add knx -- bussard mcp --dir "$PWD" > The hallway button should also switch the porch light.Der Flurtaster soll auch das Terrassenlicht schalten. ✓ Outdoor actuator, channel C, now listens to Hallway light. Project only, saved to history.Außenaktor, Kanal C, hört jetzt auf Flurlicht. Nur im Projekt, in der Historie gesichert. $ bussard plan 1.1.7 1.1.7 Outdoor actuator + c-switch now listens on 1/1/1 (Hallway light) $ bussard apply 1.1.7 --allow-remote-gateway apply 1 change(s) to 1.1.7 via 192.0.2.10:3671? [y/N] y backup written to captures/backups/ apply verified: address table Loaded (4 entries), … $
Ask an assistant that speaks MCP, such as Claude Code, Claude Desktop or Codex CLI. It sets up your project from the ETS export, then edits it and writes a device only after your yes. Pick a step to see an example.Frag einen Assistenten, der MCP spricht, etwa Claude Code, Claude Desktop oder Codex CLI. Er richtet dein Projekt aus dem ETS-Export ein, dann bearbeitet er es und schreibt ein Gerät erst nach deinem Ja. Wähle einen Schritt für ein Beispiel.
knx_setup{"project_file": "house.knxproj", "download": true}knx_setup{"project_file": "house.knxproj", "download": true}Register the server on an empty folder and the assistant does the
setup. At the terminal, bussard init house.knxproj does the same.Registriere den Server auf einem leeren Ordner, und der Assistent übernimmt das Setup.
Im Terminal macht bussard init house.knxproj dasselbe.
knx_model_lookup{"query": "kitchen
ceiling"}knx_recent_telegrams{"ga": "1/",
"since": "2026-11-03T18:00:00Z"}knx_model_lookup{"query":
"Deckenlicht"}knx_recent_telegrams{"ga": "1/",
"since": "2026-11-03T18:00:00Z"}The default server listens and may send read requests. It never writes a group value or a device.Der Server hört standardmäßig mit und darf Leseanfragen senden. Er schreibt nie einen Gruppenwert und nie ein Gerät.
knx_remove_link{"address": "1.1.4",
"com_object": 12, "ga": "1/1/1", "role": "listen"}knx_show_device{"address": "1.1.4",
"channel": "a-3"}knx_set_parameter{"address": "1.1.4",
"channel": "a-3", "parameter": "switch-off-delay", "value": "10 min"}knx_remove_link{"address": "1.1.4",
"com_object": 12, "ga": "1/1/1", "role": "listen"}knx_show_device{"address": "1.1.4",
"channel": "a-3"}knx_set_parameter{"address": "1.1.4",
"channel": "a-3", "parameter": "ausschaltverzoegerung", "value": "10 min"}The parameter keys come from the vendor's product data, the
same ones knx_show_device lists.Die Parameter-Schlüssel
stammen aus den Produktdaten des Herstellers, dieselben, die knx_show_device
auflistet.
knx_plan_device{"address":
"1.1.4"}knx_apply_device{"address": "1.1.4",
"plan_digest": "9c41…"}knx_plan_device{"address":
"1.1.4"}knx_apply_device{"address": "1.1.4",
"plan_digest": "9c41…"}Only on a server started with
--allow-programming. Without it, the assistant hands you bussard plan and
bussard apply for the terminal.Nur mit einem Server, der
mit --allow-programming gestartet wurde. Ohne das gibt dir der Assistent
bussard plan und bussard apply für das Terminal.
knx_backup_device{"all":
true}knx_history{"limit": 5}knx_undo{}knx_backup_device{"all":
true}knx_history{"limit": 5}knx_undo{}Backups run on the default server: they only read the devices. Undo restores the project files.Backups laufen auf dem Standard-Server: sie lesen die Geräte nur. Undo stellt die Projektdateien wieder her.
Everything bussard knows about your installation is stored in text files. Edit them in any editor, or let Claude / ChatGPT do it. Commands either write that config to devices or read the bus and explain it with the same config. Every edit can be undone.Alles, was bussard über dein Projekt weiß, ist in Text Dateien gespeichert. Bearbeite sie in einem beliebigen Editor oder lass das von Claude / ChatGPT erledigen. Mit Befehlen kannst du dann die Konfiguration auf die Geräte schreiben oder den Bus lesen. Jede Änderung lässt sich zurücknehmen.
One line per group address (groups.toml) and one file per device
(devices/1.1.47.toml) including a table per channel.
Keys and values come from the vendor's product data, so a channel reads like its page in ETS. Vendor ids
and memory offsets live in the generated bussard.lock, which nobody edits.Die Gruppenadressen (groups.toml) und die Geräte (devices/*.toml)
werden jeweils in einer Datei mit Tabellen
für jeden Kanal konfiguriert.
Die Keys und Werte stammen aus den Produktdaten des Herstellers, daher liest sich ein Kanal wie seine
Seite in der ETS. Hersteller-IDs und Speicher-Offsets stehen im generierten bussard.lock, das
niemand bearbeitet.
project = "Demo House"
groups = [
{address="1/1/1", name="Hallway Light", dpt="1.001"},
{address="1/1/7", name="Porch Light", dpt="1.001"},
{address="1/1/8", name="Porch Status", dpt="1.001"},
{address="3/0/0", name="Alarm", protected=true, dpt="1.005"},
]
address = "1.1.47" name = "Switch actuator, 2-gang / blinds actuator, 1-gang" product = "230021SU" [location] floor = "DG" room = "Gast 2 Süd" [channel.relaisausgaenge-1] betriebsart = "Lüftungsklappe / Dachfenster" langzeitbetrieb.listen = ["3/1/20"] rueckmeldung-lueftungsklappen-dachfensterposition.send = "3/1/23"
You see what will change before anything is sent, and the previous state is saved so you
can go back. An assistant edits the project. It writes a device only on a server started
with --allow-programming, after your yes to its plan.Bevor etwas
geschrieben wird, siehst du, was sich ändert. Der vorherige Zustand wird gesichert, damit du zurück
kannst. Ein Assistent bearbeitet das Projekt. Auf ein Gerät schreibt er nur mit einem Server, der mit
--allow-programming gestartet wurde, und erst nach deinem Ja zu seinem Plan.
Raw KNX telegrams carry addresses and bytes. bussard resolves both against your config,
so a line in monitor reads like a sentence.Rohe KNX-Telegramme
enthalten Adressen und Bytes. bussard löst beides gegen deine Konfiguration auf, sodass sich
eine Zeile in
monitor wie ein Satz liest.
An agent gets exactly the access you start the server with:Ein Agent bekommt genau den Zugriff, mit dem du den Server startest:
$ claude mcp add knx -- bussard mcp --dir "$PWD"
bussard mcp --listen serves the same tools over HTTP, for
a client that connects to a URL.bussard mcp --listen bietet
dieselben Tools über HTTP an, für einen Client, der sich mit einer URL verbindet.
Home Assistant users: bussard ha-config writes the KNX
integration config from the same TOML files. With --allow-home-assistant the assistant
writes it for you, after your yes.Für Home Assistant erzeugt
bussard ha-config die Konfiguration der KNX-Integration aus denselben TOML-Dateien. Mit
--allow-home-assistant schreibt der Assistent sie für dich, nach deinem Ja.
--allow-writesOpt-in mit --allow-writesGroup
writes and the tests in tests.toml. Group addresses marked protected are
still refused, with no override over MCP.Gruppen-Schreiben und die Tests
in tests.toml. Gruppenadressen mit protected werden weiter abgelehnt,
ohne Ausnahme über MCP.--allow-programmingOpt-in mit --allow-programmingWrites a device after your yes to its plan: links, parameters and, when needed, its
application. Also adds, replaces, restores and restarts devices.Schreibt
ein Gerät nach deinem Ja zu seinem Plan: Verknüpfungen, Parameter und, wenn nötig, die
Applikation. Nimmt außerdem Geräte auf, ersetzt, stellt wieder her und startet neu.
Just download and run. Each file has a .sha256 checksum
next to it. Links always point to the latest
release.Einfach herunterladen und starten. Zu jeder Datei gibt es eine
.sha256-Prüfsumme. Die Links zeigen immer auf das neueste Release.
# macOS and Linux# macOS und Linux curl -fsSL https://raw.githubusercontent.com/tmbo/bussard/main/install.sh | sh # or with Homebrew# oder mit Homebrew brew tap tmbo/tap && brew trust tmbo/tap brew install tmbo/tap/bussard # Windows, in PowerShell# Windows, in der PowerShell irm https://raw.githubusercontent.com/tmbo/bussard/main/install.ps1 | iex
The installers verify the checksum and put bussard on your
PATH. A binary downloaded by hand needs chmod +x, and on macOS once
xattr -d com.apple.quarantine, because it is not notarized. Windows shows a SmartScreen
warning for the same reason.Die Installer prüfen die Prüfsumme und legen
bussard in den PATH. Eine von Hand geladene Binary braucht chmod +x und auf
macOS einmal xattr -d com.apple.quarantine, weil sie nicht notarisiert ist. Windows zeigt aus
demselben Grund eine SmartScreen-Warnung.
# needs Rust 1.88 or newer# braucht Rust 1.88 oder neuer
git clone https://github.com/tmbo/bussard
cd bussard
cargo install --path crates/bussard-cli
You need a KNXnet/IP gateway to talk to a bus. An ETS export and vendor
.knxprod files are optional but make the first minutes much nicer.Du brauchst ein KNXnet/IP-Gateway, um mit einem Bus zu sprechen. Ein ETS-Export und
.knxprod-Dateien der Hersteller sind optional, machen die ersten Minuten aber deutlich
angenehmer.
This is early software that writes to real building hardware. Device programming covers System B (masks 07B0, 27B0, 57B0) and System 7 (masks 0700, 0701, 0705); the device support page lists the rest. Read the safety notes before your first write, and try it on a spare device or the simulator first.Das ist frühe Software, die auf echte Gebäudetechnik schreibt. Geräteprogrammierung deckt System B (Masken 07B0, 27B0, 57B0) und System 7 (Masken 0700, 0701, 0705) ab; den Rest listet die Seite Geräteunterstützung. Lies die Sicherheitshinweise vor dem ersten Schreiben und probiere es zuerst an einem Ersatzgerät oder im Simulator aus.