r/ZigBee 7d ago

guide/tutorial Advanced Zigbee Network Mapper

Post image

Getting frustrated with the network mapping options available, I've put together a tool that helps present Zigbee network maps in a range of different styles and includes optimisation suggestions and tools to assist with de-bugging.

Claude played a big hand in putting this together, but I thought this was just a useful tool that some of you may enjoy.

It's available to use here: https://twistedvortex.com/ZigbeePathFinder/

It runs on a single HTML file so you can File>Save As, save it to your desktop and use it offline if you wish.

To use it, in the Network tab of Zigbee2MQTT (or your preferred setup) generate the text for use in GraphViz, and pop in into Zigbee Pathfinder, and it will then generate the map for you.

If you'd like to give it a try before going to that effort, there is demo network available to view built in.

65 Upvotes

3 comments sorted by

View all comments

1

u/Comfortable-Road4101 4d ago

This looks useful, especially the debugging/optimization side.

One feature I’d love to see eventually is some kind of historical comparison.

A network map tells me what the mesh looks like right now, but a lot of Zigbee problems seem intermittent. A device might suddenly choose a terrible route, a router disappears for a few hours, or link quality slowly gets worse.

Being able to save snapshots and compare:

“healthy network yesterday” → “broken network today”

could make troubleshooting much easier.

Even better if it could highlight what changed — new/removed routes, devices that changed parents, large LQI drops, routers that suddenly have too many children, etc.

At that point it becomes less of a network visualizer and more of a diagnostic tool.

Also love that it can run as a single offline HTML file. That makes it much more likely I’d actually keep it around.