1
0
Fork 0
A commandline utility written in Kotlin to control your Elgato Key Light and Key Light Air.
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Florian Schrofner e646c9253c update readme 1 year ago
.github/workflows add os name to native build artifact 1 year ago
gradle/wrapper initial commit 1 year ago
src setup jvm target, move koin modules to components 1 year ago
.gitignore initial commit 1 year ago
LICENSE add license 1 year ago
README.md update readme 1 year ago
build.gradle.kts setup jvm target, move koin modules to components 1 year ago
gradle.properties split code into common and native components 1 year ago
gradlew initial commit 1 year ago
gradlew.bat initial commit 1 year ago
settings.gradle.kts initial commit 1 year ago

README.md

happy-cat 🐈🌞

A commandline utility to control your Elgato Key Light and Key Light Air, written in Kotlin.
Script your light settings or use configuration files to automatically apply your preferred setup over the course of the day, possibly even exploring the use as a light therapy device.

Please report issues, bugs or feature requests here.

Running

Download the newest release for your system from the releases page.
On Linux and Mac OS you can run the native binaries by simply executing ./hc.
On all other systems you have to resort to java by downloading the JVM version and running the jar like java -jar ./hc.jar

Usage

schrofi@linux ~> hc
Usage: hc [OPTIONS] COMMAND [ARGS]...

  A commandline utility to control your elgato keylight

Options:
  -h, --help  Show this message and exit

Commands:
  apply   Applies the currently valid configuration inside the configuration
          file to the specified light
  daemon  Starts a daemon which applies the currently valid configuration
          inside the configuration file every minute
  get     Gets and prints the current setting of the specified light
  set     Sets the defined values to the specified light

happy-cat is split up into multiple subcommands, each of which have their own parameters. To find out more about each command, check out the help pages by appending --help after the command.

Important: happy-cat uses Kelvin to measure light temperature, while Elgato lamps use their own format internally. Conversion between the two is done on the fly

Apply

Reads the provided configuration file, determines the currently active state based on time definitions and applies the state to the given light once. It's basically a oneshot version of the daemon command. For examples of the configuration file, check the corresponding paragraph below.

Example

hc apply ./elgato.config elgato.local

Daemon

Reads the given configuration file, then determines and applies the currently valid configuration every minute.

Example

hc daemon ./elgato.config elgato.local

Get

Reads and prints the current status of the specified light.

Example

hc get elgato.local

Set

Sets the given values of powerstatus, brightness and temperature to the specified light.

hc set -p ON -b 70 -t 4200 elgato.local

Configuration

To automatically apply settings, you can create your own configuration file which defines the settings for each timeframe. All values inside status are optional, if they are not defined, those parameters will remain unchanged. Timeframes can cross midnight, but must not overlap. If there are overlapping timeframes, the first valid timeframe will be chosen.

{
  "config": [
    {
      "start": "8:30",
      "end": "11:00",
      "status": {
        "power": "ON",
        "brightness": 100,
        "temperature": 6500
      }
    },
    {
      "start": "11:00",
      "end": "20:00",
      "status": {
        "brightness": 70,
        "temperature": 4300
      }
    },
    {
      "start": "20:00",
      "end": "8:30",
      "status": {
        "temperature": 3000
      }
    }
  ]
}

Automation

Probably one could automate the setup using systemd and/or cronjobs, but so far I didn't get to that.

Building

Linux and Mac OS

To build native binaries run:

./gradlew nativeBinaries

You can then find the executable in build/bin/native/hcReleaseExecutable.

Windows and others

To build the Java package run:

./gradlew shadowJar

You can then find the jar in build/libs.

License

This software is licensed under the MPL 2.0, see the LICENSE file.