{"id":13575893,"url":"https://github.com/sblantipodi/firefly_luciferin","last_synced_at":"2026-03-10T05:03:57.724Z","repository":{"id":37596920,"uuid":"265508166","full_name":"sblantipodi/firefly_luciferin","owner":"sblantipodi","description":"Very fast Java screen capture PC software designed for the Glow Worm Luciferin firmware, the combination of these software create the perfect Bias Lighting and Ambient Light system for PC.","archived":false,"fork":false,"pushed_at":"2026-03-02T12:08:24.000Z","size":285722,"stargazers_count":430,"open_issues_count":19,"forks_count":36,"subscribers_count":8,"default_branch":"master","last_synced_at":"2026-03-02T16:09:20.202Z","etag":null,"topics":["ambient-light","ambilight","bias-lighting","esp","esp32","esp8266","sk6812","ws2812b"],"latest_commit_sha":null,"homepage":"","language":"Java","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/sblantipodi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["sblantipodi"],"custom":["https://www.paypal.com/donate?hosted_button_id=ZEJM8ZLQW5E4A","https://www.patreon.com/Luciferinambilightclone"]}},"created_at":"2020-05-20T08:59:25.000Z","updated_at":"2026-03-02T12:08:27.000Z","dependencies_parsed_at":"2023-12-21T00:21:24.643Z","dependency_job_id":"73140f93-1701-41be-89de-95b5146577b4","html_url":"https://github.com/sblantipodi/firefly_luciferin","commit_stats":null,"previous_names":[],"tags_count":65,"template":false,"template_full_name":null,"purl":"pkg:github/sblantipodi/firefly_luciferin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sblantipodi%2Ffirefly_luciferin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sblantipodi%2Ffirefly_luciferin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sblantipodi%2Ffirefly_luciferin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sblantipodi%2Ffirefly_luciferin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sblantipodi","download_url":"https://codeload.github.com/sblantipodi/firefly_luciferin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sblantipodi%2Ffirefly_luciferin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30325603,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T01:36:58.598Z","status":"online","status_checked_at":"2026-03-10T02:00:06.579Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["ambient-light","ambilight","bias-lighting","esp","esp32","esp8266","sk6812","ws2812b"],"created_at":"2024-08-01T15:01:05.181Z","updated_at":"2026-03-10T05:03:57.717Z","avatar_url":"https://github.com/sblantipodi.png","language":"Java","funding_links":["https://github.com/sponsors/sblantipodi","https://www.paypal.com/donate?hosted_button_id=ZEJM8ZLQW5E4A","https://www.patreon.com/Luciferinambilightclone"],"categories":["Java"],"sub_categories":[],"readme":"# Firefly Luciferin\nAmbient Lighting or Bias Light is a technology that enhances your viewing experience by projecting colored lights onto the wall behind your TV/Monitor, matching the colors on the screen. This creates a more immersive and engaging atmosphere, making your favorite shows, movies, and games feel even more captivating.  \n\n**Luciferin** is a generic term for the light-emitting compound found in organisms that generate bioluminescence like Fireflies and Glow Worms. `Firefly Luciferin is a Java Fast Screen Capture` PC software designed for the [Glow Worm Luciferin](https://github.com/sblantipodi/glow_worm_luciferin) firmware, the combination of these software create the perfect `Bias Lighting and Ambient Light system for PC`.  \n_Written in Java with a native flavour for Windows and Linux._  \n\n\n\u003cimg align=\"right\" width=\"100\" height=\"100\" src=\"https://raw.githubusercontent.com/sblantipodi/firefly_luciferin/master/data/img/luciferin_logo.png\"\u003e\n\n\n[![Web Installer](https://img.shields.io/website/https/sblantipodi.github.io/glow_worm_luciferin.svg?label=Web%20Installer\u0026down_color=red\u0026down_message=offline\u0026up_color=4bc51d\u0026up_message=online\u0026logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAIAAAACACAMAAAD04JH5AAAAD1BMVEUAAAD%2F%2F%2F%2F%2F%2F%2F%2F%2FVyL%2F%2F%2F8bK2t7AAAAA3RSTlMAARYXuUDOAAAAhklEQVR42u3WyQ2AMAwEQAz9lxxCCRCuONHse2XPy3JsS98EAAAAAAAAQDpAfLywAgAADAuoJ716dw4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMAwgLcCAACQH%2FB3AAAAAAAAAPoDWovrxYdjBwAAmA7QerAKAADANICnD0sBAADIDjgAPijZuQgZskEAAAAASUVORK5CYII%3D)](https://sblantipodi.github.io/glow_worm_luciferin)\n[![Wiki](https://img.shields.io/website/https/sblantipodi.github.io/glow_worm_luciferin.svg?label=Wiki\u0026down_color=red\u0026down_message=offline\u0026up_color=4bc51d\u0026up_message=online\u0026logo=read-the-docs\n)](https://github.com/sblantipodi/firefly_luciferin/wiki)\n[![GitHub version](https://img.shields.io/github/v/release/sblantipodi/firefly_luciferin.svg)](https://github.com/sblantipodi/firefly_luciferin/releases)\n[![DPsoftware](https://img.shields.io/static/v1?label=DP\u0026message=Software\u0026color=orange)](https://www.dpsoftware.org)\n[![Discord](https://img.shields.io/discord/747247942074892328.svg?logo=discord\u0026logoColor=white\u0026color=5865F2\u0026label=Discord)](https://discord.gg/aXf9jeN)\n[![PayPal](https://img.shields.io/badge/donate-PayPal-blue)](https://www.paypal.com/donate?hosted_button_id=ZEJM8ZLQW5E4A)\n\n\nIf you like **Firefly Luciferin**, give it a star, or fork it and contribute!\n\n[![GitHub stars](https://img.shields.io/github/stars/sblantipodi/firefly_luciferin.svg?style=social\u0026label=Star)](https://github.com/sblantipodi/firefly_luciferin/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/sblantipodi/firefly_luciferin.svg?style=social\u0026label=Fork)](https://github.com/sblantipodi/firefly_luciferin/network)\n[![Downloads](https://img.shields.io/github/downloads/sblantipodi/firefly_luciferin/total.svg?logoColor=white\u0026color=5865F2\u0026label=downloads)](https://github.com/sblantipodi/firefly_luciferin/releases)\n[![CI Build](https://github.com/sblantipodi/firefly_luciferin/actions/workflows/build.yml/badge.svg)](https://github.com/sblantipodi/firefly_luciferin/actions)\n[![CodeQL Analysis](https://github.com/sblantipodi/firefly_luciferin/actions/workflows/codeql.yml/badge.svg)](https://github.com/sblantipodi/firefly_luciferin/actions/workflows/codeql.yml)\n\n## Key features\n- **Best in class performance** combined with ultra low CPU/GPU usage.  \n- Advanced algorithms for [**smooth colors transitions**](https://github.com/sblantipodi/firefly_luciferin/wiki/Smoothing-color-transitions) and [**color correction**](https://github.com/sblantipodi/firefly_luciferin/wiki/Color-Grading-(Hue-Saturation-and-Lightness-tuning)). Seeing is believing.\n- [**Wireless or cabled, local or remote**](https://github.com/sblantipodi/firefly_luciferin/wiki/Remote-Access)? Choose your flavour with **MQTT** support and  [**Home Assistant integration**](https://github.com/sblantipodi/firefly_luciferin/wiki/Home-Automation-configs).\n- [**Multi monitor**](https://github.com/sblantipodi/firefly_luciferin/wiki/Multi-monitor-support) support with **single or multiple instances**.\n- [**Surround lighting**](https://github.com/sblantipodi/firefly_luciferin/wiki/Surround-lighting-with-satellites) with satellites.  \n- [**Web browser firmware installer**](https://sblantipodi.github.io/glow_worm_luciferin/) and [**Web Interface**](https://github.com/sblantipodi/firefly_luciferin/wiki/Remote-Access#luciferin-web-interface).\n- [**Programmable firmware**](https://github.com/sblantipodi/firefly_luciferin/wiki/Supported-GPIO-and-Baud-Rate), change your microcontroller's settings on the fly.\n- Frequent updates, [**upgrade**](https://github.com/sblantipodi/firefly_luciferin/wiki/Luciferin-update-management) your PC software and your firmware **in one click**.\n- Automatic [**switching between aspect ratios**](https://github.com/sblantipodi/firefly_luciferin/wiki/Aspect-ratio) based on your video content.\n- **Made from a gamer, for gamers**. No added lag, stutter free.\n- Multi platform, [**Windows**](https://github.com/sblantipodi/firefly_luciferin/wiki/Installers-and-binaries) and [**Linux**](https://github.com/sblantipodi/firefly_luciferin/wiki/Linux-support) ready. macOS is coming when it's ready.\n- If you don't want to design your own PCB and you have a soldering iron, there is [**Luciferin's official PCB**](https://github.com/sblantipodi/firefly_luciferin/wiki/Ready-to-print-PCB).\n- Have a question? [**Get answered on the community**](https://discord.gg/aXf9jeN).\n\n## Quick start\n\nYou can **download the installer for Windows or Linux [here](https://github.com/sblantipodi/firefly_luciferin/releases)**.  \nThe Linux version is also available on [Flathub](https://flathub.org/apps/org.dpsoftware.FireflyLuciferin)\nand [Snap Store](https://github.com/sblantipodi/firefly_luciferin/issues/207)\n  \nThis software can run on any Desktop PC using **Windows or Linux**. MacOS support will be added later.\nTo get the full `Bias Lighting` experience you need a microcontroller (ex. ESP8266, ESP32)\nrunning [Glow Worm Luciferin](https://github.com/sblantipodi/glow_worm_luciferin) firmware. You can connect the\nmicrocontroller to the PC via USB or via wireless (WiFi/Ethernet, MQTT server is optional).\n\nWhy don't you build your own `Luciferin`?  \nHere's a [**Quick Start guide**](https://github.com/sblantipodi/firefly_luciferin/wiki/Quick-start)  \n\n## Firefly Luciferin (PC Software) + Glow Worm Luciferin (Firmware)\n\n[![Luciferin YouTube Video #1](https://raw.githubusercontent.com/sblantipodi/firefly_luciferin/master/data/img/ambilight_color.png)](https://youtu.be/PO37JC7-Nn4?si=nxVYd5b_qlfqo6HP)\n\n#### (click the image above to watch it on YouTube)\n\n## Easy to learn, easy to use\n\nEffortless setup with minimal configuration required, yet highly customizable to meet specific needs.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/sblantipodi/firefly_luciferin/master/data/img/settings_1.png\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/sblantipodi/firefly_luciferin/master/data/img/settings_2.png\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/sblantipodi/firefly_luciferin/master/data/img/settings_3.png\"\u003e\n\u003c/p\u003e\n\n[\u003cimg width=\"900\" src=\"https://github.com/sblantipodi/firefly_luciferin/blob/master/data/img/test_image_anim_color.gif?raw=true\"\u003e](https://youtu.be/j7IV9rQr7J8)\n\n#### (click the image above to watch it on YouTube)\n\n## Luciferin Official PCB\n\n\u003cimg align=\"center\" width=\"700\" src=\"https://github.com/sblantipodi/glow_worm_luciferin/blob/master/assets/CAD_schematics/PCB_ESP8266/img/PCB_front.jpg?raw=true\"\u003e\n\u003cimg align=\"center\" width=\"700\" src=\"https://github.com/sblantipodi/glow_worm_luciferin/blob/master/assets/CAD_schematics/PCB_ESP8266/img/pre_after.jpg?raw=true\"\u003e\n\nIf you don't want to design your own PCB and you have a soldering iron, you might\nfind [Luciferin's official PCB](https://github.com/sblantipodi/firefly_luciferin/wiki/Ready-to-print-PCB) interesting.  \nThis page provides more information about\nthe [hardware compatibility](https://github.com/sblantipodi/firefly_luciferin/wiki/Compatible-Hardware) of Luciferin.\n\n## What is the Performance Impact on your System?\nFirefly Luciferin is a very optimized software and it has **nearly no impact on your system performance**.  \nBy default Firefly Luciferin captures at 30FPS, if you want you can unlock the framerate.  \n  \nIf you are using a slow microcontroller, capturing at a very high framerate will not help. If you right click the tray icon and then click `FPS`,\nyou can see the output as shown in the image below. In that output you can see how fast the software is capturing the screen (producing)\nand how fast your microcontroller is able to process (consume) this data.  \n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"600\" src=\"https://raw.githubusercontent.com/sblantipodi/firefly_luciferin/master/data/img/info_screen.png\"\u003e\n\u003c/p\u003e\n\nProducer framerate should not exceed the consuming one, all data that is not consumed in time, is lost.   \nA good WiFi signal is required for wireless stream.  \nAre you interested in the achievable framerate? Click [here](https://github.com/sblantipodi/firefly_luciferin/wiki/Very-fast-capture).\n\n## GPU Hardware Acceleration\n\nScreen capturing is pretty slow and very CPU intensive in Windows systems (Linux is much more efficient in this regard),\nfor this reason I wrapped the Windows GDI32 C class using [Java Native Access](https://github.com/java-native-access/jna) to access Windows hardware acceleration.  \n\nThis API captures and delivers captured frames in GPU memory. \n\nIf you are running Windows 8 or Windows 10/11 you can use `Desktop Duplication API (DDUPL)`, it's the fastest implementation yet, no lag, \nno stutter, very small usage of resources. DDUPL is accessed via [JNA](https://github.com/java-native-access/jna) using the [GStreamer bindings for Java](https://gstreamer.freedesktop.org/bindings/java.html).\n\n## Deep integration with your OS\nThanks to the `Java Foreign Function and Memory API`, Luciferin is deeply integrated with your operating system through a series of bindings to native libraries. This guarantees maximum efficiency and compatibility.\n\n## Luciferin Web Interface\nGlow Worm Luciferin FULL firmware exposes a `Web Interface` to control your lights from your browser without the needs of the Firefly Luciferin PC client.\n\n\u003cimg align=\"center\" width=\"750\" src=\"https://github.com/sblantipodi/glow_worm_luciferin/blob/master/assets/img/web_interface.jpg?raw=true\"\u003e\n\n## Home Assistant Mobile Client Screenshots  \nGlow Worm Luciferin firmware can be easily integrated in [Home Assistant](https://github.com/sblantipodi/firefly_luciferin/wiki/Home-Automation-configs).  \n\u003cbr\u003e\n\u003cimg align=\"center\" width=\"800\" src=\"https://github.com/sblantipodi/firefly_luciferin/blob/master/data/img/ha_luciferin.jpg?raw=true\"\u003e  \n\n## Contribute\nYou can contribute to Luciferin by:\n- Providing Pull Requests (Features, Proof of Concepts, Language files or Fixes)\n- Testing new released features and report issues\n- Contributing missing documentation for features and devices\n- With a donation [![PayPal](https://img.shields.io/badge/donate-PayPal-blue)](https://www.paypal.com/donate?hosted_button_id=ZEJM8ZLQW5E4A)\n\n## Credits\n- Davide Perini\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsblantipodi%2Ffirefly_luciferin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsblantipodi%2Ffirefly_luciferin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsblantipodi%2Ffirefly_luciferin/lists"}