[{"_1":2,"_166":-5,"_167":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_142":143},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_85":-5,"_86":87,"_135":-5,"_136":11,"_137":17,"_138":11,"_139":-5,"_140":141},"canonicalUrl","https://hub.docker.com/r/digitalhigh/glimmr/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","digitalhigh","reponame","glimmr","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":65,"_66":67,"_68":11,"_69":29,"_70":71,"_76":11,"_77":78,"_82":29,"_83":84},"categories",[],"content_types",[40],"image","date_registered","2020-05-04T18:10:49.919822Z","description","","is_private","last_updated","2024-02-22T16:00:14.611653Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",7650,"repository_type","star_count",2,"status",1,"status_description","active","source","collaborator_count",0,"full_description","# [d8ahazard/glimmr](https://github.com/d8ahazard/glimmr)\n\n## What the heck is this??\nGlimmr is a FOSS ambient home lighting solution. Hook it up to a HDMI signal, use a webcam, or use the screen capture function; and drive a wide range of lighting devices in sync with the input signal. It's similar to Hyperion, Govee, or the Hue Sync box, only with a much broader support for devices.\n\nThe project is written in dotnet core, which means it can run on most any modern arm, intel, or AMD processor. Presently, it has been tested to work with Debian and Ubuntu linux, as well as raspbian and Windows 10 and 11. It is specifically designed to run on a raspberry Pi 4B, however, it has also been shown to run fine on a 3B, and could potentailly also work on a zero...although it has not been tested.\n\nSupported devices include DreamScreen, Hue, Lifx, Nanoleaf, WLED, Adalight (Arduino), Yeelight, and WS2812B/SK6822 strips connected to the GPIO of a raspberry pi. Additionally, a *vast* array of desktop RGB devices are supported via OpenRGB integration. And, if there's not a device supported and it has an API, I'm more than willing to try adding support for it.\n\nIn addition to all the supported devices, each device has a custom set of options which can be used to ensure perfect alignement with the screen content, regardless of room placement. Mirroring, scaling, and brightness are all configurable for every device.\n\nAdditional features include automatic updates, black bar detection, auto-disable and enable; audio, audio/video, and ambient modes with user-defineable parameters via a JSON loading system.\n\nThe app is controllable via an inbuilt web interface, Android application (available on the play store), and a fully documented API (via swagger). Python api wrapper WIP.\n\n

\n\n## Installation\n\n### Windows\n\n#### Installer\nDownload the latest .exe installer from [releases](https://github.com/d8ahazard/glimmr/releases/latest), and run it.\n\n\n#### Scripted\nOpen a Powershell window, execute the following command:\n\n```\niex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/d8ahazard/glimmr/dev/script/setup_win.ps1'))\n\n```\n\nOR, to clone from the master branch:\n```\niex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/d8ahazard/glimmr/master/script/setup_win.ps1'))\n```\nOnce the script is done running, you should now have a \"GlimmrTray\" application in your start menu.\n\nClick this to launch Glimmr, minimize the console window to have it stored in the tray.\n\nNote: Glimmr/GlimmrTray *MUST* be run as administrator in order for screen capture to work.\n\n### Raspberry Pi\n\n#### Installer\nDownload the latest linux-arm deb package installer from [releases](https://github.com/d8ahazard/glimmr/releases/latest), and \ninstalling it by running ```apt-get install FILENAME.deb```.\n\n#### Script\n\nExecute the following command:\n```\nsudo su\nwget -qO- https://raw.githubusercontent.com/d8ahazard/glimmr/master/script/setup_linux.sh | bash\n```\n\n*Alternatively*, you can flash a custom image directly to your pi from here:\n\nFull Raspi OS image can be found here: \n\nX64: [https://mega.nz/file/C34GEAqZ#RpckErhTPhn6qz1cVDNDmr4QP9wfYemEaAOLvRRBz4E](https://mega.nz/file/RgsCSTSK#D-dH-XGBLuh3DOEZ98YGkOQk6ZkpId8PONLT7KDyNjM)\n\n\nYou will need to use \"BalenaEtcher\", a free software for flashing the image.\n\nhttps://www.balena.io/etcher/\n\nOnce Balena is installed and loaded, select the image file you downloaded from above, and make sure your\nmicro SD card is connected to your computer. Select the SD card, and click \"Flash\" to begin.\n\nOnce flashing is done - simply insert the SD card into your pi and boot it up.\n\nIf using the custom RasPi image, it is configured to use the Comitup service to create an access point which\nyou can connect to to configure your Glimmr's wifi settings. Once the pi is booted, use a phone or laptop and\nconnect to the access point \"Comitup-XXX\" or \"Glimmr-XXX\" (WIP). Once connected, you should be prompted to select\na local wifi network and enter a password. Make a note of the name of the access point.\n\nOnce wifi is configured, reconnect to your home wifi, and enter http://glimmr-xxx into a browser, where the -xxx is\nthe same as the access point.\n\nNote: Glimmr is installed as a service, and can be stopped/started by running \"sudo service glimmr start\"\nor \"sudo service glimmr stop\" respectively.\n\n\n\n### Linux\n\n#### Installer\nDownload the latest linux-x64 deb package installer from [releases](https://github.com/d8ahazard/glimmr/releases/latest), and\ninstalling it by running ```apt-get install FILENAME.deb```.\n\n#### Script\nExecute the following command:\n```\nsudo su\nwget -qO- https://raw.githubusercontent.com/d8ahazard/glimmr/master/script/setup_linux.sh | bash\n```\n\nNote: Glimmr is installed as a service, and can be stopped/started by running \"sudo service glimmr start\"\nor \"sudo service glimmr stop\" respectively.\n\n\n### OSX\n\n#### Installer:\nDownload the latest macos-installer package installer from [releases](https://github.com/d8ahazard/glimmr/releases/latest), and\ninstalling it by double-clicking it.\n\n\n#### Scripted Install\n\nOpen a terminal, execute the following commands:\n```\nsudo su\ncurl https://raw.githubusercontent.com/d8ahazard/glimmr/master/script/setup_osx.sh | sh\n```\n\n\n### docker\nUse the following command. You don't need to specify the ASPNETCORE_URLS value, unless you wish to change the default\nport that the web UI listens on. If so, modify the port number. e.g.: 'http://+:5699' to 'http://+:80'\n\n```\ndocker create \\\n --name=glimmr \\\n -v :/etc/glimmr \\\n -p 1900:1900/udp \\\n -p 2100:2100/udp \\\n -p 5353:5353/udp \\ \n -p 8888:8888/udp \\ \n -p 56700:56700/udp \\ \n -p 60222:60222/udp \\ \n -p 80:5699 \\\n -p 443:5670 \\\n --network=\"bridge\" \\\n --restart unless-stopped \\\n digitalhigh/glimmr\n```\n\n\n### docker-compose\n\nCompatible with docker-compose v2 schemas.\n\n```\n---\nversion: \"2\"\nservices:\n glimmr:\n image: d8ahazard/glimmr\n container_name: glimmr\n restart: unless-stopped\n network: bridge\n\tvolumes:\n \t- :/etc/glimmr\n ports:\n \t- 1900:1900/udp\n \t- 2100:2100/udp\n \t- 5353:5353/udp\n \t- 8888:8888/udp\n \t- 56700:56700/udp\n \t- 60222:60222/udp\n \t- 5699:5699\n```\n\n#### Parameters\n\nContainer images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate `:` respectively. For example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container.\n\n| Parameter | Function |\n| :----: | --- |\n| `-v /etc/glimmr` | Change to the location where to keep glimmr ini |\n| `-p 1900:1900\\udp` | Hue Discovery port |\n| `-p 2100:2100\\udp` | Hue Broadcast port |\n| `-p 5353:5353\\udp` | MDNS Discovery port |\n| `-p 8888:8888\\udp` | DS Emulation port |\n| `-p 56700:56700\\udp` | LIFX Discovery port |\n| `-p 60222:5353\\udp` | Nanoleaf Discovery port |\n| `-p 5699:5699` | Web UI port |\n| `-network=\"bridge\"` | Because Glimmr requires MDNS for discovery, it is recommended to use a bridge when running this container, otherwise a binding error on port 5353 is likely to occur. |\n\n\n\n\n\n \n## Application Usage\n\nOnce installed, access the Web UI at `` from a web browser.\n\nAlternatively, you can use the [Glimmr Mobile app](https://github.com/d8ahazard/GlimmrMobile/releases/tag/1.0) (Android, UWP).\n\n### Discover Devices\nDiscovery should be auto-triggered when the application runs for the first time.\n\nIf devices are missing or you want to re-scan, the refresh button is in the lower-right corner\nof the web UI.\n\n### Configure Glimmr Settings\nTo configure system, capture, and audio preferences, click the gear icon in the top-right corner\nof the screen.\n\n### Configure OpenRGB\n[OpenRGB](https://gitlab.com/CalcProgrammer1/OpenRGB) is a free, cross-platform solution for controlling desktop-connected lighting peripherals.\n\nOnce installed, ensure OpenRGB is running and the SDK server is started. Refer to the [OpenRGB FAQ](https://gitlab.com/CalcProgrammer1/OpenRGB/-/wikis/Frequently-Asked-Questions)\nfor information regarding setting it up as a service.\n\nUnder Settings -> General -> OpenRGB, enter the IP Address of the computer on which OpenRGB is running.\n\nNow, trigger a device refresh, and any devices in OpenRGB should be added to the Glimmr UI.\n\n### Configure Adalight Devices\nNOTE: It is *highly* recommended to use my [custom Adalight Sketch](https://github.com/d8ahazard/adalight-FastLED-Plus), as it provides\nadditional features and controls that help better integrate with Glimmr, including auto-detection\nof brightness and LED count, adjusting brightness during runtime, and gamma correction.\n\nIf you're not using my sketch, you will need to specify your strip's LED count.\n\nYou can also specify an offset (number of pixels to skip before displaying LED colors), baud rate,\nand whether or not to reverse the order of the colors sent to your device.\n\n### Configure your Lifx Bulbs\nSelect your discovered bulb in the Web UI. Click the desired sector to map your bulb to that sector. Repeat for all bulbs.\n\n### Configure your Lifx Beams\nSelect your discovered beam in the Web UI. A layout will be auto-generated based on the number of \"pixels\" your beam has.\n\nHowever, Beams cannot specify the order segments are in (where corners are located), so you will need to manually\norder these in the Web UI. Drag-and-drop to re-order. Numbers are arbitrary, and only there to help understand\nwhat you're looking at.\n\nFor beams, the internal LEDs are spaced so that 1 beam pixel occurs roughly ever 2 pixels in a 60 LED/M strip.\n\nEach segment has several options:\nOffset: Where to start from around the frame.\nRepeat: Should the color at the offset pixel be repeated for the entire segment.\nMirror: Reverse the direction of colors sent to the segment.\n\n\n### Configure Your Nanoleaf Panels\nSelect your Nano device in the web UI. Click the \"Click here to link...\" button. Press and hold the power button on your nanoleaf panel until the Web UI shows \"linked\".\n\nOnce linked, your panel layout will be shown in the Web UI (I suck, so you may need to reload the page for now). Drag it around to set the position in relation to the screen, and your lights will be auto-mapped to the proper sectors.\n\nClick each panel in the UI to open the sector selection UI. Click a sector to map that panel to it.\n\n### Configure Your Hue Bridge\nSelect your Hue Bridge in the web UI. Click the \"Click here to link...\" button. Within 30 seconds, press the link button on your Hue Bridge. The Web UI should update to show that the bridge has been linked - if not, reload the page.\n\n#### Create A Hue Entertainment Group!! (NEW)\nGo into your hue app. In the side menu, select \"Entertainment areas\".\n\nCreate a new entertainment area and configure it with your lights as they are in the room.\n\n#### Configure Hue Light Mappings\nBack in the glimmr web UI, reload the page, then select your hue bridge, and select the newly created entertainment group from the drop-down.\nFor each light you wish to map, select the sector in the dropdown that corresponds to the sector you wish to map to.\n\nIf no entertainment groups are showing and you're linked already, use the refresh button to re-scan entertainment\ngroups and light settings.\n\n#### Configure WLED\nNOTE: There is a \"bug\" with the WLED software that causes discovery to fail under some\ncircumstances. If Glimmr does not find your WLED devices, reboot them, and then under\nWLED settings -> \"Security and Updates\", scroll down and UNCHECK \"Enable ArduinoOTA\".\nThis will fix discovery for your WLED devices.\n\nWLED devices have several different options and display modes.\n\n\"Normal\" mode matches up the WLED strip to the perimeter of the screen using the LED counts\nspecified in the Glimmr capture settings. You can specify an offset, which will skip that many\nLEDs from the \"total\" around the screen. You can also specify to reverse the direction of the colors\nif the strip is positioned opposite of the screen.\n\n\"Loop (Play Bar)\" mode is similar to \"Normal\", but assumes that the LEDs are in some sort of U-shape,\nwhere there are two pixels for a strip that correspond to a segment of the screen.\n\n\"Sectored\" currently does nothing, as I haven't implemented it yet.\n\n\"Single Color\" assumes that you have a small number of LEDs in a close area, and you want all of\nthose LEDs to display the same color. The color being displayed will be whatever the strip's offset\nis set to.\n\nClick the \"Save settings\" button to submit your configuration.\n\n\n## Integrations\n\n### Swagger API\n\nGlimmr has a fully REST-ful API that supports control and enumeration of nearly every method and\nrelevant data structure in the application. All methods are documented on [Swagger Hub](https://app.swaggerhub.com/apis/d8ahazard/glimmr/).\nAdditionally, you can access the API documentation locally by going to http:///swagger/index.html.\n\nThe local API reference can be used to view and set data in real-time, as well as see in-depth descriptions \nof what each device and system setting do. You can also examine the data structures of Ambient and Audio Scenes.\n\n\n### Python Library\n\nWant to create a python project to control Glimmr? There's a package for that.\nPresently, this is not a full implementation of the Swagger API, but only adds the features\nrequired for implementation with Home Assistant. If a feature is not implemented, \nfeel free to submit a feature request to the below github repo.\n\nhttps://pypi.org/project/glimmr/\nhttps://github.com/d8ahazard/glimmr-python\n\n\n## Home Assistant Integration\n\nRunning a Home Assistant instance? Well, you're in luck. I've created a platinum-level\nintegration for Home Assistant that takes full advantage of the features provided by Glimmr.\n\nThe integration includes automatic discovery via MDNS/Zeroconfig, automatic push updates via websocket,\nand the ability to change device modes and adjust ambient color and scenes.\n\nAlso, the integration is supported by HACS - you can just copy the below URL and add it as a custom \nrepository, then install via the settings -> integrations page.\n\nhttps://github.com/d8ahazard/glimmr_ha\n\n\n## Creating Ambient Scenes\n\nI've created a custom utility for creating ambient scenes. You can find it here:\nhttps://github.com/d8ahazard/glimmr/releases/download/1.2.4/Image2Scene.exe\n\nTo use it, simply run the executable and select the image you wish to use as the ambient scene.\n\nAlternatively, you can drag and drop an image onto the application to select it.\n\nOnce a source image is provided you will be prompted to select a resolution, enter a \ntheme name, and configure other scene parameters. \n\nThe application will then generate a theme JSON file, which can be \nuploaded to Glimmr using the \"Upload Theme\" feature in app settings.\n\n## PROFIT\n\nFrom here, you can use the app normally to control your devices. Open up the Dreamscreen mobile app, add new devices if your Glimmr device is not deteced, and then place it in a group with a DS device (If using DS sync mode).\n\nTo stop synchronization, select the device in the DS app or Glimmr Web UI and set the mode to \"Off\".\n\nTo start synchronization, select the GROUP in the DS app, (or device in Glimmr Web UI) and set the mode to \"Video\". If the device is not in a group, you can control it directly.\n\n\n## UPDATING\nClick the update button under settings-> general.\nFor docker...just recreate the container. :)\n\n## NOTES\n\nAmbient Scenes and music mode *are* now implemented. I still have some work to do with Mic detection, but the functionality exists.\nNot all settings for DS devices in the Web UI are implemented...but the video and advanced settings should now be working properly.\n\nLogs are stored to the following location(s):\nWindows - %programdata%\\Glimmr\\log\\\nLinux - /var/log/Glimmr/\n\nGlimmr storage DB and scenes are stored in the following location(s):\nWindows - %programdata%\\Glimmr\\\nLinux - /etc/Glimmr/\n\nThe application is installed to the following location(s):\nWindows - C:\\Program Files\\Glimmr\\\nLinux - /usr/share/Glimmr/\nOSX - /Applications/Glimmr/\n\n## Related links:\n[Home Assistant Integration](https://github.com/d8ahazard/Glimmr_ha)\n\n[Python Library](https://github.com/d8ahazard/Glimmr-python)\n\n[Raspberry pi image generator](https://github.com/d8ahazard/Glimmr-image-gen)\n\n[Glimmr mobile app (Play Store)](https://play.google.com/store/apps/details?id=com.digitalhigh.GlimmrControl)\n\n[FloW LED Android Screen Capture App (Play Store)](https://play.google.com/store/apps/details?id=com.digitalhigh.glimmrextender&hl=en_US&gl=US)\n\n[Glimmr mobile app (source)](https://github.com/d8ahazard/GlimmrControl)\n\n[DreamScreen Documents](https://github.com/d8ahazard/DreamscreenDocs/)\n\n\n## THANKS!\nMad props to Greg F. for all the support, and Dr. Ackula for all the help and testing.\n\nMuch love to all of my other supporters/fans/stalkers.\n\n## Buy me a beer\n\nIf you like my work and want to say thanks, I humbly accept donations via paypal at donate.to.digitalhigh@gmail.com\n","has_starred","hub_user","immutable_tags_settings",{"_72":11,"_73":74},"enabled","rules",[75],".*","is_automated","permissions",{"_79":17,"_80":11,"_81":11},"read","write","admin","user","storage_size",23434524560,"orgData","recentTags",[88,125],{"_89":40,"_90":91,"_92":93,"_94":95,"_96":97,"_98":99,"_46":114,"_115":91,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",1361402,"digest","sha256:eb1a2b6d70057242dd9fa1a9234fc22a04a11294339abd2917a0959990861d20","full_size",111930263,"id",98764744,"images",[100],{"_101":102,"_92":93,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":95,"_59":62,"_113":-5},"architecture","amd64","features","last_pulled","2026-09-20T07:00:23.383764906Z","last_pushed","2024-02-21T15:24:16Z","os","linux","os_features","os_version","size","variant","2024-02-22T16:00:13.656294Z","last_updater","last_updater_username","media_type","latest","repository",8971326,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_89":40,"_90":91,"_94":126,"_96":127,"_98":128,"_46":133,"_115":91,"_116":29,"_117":52,"_53":134,"_119":120,"_121":131,"_122":133,"_123":62,"_124":17},1034534478,152653171,[129],{"_101":102,"_92":130,"_103":44,"_104":131,"_106":132,"_108":109,"_110":44,"_111":-5,"_112":126,"_59":62,"_113":-5},"sha256:c08a322041afed2f57526ae2c9e6c57a3aab3e6831959f6f49e59f4f220faa51","2026-09-18T13:19:40.306327938Z","2021-07-16T03:11:44Z","2021-07-16T03:11:43.157014Z","dev","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":144,"_151":152,"_140":164,"_165":11},{"_36":145,"_38":146,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":147,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":65,"_66":67,"_68":11,"_69":29,"_70":148,"_76":11,"_77":150,"_82":29,"_83":84},[],[40],[52],{"_72":11,"_73":149},[75],{"_79":17,"_80":11,"_81":11},"tags",{"_153":58,"_154":-5,"_155":-5,"_156":157},"count","next","previous","results",[158,161],{"_89":40,"_90":91,"_92":93,"_94":95,"_96":97,"_98":159,"_46":114,"_115":91,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[160],{"_101":102,"_92":93,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":95,"_59":62,"_113":-5},{"_89":40,"_90":91,"_94":126,"_96":127,"_98":162,"_46":133,"_115":91,"_116":29,"_117":52,"_53":134,"_119":120,"_121":131,"_122":133,"_123":62,"_124":17},[163],{"_101":102,"_92":130,"_103":44,"_104":131,"_106":132,"_108":109,"_110":44,"_111":-5,"_112":126,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

digitalhigh/glimmr

Tags for digitalhigh/glimmr