OPEN-SOURCE BROWSER EXTENSION
Ubicon
Custom device icons for UniFi.
Give every client on your UniFi network the right icon, even the ones UniFi has never heard of. A community-built icon database, your own uploads, and a read-only overlay that never touches your UniFi settings.
View on GitHubCurrent version 0.5.0
Independent project. Not made by, affiliated with, or endorsed by Ubiquiti.
THINGS UNIFI CALLS "UNKNOWN CLIENT"
WHAT IS UBICON
A visual layer on top of UniFi, nothing more.
UniFi's Network admin shows a neat icon for every device it recognizes. For everything it does not, you get a generic placeholder. Ubicon fills that gap: it lets you assign the right icon to any client, from a community database or your own image, and that icon then shows up everywhere UniFi displays the device, the client list, the detail panel, dashboard widgets, insights and flows, and side panes.
WHY WE BUILT IT
Everyone's odd gadgets go unrecognized.
UniFi's fingerprinting is excellent for mainstream gear, but it does not know the less common devices: Bambu Lab and Prusa printers, e-readers, handheld and retro game consoles, Hak5 tools, industrial controllers, and hundreds of other things people actually run at home and at work. Until now there was no clean way to fix those icons without touching UniFi itself. Ubicon fixes the look without ever changing your configuration, and it does it in a way the whole community can extend so no single device stays unrecognized for long.
FEATURES
Everything the extension does
IN THE DATABASE TODAY
Community icon database
Dozens of devices UniFi does not fingerprint, growing with every contribution.
Your own custom icons
Upload any image for a device; it is resized to a clean 128px icon and stays private to your machine.
Shows everywhere
The icon follows the client across the whole UniFi UI.
Read-only and safe
Ubicon never calls the UniFi API and never changes a single UniFi setting.
Works on your controllers
unifi.ui.com out of the box, plus self-hosted and local controllers you add yourself.
Take it with you
Export and import your assignments and custom icons between machines. Or turn on optional GitHub sync and keep every browser in step through a private repository you own, with no item limit and custom icons included. Read the guide.
Cross-browser
Chrome, Edge, Brave, and Firefox.
Always current
Ubicon reads the database straight from the CDN, so new community icons appear without waiting for an extension update.
Open from end to end
The extension and the device database are both public repositories you can read, fork, or extend.
HOW IT WORKS
Four steps, one outbound request
- 1
Ubicon reads a client's identity (its MAC address and name) directly from the UniFi page you are already viewing.
- 2
It matches that client to the icon you assigned.
- 3
Community icons are fetched as plain static files from a public CDN, with no user data attached to the request.
- 4
Everything else, your assignments and any custom icons, stays in your browser. If you turn on optional GitHub sync, they also go to a private repository in your own GitHub account, and nowhere else.
No accounts, no analytics, no tracking, and no servers of ours. One outbound request, for the public icon database.
OPTIONAL GITHUB SYNC
Keep every browser in step
Turn it on and your icon assignments and custom icons are saved to a private repository in your own GitHub account. Connect another browser with a setup code and it shows the same icons, with no item limit.
A free GitHub account is enough.
The token you create opens only that one repository. Ubicon refuses anything broader.
Off until you set it up, and nothing about it ever reaches us.
HOW TO USE IT
From install to the right icon
- 1
Install Ubicon for your browser.
- 2
Open the Clients page in the UniFi Network admin.
- 3
Open a client's Change Icon dialog and click the Ubicon icon that appears.
- 4
Search the community database and pick a match, or switch to the Custom icon tab and upload your own image.
- 5
The icon appears across UniFi immediately. Assignments sync through your browser account; custom images stay on that computer (use Export and Import in the Ubicon popup to move them).
OPEN SOURCE
Add an icon once, every Ubicon user gets it.
Ubicon is open source, and so is its device database. The database is nothing more than JSON records and 128px PNG icons in a public GitHub repository, so anyone can read it, use it, and add to it. If Ubicon does not yet have an icon for your gadget, add it once and every Ubicon user gets it.
Suggest a device
Fill in a short GitHub issue form. No coding required.
Open a pull request
Add the icon and the record directly if you would rather do it yourself.
PRIVACY AND TRUST
Ubicon collects nothing.
It reads device identities only from the page you are viewing, only to place icons, and never sends them anywhere. The single network request it makes is a public download of the community icon database.
Ubicon is read-only. It never calls the UniFi API and never changes a UniFi setting.
One optional exception: GitHub sync. Turn it on and your assignments and custom icons go to a private repository in your own GitHub account, using a token you create, and to nowhere else. Off by default, and we still receive nothing. Everything about GitHub sync.
