hyperion-project/hyperion.ng
Hyperion.ng
Hyperion is an ambient lighting controller and screen color capture engine designed to synchronize networked LED hardware with real-time video and audio content. It functions as a programmable lighting effects engine and networked server, capturing frames from system displays or USB devices to extract dominant colors for immersive lighting environments.
The system distinguishes itself through a protocol-agnostic hardware abstraction layer and a coordinate-based LED mapping system that uses keystone correction for precise physical alignment. It features a modular scripting engine for custom visual effects and integrates HDMI CEC signal detection to trigger lighting responses based on consumer electronics hardware events.
The project covers a broad range of capabilities, including image processing for black border detection and gamma adjustment, as well as the generation of linear and radial color gradients. It provides automation via recurring schedules and system events, while offering remote management through a JSON API and a web interface.
Management utilities include a command-line interface for server control and configuration, along with support for multi-instance deployments and pre-configured system images.
Features
- Real-Time Lighting Visualizers - Provides an engine that synchronizes LED lighting output with real-time video and audio data streams for immersive environments.
- LED Controllers - Acts as a hardware manager for mapping LED layouts and controlling output across diverse protocols.
- Spatial Coordinate Mappings - Translates screen pixels to physical LED positions using spatial coordinates and keystone correction for precise alignment.
- Programmatic Application Control APIs - Provides a programmatic API for remote control of lighting instances and automation of lighting data updates.
- Screen Capture Utilities - Grabs video frames from system displays using various drivers to serve as color sources for lighting.
- System Audio Capture - Captures internal system audio output to generate real-time lighting visualizations.
- Dominant Color Extraction - Extracts dominant colors from image frames and adjusts saturation and brightness for LEDs.
- Lighting Control Systems - Implements a system for managing LED lighting controllers and configurations via a web interface and API.
- Video Frame Capture - Abstracts video acquisition from OS displays and USB hardware to provide a consistent image source for lighting.
- Ambient Lighting Controllers - Captures screen colors and audio to synchronize networked LED hardware for immersive home cinema environments.
- Hardware Device Interfaces - Interfaces with various LED devices to output colors across different hardware communication protocols.
- LED Layout Mapping - Defines the physical arrangement of LEDs using layout patterns and keystone correction.
- Hardware Control Protocols - Interfaces with diverse LED controllers by translating internal color data into specific hardware communication protocols.
- LED Controllers - Provides a centralized interface to manage the state, brightness, and patterns of connected LED hardware.
- Pixel Data Assignment - Assigns specific color values to individual LEDs or the entire strip using a bytearray.
- Real-Time Color Extractors - Grabs real-time video frames from displays and USB devices to extract dominant colors for lighting effects.
- JSON APIs - Provides a structured JSON API for external scripts and controllers to manipulate system state and lighting.
- Public API Exposure - Exposes lighting controls via a machine-readable JSON interface for integration into external scripts and workflows.
- Gamma Correction Utilities - Modifies color intensity using a gamma curve to optimize brightness and saturation for LED output.
- IoT Lighting Automation Systems - Automates lighting states and visual effects based on recurring schedules, system events, and network triggers.
- Event-Driven Triggers - Executes predefined actions based on operating system signals, schedules, and hardware events.
- Black Border Detection - Identifies and ignores black edges in video signals to align lighting with the visible screen content.
- Generative Lighting Effects - Generates dynamic lighting patterns, such as plasma or GIF-based animations, to animate LEDs.
- Gradient Generators - Generates linear, radial, and conical color gradients using defined start and end points.
- Network Lighting Controllers - Functions as a networked server exposing a JSON API to remotely manage lighting configurations.
- Networked Lighting Orchestrators - Synchronizes multiple lighting controllers across a local network to coordinate visual effects.
- LED Effect Rendering - Processes a constructed image and displays it on the hardware as the final step of an effect.
- Pre-built Lighting Patterns - Runs pre-built visual patterns or scripts to create dynamic lighting animations without a video source.
- USB Capture Interfaces - Imports video streams from USB capture devices with integrated hardware controls for brightness and contrast.
- Lighting Effect Functions - Allows development of programmable scripts that extend core functionality by interacting with the lighting workflow.
- Visual Effect Scripts - Enables the creation of custom visual lighting effects through a modular programmable scripting engine.
- Custom Effect Engines - Implements a modular engine for creating custom lighting animations using scripts, gradients, and shapes.
- Global System Settings - Provides a centralized interface for adjusting global parameters, network services, and language preferences.
- Hardware Event Automations - Triggers specific actions based on operating system events, screen locking, or hardware state changes.
- Action Schedules - Runs predefined lighting tasks at specific times of the day using a daily timetable.
- HDMI CEC Controllers - Implements HDMI Consumer Electronics Control (CEC) to trigger lighting responses based on external hardware events.
