Zigbee PathFinder

Map · Diagnose · Optimise

Find out what your Zigbee mesh is actually doing.

Paste a Zigbee2MQTT network map below. PathFinder redraws it as something you can read, grades every link, and tells you which devices are one bad hop from dropping off — with the fixes ranked by how much they'd help.

or drop a .dot / .json file anywhere on this panel

awaiting input

Haven't got an export handy?

Getting your network map

Open Zigbee2MQTT — in Home Assistant it's under Apps, previously called Add-ons
Click Open Web UI
Go to the Network tab
Under Type, choose External - GraphViz
Tick Enable routes
Click Load — a full scan takes a minute or two on a large network
Copy the text it produces and paste it above

Prefer to do it over MQTT?

Publish this to zigbee2mqtt/bridge/request/networkmap, then read the reply on zigbee2mqtt/bridge/response/networkmap and copy the data.value string. {"type":"graphviz","routes":true}

Zigbee PathFinder — a Twisted Vortex project Runs entirely in your browser. No export is uploaded anywhere.

Zigbee PathFinder

Layout

Link quality (LQI)

Click a band to isolate it. LQI is directional — the map draws the weaker of the two directions so nothing looks better than it is.

Weak-link threshold

Everything below this counts as a weak hop in the report. 60 is a sensible default; raise it if you want to chase marginal links.

Display

Problem flags Router-to-router links Battery devices Signal flow LQI values on links Device names Horizontal names

Names sit along their own spoke by default, which keeps them from colliding on a busy mesh. Switch to horizontal if you find them easier to read flat.

Find a device

Key

Coordinator

Router — mains powered

End device — coloured by its link

Flagged — see report

Not seen in 24h

Say Thanks

Zigbee PathFinder
a Twisted Vortex project
Everything runs locally in your browser.

Scroll to zoom · drag to pan · click a device

RELAXING THE GRAPH…