Home

Welcome to the Flux Documentation & User Wiki

Flux is an open-source, high-performance native macOS media center and streaming client designed exclusively for Apple Silicon. Built using pure SwiftUI and AppKit, Flux combines the full power of the open Stremio Addon ecosystem with the speed, low memory overhead, and visual elegance of native macOS Liquid Glass.

---

🧭 Wiki Table of Contents

Navigate through the official documentation below to learn how to configure, customize, and get the most out of Flux:

Documentation Guide	What You'll Learn
⚙️ Settings Guide	In-depth walkthrough of every toggle, picker, and slider across all 5 Settings tabs.
⚡ Streaming & Playback	How Flux Mode autonomous stream racing works, hardware acceleration, and audio passthrough.
🧩 Addons Guide	Installing Stremio community addons, debrid integrations, and subtitle providers.
👥 Profiles & Parental Controls	Multi-profile management, 3D avatars, Cloud Sync, and PIN-protected Kids Mode.
⌨️ Keyboard Shortcuts & Diagnostic HUD	All playback hotkeys and accessing the Secret Player Diagnostic HUD.
🛠️ Installation & Troubleshooting	macOS 26+ vs macOS 15+ editions, Gatekeeper verification, and common solutions.

---

🌟 What Makes Flux Different?

Unlike web-wrapped media players (such as Electron or Qt web shells), Flux is built from the ground up for macOS:

1. 100% Native Interface: Every window, sidebar, modal, and card is rendered using native AppKit and SwiftUI components with genuine macOS Liquid Glass materials.
2. Hardware-Accelerated libmpv Core: Video rendering runs on an isolated CAOpenGLLayer powered by libmpv with Apple Silicon VideoToolbox decoding, supporting 4K HDR, Dolby Vision, and AV1 playback.
3. Autonomous Stream Racing (Flux Mode): Instead of manually testing broken torrent links or waiting on sluggish swarms, Flux pings and tests candidate streams simultaneously in the background, starting playback on the fastest healthy source within seconds.
4. Cloud Synchronization: Built-in PocketBase synchronization seamlessly backs up and syncs your profiles, watchlists, continue-watching states, and playback history across all your Mac devices.
5. Dynamic 10-Language Matrix: Full localization across English, Japanese, Spanish, French, German, Italian, Portuguese, Korean, Hindi, and Chinese with real-time UI language switching.