https://github.com/niklasberglund/huesh

Shell script for controlling Hue lights
https://github.com/niklasberglund/huesh

hue hue-api hue-bridge hue-lights shell shell-script

Last synced: 8 months ago
JSON representation

Shell script for controlling Hue lights

• Host: GitHub
• URL: https://github.com/niklasberglund/huesh
• Owner: niklasberglund
• License: mit
• Created: 2018-11-16T23:44:47.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2018-11-21T21:26:16.000Z (over 7 years ago)
• Last Synced: 2025-01-20T02:49:13.329Z (over 1 year ago)
• Topics: hue, hue-api, hue-bridge, hue-lights, shell, shell-script
• Language: Shell
• Homepage:
• Size: 923 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# huesh

A shell script for controlling Hue lights.

## Usage

First you need to push button on the Hue bridge, then run `huesh.sh pair` and you're good to go. Credentials are stored on disk so you only need to run `pair` once.

Find out id:s of your lights by running `huesh.sh list-lights` and then for example change brightness by running `huesh.sh set-brightness 1 100` where 1 is the id of the light and 100 is the desired brightness.

![Screenshot](screenshot.png "Usage example screenshot")

## Help text

```

Usage: huesh.sh  []

Tool for controlling Hue lights.

EXAMPLES:

    huesh.sh pair # Pair with Hue bridge

    huesh.sh list-lights # List all lights in your Hue system

    huesh.sh set-brightness 1 100 # Set brightness level for light with id 1

COMMANDS:

    help             Prints these usage instructions.

    pair             Pair with a Hue bridge on the same network. Note that you must push the button on Hue bridge before pairing.

    list-lights      List all Lights in your Hue system.

    list-scenes      List all scenes in your Hue system.

    set-hsl          Set hue, saturation and brightness for a specific light.

    set-hue          Set hue for a specific light.

    set-saturation   Set saturation for a specific light.

    set-brightness   Set brightness for a specific light.

```

## TODO

* Improve help - individual help text per command (e.g. `huesh.sh help set-hsl`)

* Improve help - print command's expected arguments when supplying invalid arguments.

* Make more portable by removing Python dependency etc

Pull requests are welcome!