Hyperion Ambient Light: baixar versions anteriors

Hyperion 2.2.1 – Fix & Stability Update
This is a small maintenance release focused on improving stability and fixing a few issues introduced in previous versions. No major changes—just a smoother, more reliable experience.
✅ What’s improved
- Art-Net reliability fixes
- Corrected a limitation that restricted output to fewer LEDs than expected
- Improved compatibility with RGBW devices
- Stability improvements
- Fixed an issue where triggering image effects could cause Hyperion to stop unexpectedly (#1980)
- Resolved a user interface error affecting Nanoleaf integrations
- Platform support
- Added support for Ubuntu 26.04
- Added support for Fedora 44 and Fedora 45
🔧 Behind the scenes
- Improved build and system compatibility for more consistent operation
- Internal optimizations to networking and API handling
- Streamlined Docker build process

If you’ve experienced crashes, Art-Net limitations, or UI glitches, this update is recommended.

🚀 Hyperion 2.2.0 Release
Hyperion 2.2.0 has arrived, bringing a significant leap in performance and stability. This release focuses on a massive core refactor designed to slash memory usage and optimize resource consumption. Alongside crucial security updates for Hue Bridge users and expanded RGBW support for WLED and e1.31 devices, we’ve introduced a completely rewritten Windows DDA grabber for better stability and a new DRM/KMS grabber tailored for Raspberry Pi OS users. These architectural overhauls ensure smoother, more efficient ambient lighting across all platforms while resolving long-standing resource bottlenecks.
📥 Get Started & Download
You can download the latest executables via our official repositories for Debian, Ubuntu, and Fedora, or grab the release files directly from GitHub.
- For most users: Please visit our Getting Started Overview for instructions on installing or updating the software.
- For Raspberry Pi users: We recommend HyperBian—a ready-to-use SD card image based on "Raspberry Pi OS Lite" with Hyperion pre-installed. Follow the HyperBian Step-by-Step Guide to get up and running quickly.

⚠️ Breaking Changes
- Align Hue Bridge processing to Philips' guidance on security, i.e. no self-signed certificates for orginal bridges

✨ Added
- Support of RGBW in e1.31 LED devices.
- Support of RGBW in WLED, UDP-DDP, UDP-RAW LED devices.
- HTTPS support for homeassistant LED devices (#1886)
- Hue Bridge - Use https and certificates for all API calls, support Bridge Pro (V3)
- Hue Bridge - Alternate certificate support
- Linux: New DRM/KMS screen grabber with plane-based capture - not feature complete yet
- Home Assistant: Dynamically set brightness for higher dynamic range (#1922)
- Add DRM_FORMAT_RGB565 format to DRM frame grabber
- Add standalone DRM grabber
- Avoid queuing on image processing for output
- Validation of RFC 4122 UUID (Universally Unique Identifier) elements and apply it e1.31 devices config screen

🔧 Changed
- Hue Bridge - Wizard updates to support bridge-ids, overall code refactoring
- USB Grabber - Default hardware control properties are now applied when a new USB grabber is selected (avoids black images)
- USB Grabber - Correct garbage default control values to avoid save issues (#1928)
- Windows DDA Grabber - Rewritten grabber internals for better performance & stability and fixed various issues, e.g. screen locking, -orientation handling (#1872), sleep (#1893)
- Amlogic grabber - Capture image in target size to avoid extra downscaling by CPU
- Web UI: Update panel title uses "Hyperion - "; skip showing the "nightly" tag in releases list
- Screen grabbers: Commonized base with getDeviceName/getInputDeviceDetails; explicit constructors; improved error handling
- Framebuffer grabber: Internal cleanup, consistent device naming, safer mmap usage
- Logger internals: use smart pointers and clean-ups
- Align instance source settings for new instances with grabber enable state
- Forwarder: Clear remote priority 1 when the forwarding instance is stopped
- Fixes:
- UI - Menu is not opened on small (mobile) screens
- UI - Language is not selectable (#1877)
- UI - Release were not shown on Update page
- UI - Fixes for input/format selection
- UI - Fix that gap-length could get negative
- UI - Systray Settings is not using the actual port (#1964)
- UI - Dashboard, wrap long version text
- UI - Non local network connection is dropped without providing a reason (#1970)
- CEC-Handler is not stopped every instance started
- Qt-Grabber (Windows) does not apply pixel ratio (#1882) - Thanks to @SolberLight
- LED-devices are not retrying to establish connectivity, if supported by the device
- LED-devices are resolving IP-addresses for API and UDP two times in sequence
- LED-device updates queue up and let Hyperion crash (#1887)
- LED-device switch-off were not always executed during instance stopping
- LED-Device latchTime was not considered correctly
- LED-Device Adalight LightBerry APA102 Mode not workin

🌿 Hyperion goes green!
Resource consumption during builds has been drastically reduced behind the scenes by streamlining processes and encouraging reuse.
This release also involves significant refactoring of the core elements of the platform and the API.
This version comes with many bug fixes and a number of long-awaited new features and improvements.
You can download the executables from GitHub or even better via our official repositories for Debian, Ubuntu and Fedora.
Installation and update instructions can be found on the comprehensive instructions page. Just select the method you would like to use.
[!NOTE]
This release supersedes versions 2.1 and 2.1.0, which had some critical issues. Many thanks to those who shared their findings, and we apologise for any inconvenience caused.
Change details
⚠️ Breaking Changes
- Rename "-v" & "--verbose" options to "-i" & "--info to not overlap with version information
JSON-API
- Standardized subscription update elements: ledcolors-imagestream-update, ledcolors-ledstream-update, and logmsg-update now return data under data instead of result.
- Global configuration elements are now separated from instance-specific ones.

✨ Added
- Windows: Added a new grabber using DXGI DDA (Desktop Duplication API) for improved GPU-based performance. Thanks to @davidsansome (#1745, #1753)
- Support for bottom-up image handling using the MF grabber. Thanks to @Thinner77 (#1752)
- Support for FTDI chip-based LED devices (WS2812, SK6812, APA102). Thanks to @nurikk (#1746)
- Support for 16-bit HD108 LEDs via SPI. Thanks to @FutureMan0 (#1826)
- Support for HomeAssistant devices (#1763)
- Support for Skydimo devices
- Support for new Nanoleaf device types
- Support for gaps in matrix layout (#1696)
- Support for NV12 format in Flat-Buffer image streams
- Support for SizeDecimation in Flat-Buffer inputs
- Support for temperature adjustment (#658)
- Configurable grabber inactivity detection interval (#1740)
- Dominant color processing across the full image, applied to all LEDs (#1853)
- Selectable source and target instances in the forwarder
- Import, export, and backup of Hyperion's configuration via UI, JSON-API, and CLI (--importConfig, --exportConfig) (#804)
- Option to force read-only mode at startup (--readonlyMode)
- Effects: Limit update rate to 200 Hz
- Systray: Support for multiple instances
- UI:
- Validation to ensure key ports do not overlap across editors/pages
- Enhanced error dialog with additional details
- LED preview displays the associated instance name
- HTTP Server: Support for Cross-Origin Resource Sharing (CORS) (#1496)
- GitHub builds Added Windows 11 on arm64 platform
JSON-API
- New event subscriptions: Suspend, Resume, Idle, IdleResume, Restart, Quit
- Support for direct/multi-instance addressing within single requests (#809)
- serverinfo subcommands: getInfo, subscribe, unsubscribe, getSubscriptions, getSubscriptionCommands
- API Overview
- Query/save specific configuration items per instance
- Update frequency limits:
- Images: 25 Hz
- Raw LED colors: 40 Hz
- LED device data: 200 Hz
- Request instance data (e.g., image snapshots, LED colors). Thanks to @xIronic (#1839)

🔧 Changed
- Instances no longer depend on the first instance; any can be created, started, stopped, or removed independently.
- Security Fixes:
- Fixed Cross-Site Scripting (XSS) vulnerabilities (CVE-2024-4174, CVE-2024-4175)
- Added detailed logs for "Trust on first use" certificates, especially when a certificate can't be stored
- Fixes:
- Broken links in README. Thanks to @blueicehaller (#1780)
- RGB24/BGR24 cleanup. Thanks to @Thinner77 (#1748, #1749)
- Clarifying comments in MF grabber. Thanks to @Thinner77 (#1754)
- Nanoleaf LED strip overlap error. Thanks to @geekykayaker (#1844)
- Philips Hue APIv2 support without Entertainment group (#1742)
- hyperion-v4l2 screenshot failures (#1722)
- Token dialog not closing
- Kodi color calibration and wizard refactor (#1674)
- Forwarding to custom targets (#1713)
- Sc

🌿 Hyperion goes green!
Resource consumption during builds has been drastically reduced behind the scenes by streamlining processes and encouraging reuse.
This release also involves significant refactoring of the core elements of the platform and the API.
This version comes with many bug fixes and a number of long-awaited new features and improvements.
You can download the executables from GitHub or even better via our official repositories for Debian, Ubuntu and Fedora.
Installation and update instructions can be found on the comprehensive instructions page. Just select the method you would like to use.
Change details
⚠️ Breaking Changes
- Rename "-v" & "--verbose" options to "-i" & "--info to not overlap with version information
JSON-API
- Standardized subscription update elements: ledcolors-imagestream-update, ledcolors-ledstream-update, and logmsg-update now return data under data instead of result.
- Global configuration elements are now separated from instance-specific ones.

✨ Added
- Windows: Added a new grabber using DXGI DDA (Desktop Duplication API) for improved GPU-based performance. Thanks to @davidsansome (#1745, #1753)
- Support for bottom-up image handling using the MF grabber. Thanks to @Thinner77 (#1752)
- Support for FTDI chip-based LED devices (WS2812, SK6812, APA102). Thanks to @nurikk (#1746)
- Support for 16-bit HD108 LEDs via SPI. Thanks to @FutureMan0 (#1826)
- Support for HomeAssistant devices (#1763)
- Support for Skydimo devices
- Support for new Nanoleaf device types
- Support for gaps in matrix layout (#1696)
- Support for NV12 format in Flat-Buffer image streams
- Support for SizeDecimation in Flat-Buffer inputs
- Support for temperature adjustment (#658)
- Configurable grabber inactivity detection interval (#1740)
- Dominant color processing across the full image, applied to all LEDs (#1853)
- Selectable source and target instances in the forwarder
- Import, export, and backup of Hyperion's configuration via UI, JSON-API, and CLI (--importConfig, --exportConfig) (#804)
- Option to force read-only mode at startup (--readonlyMode)
- Effects: Limit update rate to 200 Hz
- Systray: Support for multiple instances
- UI:
- Validation to ensure key ports do not overlap across editors/pages
- Enhanced error dialog with additional details
- LED preview displays the associated instance name
- HTTP Server: Support for Cross-Origin Resource Sharing (CORS) (#1496)
- GitHub builds Added Windows 11 on arm64 platform
JSON-API
- New event subscriptions: Suspend, Resume, Idle, IdleResume, Restart, Quit
- Support for direct/multi-instance addressing within single requests (#809)
- serverinfo subcommands: getInfo, subscribe, unsubscribe, getSubscriptions, getSubscriptionCommands
- API Overview
- Query/save specific configuration items per instance
- Update frequency limits:
- Images: 25 Hz
- Raw LED colors: 40 Hz
- LED device data: 200 Hz
- Request instance data (e.g., image snapshots, LED colors). Thanks to @xIronic (#1839)

🔧 Changed
- Instances no longer depend on the first instance; any can be created, started, stopped, or removed independently.
- Security Fixes:
- Fixed Cross-Site Scripting (XSS) vulnerabilities (CVE-2024-4174, CVE-2024-4175)
- Added detailed logs for "Trust on first use" certificates, especially when a certificate can't be stored
- Fixes:
- Broken links in README. Thanks to @blueicehaller (#1780)
- RGB24/BGR24 cleanup. Thanks to @Thinner77 (#1748, #1749)
- Clarifying comments in MF grabber. Thanks to @Thinner77 (#1754)
- Nanoleaf LED strip overlap error. Thanks to @geekykayaker (#1844)
- Philips Hue APIv2 support without Entertainment group (#1742)
- hyperion-v4l2 screenshot failures (#1722)
- Token dialog not closing
- Kodi color calibration and wizard refactor (#1674)
- Forwarding to custom targets (#1713)
- Screen capture error (#1824)
- Python 3.12 crash fixes (#1747)
- UI LED buffer/layout sync issues
- Last effect event not cleared in source overview
- Smoothing issues (#1863)
- Crash w

The release has been in the works for almost 12 months covering bug fixes and it includes a good number of new features/improvements.
You can get the executables from GitHub or even better via our official repositories for Debian, Ubuntu and Fedora (new). All latest versions are supported (Bookworm, Mantic Minotaur, Fedora 39), as well as the upcoming ones (Trixie, Noble Numbat, Fedora 40).
Installation/update instructions, as well as even an easy one command way you find in the comprehensive instructions page, just select the way you would like to go for.
Added
- New languages: Hebrew, Indonesian, Ukrainian
Event Services
- Newly introduced Event Service configuration and consistent handling across all components
- Suspend/Resume & Screen Locking support for MacOS
- Allow to enable/disable suspend & lock on operating system events (#1633, #1632)
- Scheduled events allowing to suspend,resume, etc. (#1088)
- Configurable CEC event handling
LED-Devices
Philips Hue
- APIv2 support, incl. full https security and certificate validation
- Multi-Segment device support, e.g. Gradient light
- Use Entertainment area device location for Hyperion layout in addition to manual locations
- Option to layout by focussing on full- or only center of entertainment area
- Wizard supports multiple Hue-Bridge discovery
- Support of DIYHue specifics. DIYHue bridge's name must start with "DIYHue"
- Backward compatibility for bridges not supporting APIv2 and/or Entertainment API Note: The wizard will configure an APIv2 capable bridge always with Entertainment to ensure the best experience.
Nanoleaf
- Wizard to generate user authorization token allowing users to configure the device via a single window
- Generation of a default layout per device's configuration, including orientation
- Lines support
Changed
- Updated misleading error messages in case Hyperion is not able to support the suspend/lock feature (#1622)
- Restart Serial Device, if write error occurred
- ws281x - Update logic to identify is user is admin and disable device configuration if not (#1621)
- Hide Hyperion from the Dock on macOS, as all features can be accessed from the menubar - Thanks @Rastafabisch
Fixed
- Correctly display local language characters in log, e.g. Umlauts
- Fixed that Audio Capture is enabled after reboot automatically (#1581)
- Fixed that Audio Capture is not shown when there is no screen nor video grabber
- Audio Capture settings are no longer ignored (#1630)
- Fixed that the Matrix effect finds its image - Thanks @lsellens
- MDNSBrower - Fixed, if timeout while resolving host occurs
- Non image updates ignored blacklisted LEDs (#1634)
- Fixed that Windows OsEvents failed in non-GUI mode (#1671)
- Addressed serious (#1425) and some smaller memory leaks
LED-Devices
WLED
- Fixed UI handling, if segment streaming is not supported
Nanoleaf
- "Panel numbering sequence" was not configurable any longer
- Number of panels increased during retries (#1643)
Removed
LED-Devices
Philips Hue
- "Switch Off On Black" for APIv2, as the original bridge will switch off LEDs itself.
- "Candy Gamma" for APIv2, as the bridge maps the RGB values best per device.
Nanoleaf
- Removed "Start Position" in favour of the general Blacklist feature provided
Technical
- Changed default build from Stretch to Buster
- Support Qt 6.7, Update to Protobuf 25.1, Update mbedTLS to v3.4.0, Update flatbuffers to v23.5.26
- Use C++17 standard as default
- Added Pull Request (PR) installation script, allowing users to test development builds savely on Linux
- Fixed missing include limits in QJsonSchemaChecker - Thanks @Portisch
- Fixed dependencies for deb packages in Debian Bookworm (#1579) - Thanks @hg42, @Psirus
- Fixed git version identification when run in docker and local code
- Address cmake deprecation warnings, cmake 3.5 is required at minimum now
- Address some build warnings
- Removed UniqueConnections from Lambdas, as not supported

Hyperion's February release provides you with the latest updates and fixes.
Key new features: You can now stream to a dedicated WLED segment, put Hyperion in Suspend or Idle mode or apply dominant color rather than mean color processing.
Many thanks to @EliteScientist who contributed with an audio grabber which works as the other existing grabbers,
i.e. you can use the input feeding multiple instances in parallel or forward the input.
Added
- Audio Grabber to add audio visualization support for both Windows and Linux.
- Support streaming to individual WLED segments (requires WLED 0.13.3+).
To allow segment streaming, enable "Realtime - Use main segment only" in WLED's Sync Interfaces setup screen
- Allow to keep WLED powered on after streaming and restoring state
- Allow to Disable / Enable all instances (#970) by
- Suspend/Resume support for Linux and Windows (#1493,#1282, #978).
Suspend/Resume/Restart is supported via API, UI, Systray and hyperion-remote
- Idle scenario via Screen Locking (Linux/Windows), Screensaver invokation (Linux), hyperion-remote or API
In Idle, all instances, components will be disabled besides the output processing (LED-Devices, smoothing).
The current priorities will be cleared and the background effect per instance will be executed, if enabled.
- Commands toogleSuspend and toggleIdle allow to flip between modes, e.g. might be used to trigger modes by a remote
- Reduced pixel processing to reduce resources on big assignment areas
- Support for squared mean color processing
- Support for dominant color processing on assigned LED areas (#1382). A simple and advanced way is provided. Advanced and high accuracy might be combined with reduced pixel processing to lower CPU usage.
- Add instance# in API response (#1504)
Changed
- Renamed LED area assignment naming to provide clarity on the processing algorithms
- REST API: Increased default timeout to address "Operation cancelled" errors
- LED Devices: Allow to differentiate between recoverable/unrecoverable errors
Fixed
- Effects/Smoothing: Effects with dedicated smoothing settings will now run with those settings (even if general smoothing is off)
- No interim color update at WLED after streaming and turning off WLED
- LED-Matrix Layout: Add Cabling direction selection element again (#1566)
- Restart correctly, if running as service (#1368)
- Hue-Wizard: In case auto discovery failed, port 80 was not used as default (#1544)
- Send only one reply per Start Instance request (#1551)
- Add instance# in JSON-API replies (aligning to Add instance in websocket response to a subscription #1504 behaviour)
- hyperion-remote: Extracting reply for a configGet request correctly (#1555)
- Grabber fps setting was not applied correctly
- Smoothing: No empty updates
Technical
- Add CodeQL for GitHub code scanning
- Update to Protocol Buffers 3.21.12
- Update to Mbed TLS 3.3.0
- Qt6 alignments
- cmake support of libcec without version in lib-name
- Refactor for Python 3.11 deprecated functions