As of 24 July 2024, I have lost access to the large, 100+ site Unifi Controller that I have been using to test this tool. If you have a Unifi controller with a large number of sites (e.g. 50+), and you're willing to provide me with a read-only account on your Unifi Controller, please contact me @ [email protected], tweet at me or DM me on twitter (@CryptoSpartanTv), or open up an issue in this repository. If I don't gain access to another Unifi Controller, I plan to stop development of this tool.

Unifi Search Tool - Download Here

Does your unifi controller have lots of sites? Do you frequently have equipment returned from those sites and you can't remember where it's adopted in the controller? Enter Unifi Search Tool.

This tool was designed to allow searching a MAC address from a Unifi device across all of the different sites in a Unifi controller. Currently, the search feature in Unifi only works within a site, there's no way to search across multiple sites.

How to Use

1. Enter your username & password for your Unifi Controller

2. Enter your Unifi Controller domain/IP. You must include the proper http:// or https:// with the appropriate port number at the end, unless it runs on 80/443. (You will see this in the address bar of your browser when you open up your Unifi Controller.)

3. Enter the MAC Address of the device you're searching for

4. Click search

5. Profit

The tool will tell you which site in the controller that the device was adopted to. If it hasn't been adopted, the tool will tell you that the device could not be found.

Build From Source

1. Download the Zip of the source files and extract it

2. Open up a terminal in the directory

3. Run cargo build --release in the terminal

4. Go to the target/release directory to find the unifi-search-tool.exe file

If you would like to optimize the binary for size

1. Install the appropriate toolchain and the rust-src component

$ rustup toolchain install nightly
$ rustup component add rust-src --toolchain nightly

2. Find your host's target triple

$ rustc -vV
...
host: x86_64-unknown-linux-gnu

3. Run the build command

# Use that target triple when building with build-std.
# Add the =std,panic_abort to the option to make panic = "abort" Cargo.toml option work.
# See: https://github.com/rust-lang/wg-cargo-std-aware/issues/56
$ cargo +nightly build -Z build-std=std,panic_abort -Z build-std-features=panic_immediate_abort --target x86_64-unknown-linux-gnu --release

• see https://github.com/johnthagen/min-sized-rust for more details

Advanced

Pre-populate username, password, & URL fields

*** This feature is not functional in the 2.X.X release. If you require the pre-populated fields, you can download v1.4.1 here ***

These instructions are for those that would like to add in their own defaults so that they don't need to re-enter their credentials or controller URL each time the program is opened. (This will only work for the installed version unless you decide to build the portable version from source.)

NOTE: If you choose to do this and credentials are stolen, I am not responsible. This is at your own risk.

1. Find config.txt within the install folder. (Default is C:\Program Files (x86)\Unifi Search Tool)

2. Add in your own values to the right of the = symbol

3. Save config.txt

Next time Unifi Search Tool is launched, it will have new pre-populated fields.