sblantipodi / firefly_luciferin

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.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Firefly Luciferin

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 firmware,
the combination of these software create the perfect Bias Lighting and Ambient Light system for PC.
Written in Java with a native flavour for Windows and Linux.

Web Installer CI Build CodeQL Analysis GitHub version DPsoftware Discord

If you like Firefly Luciferin, give it a star, or fork it and contribute!

GitHub stars GitHub forks PayPal

Key features

Quick start

You can build the software from the source or if you prefer you can download the installer from here.
Firefly Luciferin uses Java 14 to create the native installer, this means that you don't have to install Java or other libraries separately.

This software can run on any Desktop PC using Windows or Linux. MacOS support will be added later. To get the full Bias Lighting experience you need a microcontroller (ex. ESP8266, ESP32) running Glow Worm Luciferin firmware. You can connect the microcontroller to the PC via USB or via wirelss (MQTT server is optional).

Why don't you build your own Luciferin?
Here's a Quick Start guide

Glow Worm Luciferin + Firefly Luciferin (click to watch it on YouTube)

Luciferin YouTube Video #1

Configuration

As soon as you start the software it creates a FireflyLuciferin.yaml file in your documents folder, you can configure it manually or via the user interface. If you don't know how to configure it, just use the default settings.

IMAGE ALT TEXT HERE

Luciferin Official PCB

If you don't want to design your own PCB and you have a soldering iron, you might find Luciferin's official PCB interesting.

What is the Performance Impact on your System?

Firefly Luciferin is a very optimized software and it has nearly no impact on your system performance.
By default Firefly Luciferin captures at 30FPS, if you want you can unlock the framerate.

If 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, you 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) and how fast your microcontroller is able to process (consume) this data.

Producer framerate should not exceed the consuming one, all data that is not consumed in time, is lost.
A good WiFi signal is required for wireless stream.
Are you interested in the achievable framerate? Click here.

GPU Hardware Acceleration using Java Native Access

Screen capturing is pretty slow and very CPU intensive in Windows systems (Linux is much more efficient in this regard), for this reason I wrapped the Windows GDI32 C class using Java Native Access to access Windows hardware acceleration.

This API captures and delivers captured frames in GPU memory.

If you are running Windows 8 or Windows 10/11 you can use Desktop Duplication API (DDUPL), it's the fastest implementation yet, no lag, no stutter, very small usage of resources. DDUPL is accessed via JNA using the GStreamer bindings for Java.

Contribute

You can contribute to Luciferin by:

  • Providing Pull Requests (Features, Proof of Concepts, Language files or Fixes)
  • Testing new released features and report issues
  • Contributing missing documentation for features and devices
  • With a donation PayPal

Credits

  • Davide Perini

Thanks To

Thanks For
For the IntelliJ IDEA licenses.

About

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.

License:GNU General Public License v3.0


Languages

Language:Java 98.9%Language:CSS 1.1%