{"id":13576173,"url":"https://github.com/sinedied/dmx-hue","last_synced_at":"2025-04-06T06:09:17.079Z","repository":{"id":44363204,"uuid":"93085039","full_name":"sinedied/dmx-hue","owner":"sinedied","description":":traffic_light: Art-Net node to control Philips Hue lights with DMX","archived":false,"fork":false,"pushed_at":"2023-11-05T14:09:30.000Z","size":694,"stargazers_count":215,"open_issues_count":23,"forks_count":25,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-03-30T03:06:34.529Z","etag":null,"topics":["art-net","bridge","cli","dmx","hacktoberfest","hue","light","node","philips","show"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/sinedied.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2017-06-01T17:58:04.000Z","updated_at":"2025-03-27T23:10:24.000Z","dependencies_parsed_at":"2024-01-16T20:24:55.388Z","dependency_job_id":"906c9a99-83eb-409f-ad2b-234a75cc2e1d","html_url":"https://github.com/sinedied/dmx-hue","commit_stats":{"total_commits":49,"total_committers":7,"mean_commits":7.0,"dds":"0.20408163265306123","last_synced_commit":"e1dd3ab9629f86cee68947b4cf18dee6341d1102"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinedied%2Fdmx-hue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinedied%2Fdmx-hue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinedied%2Fdmx-hue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinedied%2Fdmx-hue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sinedied","download_url":"https://codeload.github.com/sinedied/dmx-hue/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247441052,"owners_count":20939239,"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":["art-net","bridge","cli","dmx","hacktoberfest","hue","light","node","philips","show"],"created_at":"2024-08-01T15:01:07.654Z","updated_at":"2025-04-06T06:09:17.061Z","avatar_url":"https://github.com/sinedied.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# :traffic_light: dmx-hue\n\n[![NPM version](https://img.shields.io/npm/v/dmx-hue.svg)](https://www.npmjs.com/package/dmx-hue)\n[![Build Status](https://github.com/sinedied/dmx-hue/workflows/build/badge.svg)](https://github.com/sinedied/dmx-hue/actions)\n![Node version](https://img.shields.io/node/v/dmx-hue.svg)\n[![XO code style](https://img.shields.io/badge/code_style-XO-5ed9c7.svg)](https://github.com/sindresorhus/xo)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\n![dmx-hue-logo](https://cloud.githubusercontent.com/assets/593151/26761623/710db1ba-4933-11e7-9a08-471e3f9fb9e5.png)\n\n\u003e Art-Net node to control Philips Hue lights with DMX\n\n## Installation\n\nInstall [NodeJS](https://nodejs.org), then open a command prompt:\n\n```bash\nnpm install -g dmx-hue\n```\n\n## Usage\n\n```\nUsage: dmx-hue [setup] [options]\n\nCreate an ArtNet DMX\u003c\u003eHue bridge.\n\nOptions:\n  -h, --host       Host address to listen on              [default: '0.0.0.0']\n  -a, --address    Set DMX address (range 1-511)          [default: 1]\n  -u, --universe   Art-Net universe                       [default: 0]\n  -t, --transition Set transition time in ms              [default: 100]\n                   Can also be set to 'channel' to enable a dedicated DMX\n                   channel on which 1 step equals 100ms.\n  -c, --colorloop  Enable colorloop feature\n                   When enabled, setting all RGB channels of a light to 1 will\n                   enable colorloop mode.\n  -w, --white      Enable 2 additional channels for white balance control\n  -n, --no-limit   Disable safety rate limiting\n                   Warning: when this option is enabled, make sure to not send\n                   more than \u003cnumber_of_lights\u003e/10 updates per second, or you\n                   might overload your Hue bridge.\n\nNote: options overrides settings saved during setup.\n\nCommands:\n  setup            Configure hue bridge and DMX options\n    -l, --list     List bridges on the network\n    -i, --ip       Set bridge IP (use first bridge if not specified)\n    --force        Force bridge setup if already configured\n```\n\n### Setup\n\nBefore being able to control Hue lights on your network, your first have to setup your Hue bridge with the app.\nRun `dmx-hue setup`, press the **link button** on your Hue bridge within 30s, then run `dmx-hue setup` again.\n\nAfter that, follow instructions to configure the default settings.\nYou can change these settings later at anytime by running `dmx-hue setup` again.\n\nOnce your Hue bridge is correctly setup, just run `dmx-hue` to start the Art-Net node, then go crazy with your\nfavorite DMX controller! :bulb:\n\nIf you're looking for a nice cross-platform \u0026 open-source DMX software controller, you should take a look at\n[QLC+](http://www.qlcplus.org/).\n\n#### Setting lights order\n\nIf you need to define your lights order manually for the DMX mapping, edit your configuration file with a text editor\n(the file path is displayed at the end of `dmx-hue setup`) and add a new `lightsOrder` entry at the end like this:\n```js\n{\n  ...\n  \"lightsOrder\": [1, 2, 3]  // Hue lights ID\n}\n```\n\nThe Hue lights IDs are displayed when `dmx-hue` is started.\n\n### Hue lights specific features\n\n#### Colorloop\n\nWhen colorloop option is enabled, your can enable Hue light automatic colorloop mode by setting the R/G/B channels of\na given light to the value `1`.\n\n#### Transition time\n\nHue light can automatically perform transitions from one state to another in a specified time. This is especially\nuseful since there is a somewhat low update rate limitation on Hue lights (see next section for more details). If you\nwant to go creative and be able to adjust transition times dynamically, you can dedicate a DMX channel for it.\n\n#### White control\n\nWhen option `--white` is enabled, channels 4-5 for each fixture are reserved for white control. When R/G/B channels are at value `0`, channel 4 will control temperature, and channel 5 will control brightness. Brightness is currently overriden by R/G/B channels if they are not at value `0`.\n\nUsing this option also enables control of Philips White Ambience Lights when R/G/B channels are at value `0`.\n\n## Philips Hue response times vs DMX\n\nWith the Philips Hue API it’s only possible to update the state of bulbs 10 times per second, 1 bulb at a time.\nCompared to a single DMX universe, which controls all 512 individual parameters up to 44 times per second, there’s\nsome major differences in how quickly we can update your lights using this software bridge.\n\nThis is especially noticeable when using automation sequences, if you try to update Hue lights quicker than 0.1s times\nthe number of lights in your projects, some updates may be skipped. This is unfortunately a limitation with the Hue\nlights API and I cannot do anything about that.\n\n### Safety rate limiting\n\nBy default, a safety rate limit is enforced so there is always a 0,1s interval between Hue API calls. You can disable\nthis limit using the `--no-limit` option, but then you have to make sure to not make more than *number_of_lights / 10*\nDMX value changes per second, or your Hue bridge might get overloaded and may crash.\n\n## Development\n\nTo run the project without installing, clone the repository and run the following commands from the folder:\n\n```bash\nnpm install\nnpm start\n```\n\nChanges you make to the source will be immediately available when you run in this way.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsinedied%2Fdmx-hue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsinedied%2Fdmx-hue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsinedied%2Fdmx-hue/lists"}