Skip to main content

A TUI for Philips Hue

Project description

huetui Downloads

a tui for Philips Hue

A pretty screenshot

About

huetui is a terminal user interface that allows for easy control of your Philips Hue lights. It uses the official Hue-Bridge-API to communicate with the lights and py_cui for the front-end.

Installation

AUR

An AUR package is available for installation via an AUR helper:

paru -Syy huetui

pip

Install huetui with:

pip install huetui

This should fetch all the necessary dependencies. Nevertheless, make sure that all dependencies are installed.

Launch huetui by typing huetui into your terminal.

Should you get the error command not found: huetui, try restarting your terminal. Also, in case your upgrading from v1.0 to v2.0, please make sure to remove the old version before upgrading, as described below.

Important notice for upgrading from v1.0 to v2.0

Should you have a previous version of huetui installed, please remove it from your system before upgrading, either by running

pip uninstall huetui

or deleting the script manually

cd ~ && rm .local/bin/huetui

Dependencies

These dependencies are needed for installing and running huetui.

  • python3
  • pip

The following dependencies are downloaded automatically when installing via pip. If you're cloning the repo, make sure to install them manually.

  • py_cui
  • colorthief
pip -U install py-cui colorthief

Setup process

huetui needs to be provided the bridge's IP and an authorized API user.

  1. Determine the bridge's IP, e.g. by opening your router's network tab and looking for a device with "Phillips-hue" as its hostname.

  2. Obtain an API user by following the official guide.

  3. Run huetui and input the information.

Using huetui

The status bar will show helpful information about navigation and keybindings.

  • Navigation is done using the arrow keys. You'll see a cursor move to the bottom right of the modules.
  • Selecting modules or items is done by pressing ENTER. The selected option will highlighted.
  • Light/group operations. Move to the desired light or group and:
    • toggle on/off: ENTER
    • decrease brightness: j
    • increase brightness: k
    • change color: c
  • To exit a module press ESC.
  • To quit the program simply press q while in the main overview (i.e. not inside a module).

Extra features

  • To set wallpaper colors press w while in the main overview.

Configuring huetui

The colors as well as other settings can be changed in huetui's config file ~/.config/huetui/config.py. Here are all the available settings:

# sample config. Edit to your liking.
import py_cui.colors as colors
from huetui.backend.utils import Config
c = Config()
c.ip = "192.168.178.75"
c.api_user = "O4qAaBl9LaXonrNlAu0Pzei3ianWAJuUzYuZpC2I"
c.tui_settings = {
	"unicode": True,
	"wallpaper": "~/Path/To/Wallpaper.jpg",
	"uicolors": {
		"main_ui": colors.WHITE_ON_BLACK,
		"selected": colors.CYAN_ON_BLACK,
		"border": colors.MAGENTA_ON_BLACK,
		"logo": colors.CYAN_ON_BLACK,
		"status_bar": colors.BLACK_ON_MAGENTA,
		"title_bar": colors.BLACK_ON_MAGENTA,
	},
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

huetui-2.1.tar.gz (15.3 kB view details)

Uploaded Source

File details

Details for the file huetui-2.1.tar.gz.

File metadata

  • Download URL: huetui-2.1.tar.gz
  • Upload date:
  • Size: 15.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.0

File hashes

Hashes for huetui-2.1.tar.gz
Algorithm Hash digest
SHA256 5297819cb72e552965f15c0958ad6863ff5fb73b321fd9eef5ec5cc5f6ea11fd
MD5 6d1bc870d2cc018c84291a172329995b
BLAKE2b-256 fdeb8613b90031e6381febc0cdb551520986f9b857ea9b593ba526ada5dfe137

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page