v1.17.0

kevinraymond/fosforav1.17.0Jul 24, 2026by github-actions[bot]

AI Summary

Adds a chromatic key detection effect and updates the shader ABI to support new audio features.

Key Highlights

New 'Chromatica' effect visualizing the song's key on a circle of fifths.
New 'audio.key_hue' binding source for key-based coloring.
Shader ABI updated to support new audio features and bindings.

Breaking Changes

Shader ABI updated: particle uniforms grew to 944 bytes, effect uniforms to 432 bytes. Custom shaders need recompiling.

New Features

Chromatica effect with Consonance toggle
audio.key_hue binding source
Shader ABI update for particle and effect uniforms

Full Release Notes


### Added
- **New effect: Chromatica — the screen tunes to the song's key.** Twelve rings on the circle of fifths bloom with the chord being played, and the whole mandala takes the hue of the detected key, with minor keys drooping and cooling. A Consonance toggle strings tension lines between simultaneously sounding notes — warm for a fifth, tense violet for a tritone. A new `audio.key_hue` binding source lets any layer lock its colour to the current key.

## Downloads

| Platform | File | Notes |
|----------|------|-------|
| **macOS** | `.dmg` | Universal binary (Apple Silicon + Intel) |
| **Linux x86_64** | `.tar.gz` | glibc 2.35+ (Ubuntu 22.04+, Debian 12+) |
| **Windows x64** | `.zip` | Windows 10+ |

## Getting started

**macOS**: Open the DMG, drag Fosfora.app to Applications (or run directly). Signed and notarized.

**Linux / Windows**: Extract, run `fosfora` from the extracted directory. The `assets/` folder must be next to the binary.

## Requirements

- **GPU**: Vulkan (Linux/Windows) or Metal (macOS)
- **Audio**: Built-in mic or line-in for audio-reactive visuals
- **NDI®** (optional): [NDI® SDK runtime](https://ndi.video) for network video output
- **Video playback** (optional): `ffmpeg` on PATH for media layers

---
NDI® is a registered trademark of Vizrt NDI AB.