unifi

Created By: Schwark Satyavolu, 2 Stars, Last Updated: 07/02/21 02:38:48

Love this? Please consider supporting its creator by starring or sponsoring this project on GitHub!

From the project's README:

alfred-unifi

Alfred Workflow for interacting with Unifi controllers - not tested on UnifiOS controllers

Install

  • Download .workflow file from Releases
  • Can be installed from Packal at http://www.packal.org/workflow/unifi-controller-workflow
  • Can also be downloaded from github as a zip file, unzip the downloaded zip, cd into the zip directory, and create a new zip with all the files in that folder, and then renamed to Smartthings.alfredworkflow
  • Or you can use the workflow-build script in the folder, using
    chmod +x workflow-build
    ./workflow-build . 

    Controller

uf ip <controller-ip>

This should only be needed once per install or after a reinit

Credentials

uf upwd <username> <password>

This should only be needed once per install or after a reinit - stored securely in MacOS keychain

Device/Client/Icons Update

uf update

This should be needed once at the install, and everytime you want to refresh information on devices/clients - should happen automatically at least once a day

Device Commands

uf <device-name> clients|reboot|upgrade

devices - are UniFi devices - switches, gateways, routers, APs, etc. search term can be alias, hostname or ip

  • clients - gives you the list of clients attached to this device
  • reboot - reboots device
  • upgrade - upgrades device to latest firmware (items marked with a * in subtitle when upgradable)

Client Commands

uf <client-name> reconnect|block|unblock

clients are endpoints that connect to the network. search term can be name or ip

  • reconnect - forces the endpoint to reconnect to the network
  • block - kicks the endpoint off the network, and prevents it from connecting
  • unblock - undoes the above

Radius Commands

uf <radius-account-name> 

Read-only at the moment - pulls up all radius accounts matching search term and some details on them. search term is the username

Update Frequency

uf freq <number-of-seconds>

This is an optional setting to change how frequently the clients and their status is updated. This takes a couple of seconds and so making it too small may be annoying, but it is a tradeoff between fresh data and speed of response. By default, this is updated once a day. A more aggressive but still usable setting is 3600 or every hour.

Reinitialize

uf reinit

This should only be needed if you ever want to start again for whatever reason - removes all API keys, devices, scenes, etc.

Update

uf workflow:update

An update notification should show up when an update is available, but if not invoking this should update the workflow to latest version on github

Acknowledgements

Icons made by Freepik from www.flaticon.com
Icons made by Good Ware from www.flaticon.com
Icons also from IconFinder