Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/neroist/nova
Nova is a CLI for controlling Govee light strips, inspired by Bandev's Lux.
https://github.com/neroist/nova
cli govee govee-api nim nim-lang nova
Last synced: 26 days ago
JSON representation
Nova is a CLI for controlling Govee light strips, inspired by Bandev's Lux.
- Host: GitHub
- URL: https://github.com/neroist/nova
- Owner: neroist
- License: mit
- Created: 2022-01-22T22:15:55.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-31T16:55:41.000Z (7 months ago)
- Last Synced: 2024-10-25T05:54:20.563Z (2 months ago)
- Topics: cli, govee, govee-api, nim, nim-lang, nova
- Language: Nim
- Homepage: https://nova.nim.town
- Size: 5.93 MB
- Stars: 6
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nova
Nova is a CLI for controlling Govee light strips. Inspired by Jack Devey's [Lux](https://github.com/jackdevey/Lux).
Made with Nim 👑
Not affiliated with Govee.
## Contents
(Tip: Click on the 3 lines on the file header to access the automatically generated table of contents.)
- [Supported Devices](#supported-devices)
- [Notes](#important-notes)
- [Installation](#installation)
- [How To Get Govee API Key](https://neroist.github.io/nova/api-key.html)
- [Deletion](#deletion)
- [Documentation](#documentation)
- [Build From Source](#build-from-source)
## Supported Devices
Not all Govee devices are supported by Nova. The devices supported by Nova are:
H6160, H6163, H6104, H6109, H6110, H6117, H6159, H7022, H6086,
H6089, H6182, H6085, H7014, H5081, H6188, H6135, H6137, H6141,
H6142, H6195, H7005, H6083, H6002, H6003, H6148, H6052, H6143,
H6144, H6050, H6199, H6054, H5001, H6154, H6072, H6121, H611A,
H5080, H6062, H614C, H615A, H615B, H7020, H7021, H614D, H611Z,
H611B, H611C, H615C, H615D, H7006, H7007, H7008, H7012, H7013,
H7050, H6051, H6056, H6061, H6058, H6073, H6076, H619A, H619C,
H618A, H618C, H6008, H6071, H6075, H614A, H614B, H614E, H618E,
H619E, H605B, H6087, H6172, H619B, H619D, H619Z, H61A0, H7060,
H610A, H6059, H7028, H6198, H6049, H7031, H7032, H61A1, H61A2,
H61B2, H7061, H6067, H6066, H6009, H7041, H7042, H604A, H6173,
H615E, H604B, H6091, H7051, H7062, H618F, H605D, H6046, H601A,
H61A3, H610B, H6047, H7065, H61E1, H6057, H604C, H6065, H605C,
H705A, H705B, H7055, H61A5, H6078, H604D, H6168, H6601, H70B1,
H61A8, H7121, H7122, H7123, H7120, H7141, H7142, H7130, H7131,
H7132, H7150, H7160, H7101, H7111
Only Wi-Fi devices are supported.
## Important Notes
Please refrain from calling commands too quickly or frequently, as it may result in you being rate-limited.
## Installation
You can just download the installer from the [most recent version](https://github.com/neroist/nova/releases/latest), or from `winget` by running:
```sh
winget install Jasmine.Nova
```
For linux, download `installer.sh` and run
```sh
sudo sh installer.sh
```
## Deletion
1. Delete Nova from whatever directory you put it in (or delete the directory itself).
- Or, if you installed with the Windows installer, open Settings, go to Apps, then search for "Nova". When you see Nova, click the three dots and hit "Uninstall."
## Documentation
See
## Build from source
### Requirements
- [Nim](https://nim-lang.org) >= 1.6.8
- Mingw installed from [MSYS2](https://www.msys2.org) MSYS (only needed if you want to build windows installer)
- [Inno Setup](https://jrsoftware.org/isdl.php#stable) (again, only needed for windows installer)
### Build
#### Nova
In order to build, cd into the base directory and run:
```shell
nimble nova
```
If you want to build nova for 32 bit, run this instead:
```shell
nimble -d:nova32 nova
```
On Linux, this may require the `gcc-multilib` and `libcurl4:i386` packages.
#### Installer
Next, to build the installer, run this command:
```shell
nimble installer
```
On windows, this compiles the `installer/installer.iss` file. On Linux, this just copies the `install.sh` file to `bin/`.
The compiled binaries will be available in the `bin/` directory.
###### Made with ❤️ with Nim