SVG · PDF · PNG
Portable diagrams for zooming, printing, and the places that insist on an image.
AGPL-3.0-ONLY · FULLY OPEN SOURCE · LOCAL
Export the topology UniFi already knows.
Turn UniFi Network's clipped, view-only topology into a diagram you can zoom, print, edit, explore, or safely share.
Open source is not a crippled “community edition.” If useful features are withheld until you pay, that is a commercial trial, not the kind of open source this project means. No paid edition, hosted upsell, account requirement, or feature gate: the whole AGPL-3.0-only tool is here, and every renderer runs locally.
No controller changes. No cloud relay. GET is the only HTTP method in the source.
THE PROBLEM
A screenshot is not network documentation.
UniFi's topology is a pan-and-zoom canvas inside a fixed viewport. A full-page capture only gets the visible region; zooming out enough to fit a real network makes its labels useless. unifi-map reads the same local JSON data the console uses and renders the result properly.
CHOOSE THE RIGHT OUTPUT
One topology, useful in more than one place.
draw.io
Editable shapes, already positioned, ready to rearrange and annotate.
HTML
A self-contained explorer for busy maps: pan, zoom, search, trace a client path, and collapse leaves.
DOT · Mermaid · JSON
Graphviz source, Markdown-native diagrams, and a stable normalized topology for programs.
DESIGNED FOR REAL NETWORKS
Keep the useful details. Make uncertainty visible.
- Uses real Ubiquiti device artwork when available, with built-in offline fallbacks.
- Includes clients, not only the infrastructure skeleton.
- Lets you assert links and correct controller mistakes without passing claims off as observations.
--obfuscatereplaces names, addresses, MACs, SSIDs, VLAN names, and ISP details while preserving the topology.
SOCIALIST FREE SOFTWARE
Useful tools belong in the hands of the people who use them.
unifi-map is created in the spirit of worker ownership, solidarity, and the public good. Everyone may use or contribute to it; no political identity is required. Its AGPL license keeps modified hosted versions from becoming a private, closed service.
There will be no proprietary edition, feature-gated open core, mandatory account, telemetry business model, or private sponsor channel that controls the public roadmap.
Read the project values ↗START WITHOUT CREDENTIALS
Map a support file instead of a controller.
Generate a UniFi support file, then render it locally. No API key is needed, and the command below makes no network request.
unifi-map all --support-file support-XXXX.tgz --offline --icons builtin