ziggs/README.md

40 lines
1.5 KiB
Markdown
Raw Normal View History

2022-09-06 23:36:38 +00:00
# Ziggs
2022-09-22 03:48:13 +00:00
![Ziggs Demo](https://tcp.ac/i/UTlJi.gif)
2022-09-06 23:36:38 +00:00
2022-09-22 03:48:13 +00:00
There are zigbees in my head.
2022-09-06 23:36:38 +00:00
2022-09-22 03:48:13 +00:00
### Huh?
This tool was only planned as a personal tool for myself, consequentially the codebase is pretty messy.
With that being said, it should work fairly well to provide a command line interface for Phillips Hue brudges.
2022-09-06 23:36:38 +00:00
2022-09-22 03:48:13 +00:00
### Features:
2022-09-06 23:36:38 +00:00
- interactive readline shell
2022-09-22 03:48:13 +00:00
- run `go run ./ shell` || `ziggs shell`
- manage multiple hue bridges at the same time
- e.g target specific bridge: `use ECC0FAFFFED55555`
2022-09-06 23:36:38 +00:00
- control color/brightness/power per light or per group
2022-09-22 03:48:13 +00:00
- e.g. group: `set group kayos brightness 55`
- e.g. light: `set light kayos_lamp off`
- **list**, **delete**, and **rename** for the following targets
- lights
- groups
- scenes
- rules
- schedules
- specify color by HTML hex colors
- e.g: `set group kayos color #2eebd3`
- set light/group colors dynamically based on CPU load (run second time to turn off)
- mode 1 - average across all cores: `set group kayos cpu`
- mode 2 (group only) cycle through individual lights in group and set based on per-core usage: `set group kayos cpu2`
2022-09-06 23:36:38 +00:00
- access firewalled bridge via SOCKS proxy
2022-09-22 03:48:13 +00:00
- to use this, change the config manually (~/.config/ziggs/config.toml)
2022-09-06 23:36:38 +00:00
- port scan to find offline (no call home) bridges on LAN
2022-09-22 03:48:13 +00:00
- e.g: `scan`
- config will automatically save when a bridge connection is established
2022-09-06 23:36:38 +00:00
---
2022-09-06 23:38:29 +00:00
I use this every day to ~~inflict pain upon myself~~ control the lights inside and outside of my house.