Skip to content

Releases: hyperion-project/hyperion.ng

Nightly build 20260503

03 May 00:55
3ad299a

Choose a tag to compare

Pre-release

🌙 Hyperion — Nightly Build (Development Version)

Would you like to try out new features before they are officially released?
Then the Nightly Build version of Hyperion is just right for you!

What to Expect

  • Nightly builds often include bug fixes for known, reproducible issues.
  • However, they may also introduce new, untested features that could cause occasional stability problems.
  • Please use this version with caution if you rely on a stable setup.

Warning

Note that changes to the configuration may be made which are not reverted easily. To prevent data loss or configuration conflicts, it's strongly recommended to:

Installing

🐧 Linux

We recommend installing Linux nightly builds via our APT/DNF repository.
Start via Linux -> Easy Install -> check "Nightly release" tab.

Note: The *.deb and *.tar.gz packages attached here are based on Debian Bullseye and are tailored for the platform specified in the filename.

🪟 Windows

We offer two installers for Windows 11:

  • *-x64.exe (for standard 64-bit systems)
  • *-arm64.exe (for ARM-based systems)

🍏 macOS

Choose the version based on your architecture:

  • *-x86_64.dmg — Requires macOS 13.5 Ventura or newer
  • *-arm64.dmg — Requires macOS 14.0 Sonoma or newer

Help Us Improve!

If you encounter any bugs or issues, please let us know — your feedback helps us make Hyperion better! 😉

Hyperion 2.2.1

06 Apr 17:52

Choose a tag to compare

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

03 Feb 07:21

Choose a tag to compare

🚀 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 (Kodi grabbing does currently not work). 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 working (#1961)
    • Segfault when turning an LED instance off (#1903)
    • Fix concurrent mDNS resolution (#1906) - Thanks to @discordianfish
    • The color of the backlight threshold is green, not white/gray (#1899)
    • Install - Ubuntu 25.10 unable to install due to libcec package (#1934)
    • hyperion-remote/standalone grabbers cannot resolve local address (#1909)
    • RAM Leak with hyperiond. Gbytes in a matter of days. (#1792)
    • Memory Leak with new Hyperion 2.1.1 on Windows 11 (#1892)
    • JSON-API: Instance Command without proper instances is using wrong instance ID
    • Import 2.1.1 config via 2.1.2 UI fails validation (#1907)
    • Memory/Image queuing issue when all instances are stopped but grabber is running
    • Forwarder was not using the correct target instance IDs for JSON requests
    • Flatbuffer/Protobuffer sources are not reconnected after (re)starting a hyperion instance
    • Flatbuffer/Protobuffer breaks, if socket drops while sending a reply
    • Adalight.ino changes due to FastLED update (#1942) Thanks to @JackSwieper
    • mdnsBrowser is not stopped properly on shutdown
    • ColorTypes are not correctly initialised to black
    • WebSockets are not closed properly when stopping Hyperion
    • Tracing is not initialized for hyperion remote executables
    • DDA Grabber is entering permanent error state when elevated or policy deny DDA
  • Refactors:

    • Fixed Image & ImageData and add debug logging (#1792, #1892)
    • Aligned grabbers with reworked Image handling avoiding extra copies
    • Moved Image & LEDData throttling to Callback, limit image size
    • Streamlined LEDDevice code
    • Removed unnecessary allocations. Recreate imageToLedColors only if a parameter changed
    • JSON-API add resillance, e.g. reject instance cmds if no instance is running
    • Logging/Tracing: Introduced qlogging categories to enable dynamic tracing, removed bespoke compile time tracing
    • Handle singletons consistently
    • Adressed Linter findings

🗑️ Removed

  • Amlogic grabber - Removed support to grab DRM & FB-DEV, i.e.Kodi screens on will not be captued on CoreElec

Technical

  • Update mbedTLS to v3.6.4, Update flatbuffers to v25.9.23, Update rpi_ws281x library
  • Have vscode launch configurations working across OS
  • Ensure consistent build timestamp
  • Windows: added more granular stack tracing

Hyperion 2.1.1

14 Jun 17:45

Choose a tag to compare

🌿 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.

Tip

In case your USB grabber produces a black output it is likely that its hardware controls are set to zero.
To get this corrected:

  1. Switch to 'Expert" settings level
  2. Go to the "Capturing Hardware" Screen
  3. Click the "Default hardware controls" button (the "Hardware xxx control" values should change)
  4. Save the updated settings

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
  • 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 when switching display managers (XCB/X11 to Wayland)
    • Effect not suspended when instance is stopped (#1586)
    • Background effect incorrectly starts when instance is disabled
    • Incorrect target directory built during effect export
    • Removed stale _logger object
    • Windows: improper use of “/dev/null”
    • Fragmented HTTP headers causing "incorrect HTTP headers" error (#1688)
    • Misleading "Access Denied" message; disabled "Identify" for the same serial device type (#1737)
    • WebUI unreachable via IPv6 (#1871)
    • Align install_pr script working with default Qt6 builds & show authentication failures (#1871)
  • Web UI:

    • Workaround that Content type is wrongly resoved (#1692)
    • Sorted instance lists; active instances are now highlighted in dropdowns
  • Networking/UI:

    • Replaced custom WebSocket implementation with QWebSockets (#1816, #1448, #1247, #1130)
    • Fixed mDNS browser deadlock by moving it to a dedicated thread
  • Platform-Specific:

    • macOS: Use ScreenCaptureKit on macOS 15+
    • Standalone grabber no longer captures without a connected remote host
  • Layout:

    • Removed maximum LED limit from matrix layout schema to match UI (#1804)
  • Refactors:

    • ImageResampler improvements. Thanks to @Thinner77 (#1744)

    • Corrected confusing _noSignalDetected logic. Thanks to @Thinner77 (#1731)

    • Removed unused libraries for Amlogic. Thanks to @Portisch (#1725)

    • GrabberWrapper constructors (#1714)

    • Database access and validation/migration on startup

    • Forwarder cleanup

    • Flatbuffer client/connection handling

    • Decoupled effect definitions from instances

    • Decoupled WebServer from SSDP handler

    • Python effects: support parallel processing (Python 3.12)

    • Corrected threads' affinity

    • Use of smart pointers

    • UI code streamlining

    • Improved install_pr script

    • Replaced exceptions by signaling errors in main program and standalone grabbers

    • Enhanced resilience and error handling

    • Build:

      • Updated CompileHowto for macOS. Thanks to @Rastafabisch (#1757)
      • Added missing ENABLE_MDNS. Thanks to @Links2004 (#1711)
      • Build system now uses pre-built dependencies to reduce resource usage
      • Introduced CMakePresets and a CMakeUserPresets template
      • GitHub Windows, Pull request artifacts are built with RelWithDebInfo (#1865 )
      • Added Debian Trixie to PR-builds for early testing

JSON-API

  • Consistent token authorization across sessions and single requests
  • Improved error messages (e.g., JSON parsing, token issues)
  • Random TAN generation per API request (from UI)
  • Configuration requests no longer require a running instance
  • Commands are ignored during shutdown
  • Fixed IPv4-in-IPv6 handling for external connections
  • Fixed admin authentication token validation (#1251)
  • Fixed error on missing effects in builds
  • Corrected mapping type for running instances

🗑️ Removed

JSON-API

  • Removed the ability to disable local admin authorization
    • authorize-adminRequired is now always true
  • Removed: session-updates subscription
  • Deprecated: serverinfo/subscribe
    • Use subscribe / unsubscribe subcommands instead
  • Deprecated: DirectX grabber in favour of the new DXGI DDA grabber
  • Removed "-c" console option on Windows. Hyperion can be started via terminal to get the required console output

Builds

  • Removed builds for following operating system LTS or software component versions, as they are End-of-Life and do not receive maintenance nor security updates any longer
    • Debian Buster
    • Ubuntu Focal Fossa (20.04)
    • Qt5

Hyperion 2.0.16

18 Jan 16:11

Choose a tag to compare

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 2.0.15

19 Feb 18:46
24a00e3

Choose a tag to compare

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

Hyperion 2.0.14

27 Nov 17:32

Choose a tag to compare

Hyperion's November release is not too big, but provides you with the latest updates and fixes.
Many thanks to all contributors providing code (@xkns, @drzony ) or translations.

Added

  • New color processing settings: Saturation gain and brightness/value gain.
    They allow compensating washed out HDR colors on LEDs (#822, #1092, #1142 partially).
  • New languages: Catalan & Greek
  • USB Capture: Support 3D processing for MJPEG
  • Forwarding: Support flat-/proto buffer input
  • Adalight: HyperSerial support (High speed protocol by awawa-dev) and
    support device feedback, show statistics provided by HyperSerial (modified by Lord-Grey) sketch
  • AtmoOrb: Firmware image for Particle/Photon

Changed

  • Serial LED-devices: Ability to select standard Baud rates, as well as defining a custom one
  • LED-devices: Do not switch-off device, if background effect is configured and will kick-in soon

Fixed

  • USB-Grabber: Fixed a SEGFAULT when compiled on Ubuntu Server 22.04
  • USB Grabber: Fixed memory leak when transforming MJPEG
  • ImageResampler: Apply only half crop for 3D to maintain crop ratio
  • Remote Control: Update Color calibration values when calibration settings were saved
  • Fixed Smoothing got out of sync when saving configuration
  • Smoothing: Removed "outputrate" as duplicate to update frequency
  • Queue LED-device on/off signals
  • UI: Correctly lookup current Instance Name
  • Fixed AtmoOrb firmware image

Hyperion 2.0.13

22 May 11:36
5dc696b

Choose a tag to compare

Added

  • Allow to build a "light" version of Hyperion, i.e. no grabbers, or services like flat-/proto buffers, boblight, CEC
  • Allow to restart Hyperion via Systray
  • mDNS support for all platforms inkl. Windows (#740)
  • Forwarder: mDNS discovery support and ease of configuration of other Hyperion instances
  • Grabber: mDNS discovery for standalone grabbers
  • Grabber: Dynamic loading of the Dispmanx Grabber (#1418)
  • Flatbuffer/Protobuf are now able to receive RGBA data
  • Added the instance number as part of the logline (#910). In the UI Log the instance is presented as a readable name.
  • New language: Japanese
LED-Devices
  • Support retry attempts enabling devices, e.g. to open devices after network or a device itself got available (#1302). Fixes that devices got "stuck", if initial open failed e.g. for WLED, Hue
  • New UDP-DDP (Distributed Display Protocol) device to overcome the 490 LEDs limitation of UDP-RAW
  • mDNS discovery support and ease of configuration (Cololight, Nanoleaf, Philips-Hue, WLED, Yeelight); removes the need to configure IP-Address, as address is resolved automatically.
  • Allow to disable switching LEDs on during startup (#1390)
  • Support additional Yeelight models
  • Show warning, if get properties failed (Network devices: indication that network device is not reachable)
  • LED Layout Classic: Support keystone correction via draggable corner LEDs
  • LED Layout Matrix: Support vertical cabling direction (#1420)

Changed

  • Color Smoothing is started in pause mode to save resources, when Hyperion starts with no active source
  • Boblight: Support multiple Boblight clients with different priorities
  • UI: LED Preview has been given a touch of Ambilight.
  • UI: Allow configuration of a Boblight server per LED-instance
  • UI: LED Layout - Removed limitations on indention
  • UI: Log output and LED preview window can be maximized
  • mDNS Publisher: Aligned Hyperion mDNS names to general conventions and simplified naming
LED-Devices
  • Refactored Philips Hue wizard and LED-Device
  • WLED's default streaming protocol is now UDP-DDP. More than 490 LEDs are supported now (requires minimum WLED 0.11.0). UDP-RAW is still supported in parallel (via expert settings).
  • Present all serial/TTY devices during discovery in expert mode; no filtering on existing vendor-identifier (Adalight serial USB does not show up in GUI #1458)

Fixed

  • UI: Ensure all configuration and system info response are there before reloading the page (#1430)
  • UI: Show all previous log lines in the Log UI (was only working for Debug before)
  • UI: Remote control: Treat duration=0 as endless
  • UI: Stop Web-Browser capture when user triggers other activities
  • Effects: Fix image URL in Matrix effect
  • Effects: Fix that start effect is stuck on UI
  • Effects: Fixed that effect specific smoothing setup was not applied when effect is started from available- or effects under configuration
  • Qt-Grabber: Fixed position handling of multiple monitors (#1320, #1403)
  • Standalone grabbers: Improved fps help/error text, fixed default address and port, fixed auto discovery of Hyperion server in hyperion-remote
  • hyperion-remote: Show image filename in UI for images sent
  • Reworked PriorityMuxer and Subscriptions
  • PriorityMuxer: Fix crash when running fore- and background effect in parallel during start-up
  • Update Priority, if first LED changes for COLOR update (to reflect color correctly in UI)
  • Start JSON and WebServer only, if Hyperion's instance 0 is available
  • Treat http headers case insensitive (RFC 2616)
  • Fixed: Signal detection does not switch off all instances (#1281)
  • Do not kill application on SIGILL-signal (#1435)
  • Fixed Qt version override, e.g. set via QTDIR
  • Update jsonschema and checkschema to allow checking hyperion.config.json.default on Windows
LED-Devices
  • Fixes that the Led-Device output flow was interrupted, by an enabling API request on an already enabled device (#967)
  • Yeelight - Workaround: Ignore error when setting music mode = off, but the music-mode is already off (#1372)
  • Fixed: Hue Entertainment mode does not resume after no signal (#930)

Removed

  • UI: Removed sessions (of other Hyperions)
  • Replaced existing AVAHI/Bonjour code by QMdnsEngine

Hyperion 2.0.12

21 Nov 18:38

Choose a tag to compare

Hyperion's November release brings you some new features, removed IPv6 address related limitations, as well as fixing a couple of issues.

Hyperion packages can be installed now under Ubuntu (x64/armhf/arm64) and Debian (x64/armhf/arm64) (incl. Raspberry Pi OS) via our own APT server.
Details about the installation can be found in the installation.md and at apt.hyperion-project.org.

We strongly recommend doing an export of your configuration before migrating to the new version!
You cannot use the new version's configuration database with a previous version.
If you run multiple instances, you unfortunately need to export each individually.

Added

  • New LED-device type: Razor Chroma.
    Note: Due to Chroma Razer API limitations, only one device can be configured.
  • APA102 - Support setting maximum brightness level (1-31)
  • New installation method (Drag'n Drop) for macOS.
  • hyperion-remote & standalone grabbers: IPv6 support
  • New languages: Danish & Hungarian

Changed

  • LED-Devices: Removed IPv6 limitations
  • Philips-Hue Wizard optimizations
  • JSON/Flatbuffer forwarder: Removed IPv6 limitations
  • Allow to import configurations from previous versions
    Note: Existing configurations are migrated to new structures automatically

Fixed

  • Fixed API Subscription (e.g. as used by HomeAssistant) (#1351)
  • Fixed APA102 protocol aligning to the standard defined, removed Latch-Time as not required by APA102 protocol (#1352, #1132)
  • Fixed hyperion-remote when sending multiple Hex-Colors with "Set Color" option
  • UI: Fixed "Selected Hyperion instance isn't running" issue (#1357)
  • Fixed Database migration version handling
  • Fixed Python ModuleNotFoundError (#1109)

Technical

  • Added Qt6 support
  • Migrated to MBEDTSL 3

Hyperion 2.0.0-alpha.11

06 Oct 07:41

Choose a tag to compare

Pre-release

The release is primarily fixing issues introduced with alpha 10, but covering other findings too.
Thanks to everybody highlighting real problem areas, as well as to those proactively providing fixes for integration via pull requests.
Besides bug fixing, you will find some smaller enhancements which make everybody’s life easier.

The fact that WS281x devices must run under root caused many headaches before in getting them running.
We did not weaken security, but provide you with an easy to use script to switch the user-id of hyperion going forward. Furthermore, device configuration is blocked, if the environment does not allow it.

Added:

  • Script to change the user Hyperion is executed with.
    To run Hyperion with root privileges (e.g. for WS281x) execute
    sudo updateHyperionUser -u root

  • Gif effects can source Gifs via URLs in addition to local files as input

  • System info screen: Added used config path and "is run under root/admin"

  • LED-Device enhancements

    • WS281x: Ensure that a device cannot be configured via the UI when Hyperion is not run with root privileges
    • Nanoleaf: Support discovering additional Nanoleaf devices, e.g. Shapes
    • Nanoleaf: Ability to restore state when Hyperion stops streaming

      Note: In case previous state was a dynamic/temporary effect, the state cannot be restored
    • Nanoleaf: New Feature: allow to overwrite brightness by Hyperion

Changed:

  • The Systemd/Upstart/System-V-Init service registers Hyperion under the name hyperion instead of hyperiond, as this has caused confusion among users in the past.
  • WLED and UDP-Raw: Limit maximum LEDs number to 490
  • WS281x: Update DMA default as per rpi_ws281x recommendation
  • Smoothing is paused when no input source is available (to save resources)
  • Disable LED update streaming, if LED updates are not required, Sync. Video-Streaming between Layout and Simulation
  • Load configuration of last instance used when loading the UI page, Streamline API requests to avoid unnecessary invocations (#1311)
  • BobLight: Priorities are not limited any longer. BobLight can feed Priorities [2-253], default is still 128 (#1269)
  • Amlogic grabber: Limit grabber to 30fps during discovery
  • Amlogic grabber: Continuous image feed even when paused (to not have LEDs switched off), plus no delay when pausing/unpausing

Fixed:

  • Fixed that Smoothing with "Continuous Updates" disabled does not provides LED updates (#1068, #1240)

  • Fixed Issue Blinking / flickering cursor with QT screen capture on Windows (#1328)

  • Fixed Colour effect priority is not deleted when Colorpicker is open (double click on delete is required)

  • Fixed reuse local SSDP address (#1324)

  • Exclude FB Grabber on Amlogic platform, as FB is included in Amlogic Grabber

  • Escape XSS payload to avoid execution (#1292)

  • Include libqt5sql5-sqlite packaging dependency

  • Fixed embedded Python location (#1109)

  • LED-Devices

    • Fixed Philips Hue wizard (#1276)
    • Fixed AtmoOrb wizard
    • Fixed that Lightpack device does not core when lack of permissions error (LIBUSB_ERROR_ACCESS)
    • Fixed Atmo/Karate LED count constraint handling
    • Fixed Hue, Disable LED general options (HW Led count & RGB Byte order) as calculated
    • Fixed SPI, Tpm2.Net - Memory issues
    • Fixed: Nanoleaf does not turn on
    • Fixed LED layout - Additional parameters for classic layout were not saved (#1314)
    • Fixed Network LED-Device UI: Trigger getProperties for the configured host, when no hosts were discovered

Removed:

  • Smoothing: Removed "Continuous Updates" flag as it is obsolete.
    In case an LED-device requires continuous updates, use the LED-Device's "Rewrite Time" parameter.