{"id":16662572,"url":"https://github.com/temporal/hju","last_synced_at":"2026-03-18T21:18:18.852Z","repository":{"id":136165728,"uuid":"76314111","full_name":"TeMPOraL/hju","owner":"TeMPOraL","description":"Simple command line (CLI) controller for Hue lights, written in Common Lisp.","archived":false,"fork":false,"pushed_at":"2017-08-30T07:02:22.000Z","size":32,"stargazers_count":1,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-12T21:49:18.204Z","etag":null,"topics":["cli","command-line","common-lisp","hue-bridge","hue-lights","roswell","script"],"latest_commit_sha":null,"homepage":"","language":"Common Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TeMPOraL.png","metadata":{"files":{"readme":"README.org","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-12-13T02:17:38.000Z","updated_at":"2023-02-15T22:48:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"88eb52cd-5343-4ce8-ab68-8cd15c26582c","html_url":"https://github.com/TeMPOraL/hju","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TeMPOraL/hju","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeMPOraL%2Fhju","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeMPOraL%2Fhju/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeMPOraL%2Fhju/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeMPOraL%2Fhju/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TeMPOraL","download_url":"https://codeload.github.com/TeMPOraL/hju/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeMPOraL%2Fhju/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266403240,"owners_count":23923404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-21T11:47:31.412Z","response_time":64,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","command-line","common-lisp","hue-bridge","hue-lights","roswell","script"],"created_at":"2024-10-12T10:38:18.633Z","updated_at":"2026-02-04T09:35:25.783Z","avatar_url":"https://github.com/TeMPOraL.png","language":"Common Lisp","funding_links":[],"categories":[],"sub_categories":[],"readme":"#+title: HJU - A simple command line Hue lights controller in Common Lisp.\n#+startup: hidestars\n\nHju lets you control your Hue lights straight from the command line!\n\nSupports all color gamut conversions (for RGB mode) specified by Hue documentation to date (as of 2016-12).\n\n* Installation\n\n  Requirements:\n  - [[https://github.com/roswell/roswell][roswell]]\n  - [[https://www.quicklisp.org/beta/][quicklisp]]\n\n  You can run the script directly or, better, build an executable first with roswell.\n\n  #+BEGIN_SRC sh\n  ros build hju.ros\n  #+END_SRC\n\n* Usage\n\n  Ensure you have an user registered on Hue bridge for this application (in the future, this process\n  will be done from this tool, but now it has to be done manually). Refer to [[https://www.developers.meethue.com/documentation/getting-started][Hue API documentation]]\n  for this process.\n\n#+BEGIN_SRC sh\n$ ./hju --help\nhju - a simple command line controller for Hue lights\nVersion: 0.5\n\nUsage:\n        hju [options...] \u003ccommand\u003e [args]\n\nUse \"hju -h\" or \"hju --help\" for complete list of options.\n\nOptions:\n        -h, --help                                      Display this text.\n        -v, --verbose                                   Make output verbose.\n        -b BRIDGE, --bridge=BRIDGE                      Use different bridge URL than the default.\n        -u USER, --user=USER                            Use different user ID than the default.\n        -t TRANSITION, --transition=TRANSITION          Use specified transition time (in tenths of a second).\n\n    TRANSITION is given in seconds, can be fractional. Default value: 0.4.\n    Terminate options with -- if -h or -v is used last.\n\nDefaults are taken from the config file .hju in your home directory.\nThe format of that file is:\n    (setf *bridge-url* \"bridge URL\" *user-id* \"USER ID\")\n\nCommands:\n        status                          Display status of Hue bridge and all lights.\n        list                            Just list available lights and their status.\n        on LIGHTS                       Turn on LIGHTS.\n        off LIGHTS                      Turn off LIGHTS.\n        toggle LIGHTS                   Toggle LIGHTS.\n        reset LIGHTS                    Reset LIGHTS to the values I (the author) like.\n        blink LIGHTS                    Blink LIGHTS.\n        set LIGHTS rgb R G B            Set color of LIGHTS to rgb(R, G, B) (each component in [0.0 ... 1.0]).\n        set LIGHTS rgb #RRGGBB          Set color of LIGHTS to #RRGGBB (hex).\n        set LIGHTS rgb #RGB             Set color of LIGHTS to #RRGGBB (hex).\n        set LIGHTS hue HUE              Set hue of LIGHTS to HUE [0...65535].\n        set LIGHTS sat SAT              Set saturation of LIGHTS to SAT [0...254].\n        set LIGHTS bri BRI              Set brightness of LIGHTS to BRI [1...254].\n        set LIGHTS ct CT                Set color temperature of LIGHTS to CT in Mired.\n        set LIGHTS ctk CTK              Set color temperature of LIGHTS to CTK in Kelvins.\n        set LIGHTS xy X Y               Set color of LIGHTS to coordinates (X, Y) in CIE color space.\n\n    LIGHTS can be given as a comma-separated list of numbers or prefixes of their names.\n    LIGHTS can also be given as \"all\", which will make the command affect all lights.\n\nExamples:\n        hju on living,bathroom\n        hju off bat\n        hju set 1,3 rgb #11FF11\n#+END_SRC\n\n* Configuration\n  Hju searches for its configuration file in following places:\n  - =$HOME/.hju=\n  - =$HOME/.config/hju/.hju=\n\n  If a configuration file is present there, it will be loaded, making it no longer required to pass\n  bridge URL and user ID as command line arguments.\n\n  The template for config file is as follows:\n\n  #+BEGIN_SRC lisp\n    (setf *bridge-url* \"IP address of your Hue bridge\"\n          *user-id* \"your user ID\")\n  #+END_SRC\n\n* To be done\n  See [[https://github.com/TeMPOraL/hju/issues][issues]] for a list of planned features and known problems.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftemporal%2Fhju","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftemporal%2Fhju","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftemporal%2Fhju/lists"}