Giter VIP home page Giter VIP logo

unifi-search-tool's Introduction

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

examplev2

  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

Minimum Rust: 1.65

  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
  1. Find your host's target triple
$ rustc -vV
...
host: x86_64-unknown-linux-gnu
  1. 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

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.

unifi-search-tool's People

Contributors

crypto-spartan avatar dependabot[bot] avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

unifi-search-tool's Issues

Suggestion: Alternative to use a password in code

Suggestion:
There are 2 ways I think would be better than settings user/pass on code.
You can use args and/or make use of environment variables.

Reading args or an enviroment variable for user/password would be a better recommendation, with the added benefit no need to re build / modify code to update credentials.

Searching the MAC Address of a USG Pro 4 is not found

When searching on the MAC Address of a USG Pro 4, the Unifi Search Tool probably won't find it. For some reason, the Unifi controller shows a different MAC address than the API returns.

For example:

  • MAC shown by the unifi controller webpage: XX:XX:XX:XX:59:a7
  • MAC returned by the controller's API: XX:XX:XX:XX:59:a5

It's only a difference of 1 character, but since the MAC isn't a match, the Unifi Search Tool will report that the device wasn't found.

Not sure what the fix will be for this, hopefully I can use a different API endpoint.

Feature Request - Search by device name

I get a lot of push alerts on my phone that have the unifi device name, but not the mac. Opening the alert doesn't take you to the site the device is in. Is it possible to search by the device name?

Can't import unifi_api?

When i do "pip install unifi_api" it's working and it says that it's installed but it's still not working? Can you tell me why is it happening?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.