Magic Home CLI + Lib

This repository offers the possibility to control Magic Home (Magic Hue) LED Strip Controller. The control can be done via terminal using the CLI or programmatically using the library. It is written in Go and already compiled for various systems and architectures like Linux, FreeBSD, macOS and Windows for amd64, i386, ARM. Take a look on the GitHub releases page for a list of available binaries.

Features

• Change the state of the LED Strip Controller to on or off
• Change the color of the LED Strip Controller with RGBW
• Provides a simple ready-to-use CLI
• Can be used as a library to control the controller in your own applications

CLI

Install

Choose the archive matching the destination platform and extract it.

$ wget -qO- https://github.com/moonliightz/magic-home/releases/download/v1.1.0/magic-home_1.1.0_linux_x86_64.tar.gz | tar -zxvf - magic-home

Binaries are available on the GitHub releases page.

Usage

$ ./magic-home --help

NAME:
   magic-home - A CLI for controlling Magic Home (Magic Hue) LED Strip Controller

USAGE:
   magic-home [global options] command [command options] [arguments...]

COMMANDS:
   color, c     Set the color of the LED Strip
   state, s     Switch the LED Strip state to on or off
   discover, d  Discover for Magic Home devices on the network
   help, h      Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h  show help (default: false)

• Discover devices

$ ./magic-home discover

• Turn LED Strip Controller on

$ ./magic-home state 192.168.1.42 on

• Turn LED Strip Controller off

$ ./magic-home state 192.168.1.42 off

• Switch Color to red with 100% brightness

$ ./magic-home color 192.168.1.42 255 0 0 0

• Switch Color to cyan with 100% brightness

$ ./magic-home color 192.168.1.42 0 255 255 0

Change 192.168.1.42 to the IP of your Controller.
If your controller only supports RGB instead of RGBW, just set the last value to 0.

Library

Install

$ go get -u github.com/moonliightz/magic-home

Usage

// Create a new Magic Home LED Strip Controller
controller, _ := magichome.New(net.ParseIP("192.168.1.42"), 5577)

// Turn LED Strip Controller on
controller.SetState(magichome.On)

// Tun LED Strip Controller off
controller.SetState(magichome.Off)

// Set color of LED Strip to white
controller.SetColor(magichome.Color{
  R: 255,
  G: 255,
  B: 255,
  W: 0,
})

// Don't forget to close the connection to the LED Strip Controller
controller.Close()

For a ready-to-use example take a look at examples/basic/main.go.

License

magic-home is released under the MIT license.