Metadata-Version: 2.1
Name: huetui
Version: 1.0
Summary: A TUI for Philips Hue
Home-page: https://github.com/channel-42/hue-tui
Author: channel-42
Author-email: info@devls.de
License: MIT
Description: # hue-tui [![](https://img.shields.io/badge/version-0.3-green.svg)](https://pypi.org/project/huetui/) [![Downloads](https://pepy.tech/badge/huetui)](https://pepy.tech/project/huetui) ![](https://img.shields.io/badge/license-MIT-orange.svg) 
        *a tui for Philips Hue*
        
        ![Screenshot](https://github.com/channel-42/hue-tui/blob/feature_branch/.resources/screen.jpg "A pretty screenshot")
        
        ## About 
        
        **hue-tui** is a **t**erminal **u**ser **i**nterface that allows for easy control of your Philips Hue lights. It uses my Hue-API library [hue-snek](https://github.com/channel-42/hue-snek) to communicate with the bridge.
        
        ## Installation
        
        Install hue-tui with:   
        
        `pip install huetui`
        
        This should fetch all the necesary dependencies. Nevertheless, make sure that all dependencies are installed.
        
        Launch hui-tui by typing `huetui` into your terminal.   
        
        >Should you get the error `command not found: huetui`, restart your terminal. Should the error persist, check that `$HOME/.local/bin` is in your `$PATH`. This can be done by adding `export PATH="$HOME/.local/bin:$PATH"` to your .bashrc/.zshrc.
        
        ### Dependencies
        
        - python3
        - pip
        
        The following dependencies are downloaded automatically when installing via pip. If you're cloning the repo, make sure to manually install them.
        
        - hue-snek
        - py_cui
        - Pillow
        - colormath
        - colorthief
        ```bash
        pip -U install hue-snek-channel42 py-cui Pillow colormath colorthief
        ```
        
        ## Setup process
        
        To be able to use hue-tui, you need to have your bridge's IP address and a API username. The IP address can be found by e.g. going into your routers network tab and looking for a device with hostname "Philips-hue". To get an API username, check out [this](https://developers.meethue.com/develop/get-started-2/) short guide on the official Hue-Developers site.
        
        Once you have the IP address and unsername, you can start hue-tui by typin `huetui` into a terminal. This should open the first-time-setup, where you can input your IP and username. 
        
        <img align="left" width=47% padding="4" border="20" src="https://github.com/channel-42/hue-tui/blob/feature_branch/.resources/setup1.png">    
        
        <img align="right" width=47% padding="4" border="20" src="https://github.com/channel-42/hue-tui/blob/feature_branch/.resources/setup2.png">    
        
        <br><br><br> 
               
        > Tip: pasting with e.g. CTRL-SHIFT-V works (check what the pasting binding is in your specific terminal emulator) 
        
        To input your IP, navigate the cursor to the IP textfield (it should be there by default) and press ENTER. Then type or paste your bridge's IP address **without http://** at the begining. 
        
        > E.g.: 192.168.178.20
        
        Exit out of the textfield by pressing ESC and move your cursor to the username field. Enter your username just like before and then move your cursor to the big "make login" button. Press ENTER and a popup showing your IP and username should appear. Press ENTER to dismiss the popup and restart huetui by exiting out of the programm (press q).    
        
        After re-opening hue-tui you should see all your lights, groups, scenes, etc. like in the screenshot at the top.
        
        ## Using hue-tui
        
        ![](https://github.com/channel-42/hue-tui/blob/feature_branch/.resources/huetui.gif)
        
        Using hue-tui is easy:   
        
        To **navigate** the different modules use your arrow keys. You'll see your cursor move to the bottom right of the modules, which shows you which module is selected.\
        **Enter a module** by pressing ENTER. The selected option will be in bold.\
        Once inside a module, Use your arrow keys to **navigate** and press enter to **execute an action** (e.g. toggle a light).\
        To **change individual light or group brightness** move to the desired light or group and press j (increase) or k (decrease).\
        To **exit a module** press ESC.\
        To **quit the programm** simply press q while in the main overview (i.e. not inside a module).
        
        ### Misc. feature
        To **start disco mode** navigate and enter the lights menu and press d.
        To **set xrdb colors** navigate to the button and press enter.
        To **set wallpaper colors** navigate to the button and press enter.
        
        ## Notes
        
        hue-tui was made using [py_cui](https://github.com/jwlodek/py_cui). Check the project out!
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Description-Content-Type: text/markdown
