{"id":23980639,"url":"https://github.com/kusti8/hue-plus","last_synced_at":"2025-04-06T18:14:12.016Z","repository":{"id":62569764,"uuid":"66097192","full_name":"kusti8/hue-plus","owner":"kusti8","description":"A Windows and Linux driver in Python for the NZXT Hue+","archived":false,"fork":false,"pushed_at":"2020-03-15T18:26:39.000Z","size":438,"stargazers_count":231,"open_issues_count":32,"forks_count":18,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-03-30T17:11:48.972Z","etag":null,"topics":["driver","linux-driver","nzxt-hue","python-3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kusti8.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-08-19T16:41:31.000Z","updated_at":"2025-03-29T21:03:12.000Z","dependencies_parsed_at":"2022-11-03T18:27:22.784Z","dependency_job_id":null,"html_url":"https://github.com/kusti8/hue-plus","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kusti8%2Fhue-plus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kusti8%2Fhue-plus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kusti8%2Fhue-plus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kusti8%2Fhue-plus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kusti8","download_url":"https://codeload.github.com/kusti8/hue-plus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247526762,"owners_count":20953143,"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","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":["driver","linux-driver","nzxt-hue","python-3"],"created_at":"2025-01-07T10:17:49.908Z","updated_at":"2025-04-06T18:14:11.986Z","avatar_url":"https://github.com/kusti8.png","language":"Python","funding_links":["https://www.patreon.com/kusti8"],"categories":[],"sub_categories":[],"readme":"# hue-plus\n## Now with custom LED, audio mode on Windows, turning on and off based on time, and a custom mode builder and a developer library, plus bug fixes!\nSupport me on patreon: https://www.patreon.com/kusti8\n\n[![Build status](https://ci.appveyor.com/api/projects/status/5u1902hw1hqtlldb?svg=true)](https://ci.appveyor.com/project/kusti8/hue-plus)\n\nA **cross-platform** driver in Python for the NZXT Hue+. Supports **all functionality** except FPS, CPU, and GPU lighting.\n\n![Custom](https://github.com/kusti8/hue-plus/raw/master/custom.png)\n![Windows](https://github.com/kusti8/hue-plus/raw/master/windows.png)\n![Profile](https://github.com/kusti8/hue-plus/raw/master/profile.png)\n## Install\n### Windows\nThere is always an easy exe installer available here:\nhttps://github.com/kusti8/hue-plus/releases/latest\n### Linux\nYou must have `python3-dev` and `portaudio19-dev` installed!\nTo install it system wide, simply install using pip:\n```\nsudo pip3 install hue_plus\n```\nNow it will be available as `hue` or `hue_ui` for the GUI.\n\n## Quick Start\nEach mode accepts different arguments, so it's easiest to just read the usage.\nBasic usage is shown below.\n### Set a fixed color on all channels\n`sudo hue fixed FFFFFF` where FFFFFF is the color in hex.\n\n*or*\n\n`sudo hue -g 1 fixed FFFFFF` will bring up a color picker to choose a color\n### Set a specific channel\n`sudo hue -c 1 fixed FFFFFF` where 1 is channel one and 2 is channel two\n## Usage\nAll help and usage can be found by running ``hue -h``\n\n*The default hue.py now includes the color selector, simply set -g to however many colors you want*\n## Limitations\nNo FPS, CPU temp, or GPU temp, but other than that a perfect replica.\n\n## Developers\nHue_plus can easily be integrated into existing software. The entire codebase is separated into simple functions that separate all usage and can be directly called. The script provides a simple argument wrapper around them, but they are easily usable. **I highly suggest you read through the main ``hue.py`` file, specifically ``hue.main()`` to get acquianted with how to use it. Each function is slightly different.**\n\n### Quickstart\n\n```\nimport serial\nimport hue_plus\n\nser = serial.Serial(args.port, 256000)\nhue_plus.fixed(ser, 0, 0, 'FF0000') # First argument is ser, second is whether to bring up GUI (0=no), third is channel (0=both) and last is the color\n```\n\n### Common args\n\nArgument name | Description\n--- | ---\nser | The serial object, created as shown above\ngui | How many colors to select in the GUI, 0 is none\nchannel | The channel number to use, 1 or 2, 0 is both\ncolor(s) | The color(s) to use. If accepts more than 1 color, then in a list (`['FF0000', '00FF00']`)\nspeed | The speed, from 0 (Slowest) to 4 (Fastest). 2 is normal\nsize | The amount of LEDs to shine, from 0-3, where 0=3, 1=4, 2=5, 3=6\ndirection | Supports going backwards, where backwards=1 and forwards=0. **Not supported in marquee or cover_marquee**\nmoving | `true` or `false` if alternating looks like it is moving\nstate | For power mode, either `'on'` or `'off'`\nmode | For custom mode, either `'fixed'`, `'breathing'`, or `'wave'`\n\n## Notes\n\nHue-plus does not automatically run on startup. This will not be added as a feature, but you should do this manually if you want that. For windows, follow this: http://www.thewindowsclub.com/make-programs-run-on-startup-windows. For Mac/Linux, use cron.\n\n## Warning\n  I (the author) hold no liability for any broken or not working Hue+ by running this script. It is provided as is. It worked for me, but your milage may vary\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkusti8%2Fhue-plus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkusti8%2Fhue-plus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkusti8%2Fhue-plus/lists"}