Skip to content

Linux / KDE Plasma desktop widget to control Philips Hue lights. Controls lights, groups and customizable actions.

License

Notifications You must be signed in to change notification settings

Fuchs/hoppla-sa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Philips Hue light control plasmoid for KDE (Stand alone version)

This plasmoid enables you to control Philips Hue light bulbs. The idea of the stand alone version is that it requires no compiled backend and thus can be deployed as is, e.g. via Get Hot New Stuff.

It allows you to

  • Control your lights
    • Turn lights on / off
    • Set the brightness
    • Set the colour or white temperature
  • Control your groups
    • Turn whole groups on / off
    • Set the brightness
    • Set the colour or white temperature
    • Control single lights belonging to the group
  • Use quick actions for your favourite or most used commands
    • Create, modify and use actions, such as turning all lights off or dimming all lights of a room
  • Manage your stuff
    • Search new lights, modify and delete existing ones
    • Create new Groups and Rooms, modify and delete existing ones
    • Create new schedules, modify and delete existing ones
  • Set an alternative connection, including http basic auth
    • Control your lights from outside your home network

License

This software is distributed under the LGPL 2.1 License. See COPYING for details.

Requirements

  • Starting with Version 4.*, at least Plasma 5.21 is needed. Please use older versions for prior plasma releases.
  • Plasma 5 & Qt 5.4+
  • Qt5 Graphical Effects
  • Extra CMake Modules (only for building)

Compile and install

git clone https://github.com/Fuchs/hoppla-sa.git
cd hoppla-sa

Global installation

mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/usr 
make
sudo make install

Local installation (per user)

plasmapkg2 -i package

to install the plasmoid

and

plasmapkg2 -r package

to remove it again.

Control lights from outside your network

You have to set up a public reachable proxy, I recommend apache httpd or nginx / lighttpd over a secured (TLS) connection with basic auth. A possible apache httpd configuration would be

<IfModule mod_ssl.c>
        <VirtualHost _default_:443>
                ServerName hue.mydynamicdnsdomain.org
                ProxyRequests On
                <Proxy *>
                   Order deny,allow
                   Allow from localhost
                </Proxy>

                SSLEngine on

                SSLCertificateFile /etc/ssl/certs/apache.pem
                SSLCertificateKeyFile /etc/ssl/private/keys/apache.key

                <Location "/">
                        AuthType Basic
                        AuthName "Restricted Content"
                        AuthUserFile /etc/httpd/some/place/.htpasswd-hue
                        Require valid-user
                </Location>
                # Set IP to your internal hue bridge IP
                ProxyPass / http://192.168.1.1/
                ProxyPassReverse / http://192.168.1.1/
        </VirtualHost>
</IfModule>

where mydyanmicdnsdomain.org is a domain pointing at your public address from your home network. Please read your httpd documentation on how to set it up, especially on how to add basic authentication. Note that due to the higher delay between requests and replies to the bridge, this can lead to the plasmoid being sometimes not up to date about the current state until the next background update occurs. Updates can always be forced with the refresh button.

About

Linux / KDE Plasma desktop widget to control Philips Hue lights. Controls lights, groups and customizable actions.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages