Keyboard Shortcuts and HUD

⌨️ Keyboard Shortcuts & Diagnostic HUD

Flux offers comprehensive keyboard control for instant playback manipulation, alongside a dedicated Playback Tuning & Diagnostic HUD for technical telemetry and fine-tuning.

---

1. Complete Keyboard Shortcuts Reference

Press ⌘ + / anytime inside Flux to open the interactive shortcuts reference sheet.

🎬 Playback Controls

Shortcut	Action	Description
Space	Play / Pause	Toggle video playback.
← / →	Seek 10s	Jump 10 seconds backward or forward.
⇧ + ← / ⇧ + →	Seek 1 Minute	Large 60-second backward or forward jump.
↑ / ↓	Volume Up / Down	Adjust audio volume in 5% increments.
M	Mute / Unmute	Toggle audio output mute.
F	Fullscreen	Toggle full-screen mode.
S	Cycle Subtitles	Switch between available subtitle tracks or turn off.
A	Cycle Audio	Switch between alternative audio and commentary tracks.
O	Stream Sources	Open stream picker sheet to choose a different resolution/source.
C	Toggle Controls	Instantly hide or show onscreen playback controls.
Esc	Dismiss / Exit	Exit fullscreen or dismiss active sheets.

🧭 Navigation & Global Shortcuts

Shortcut	Action	Description
⌘ + 1	Home	Navigate to the main discovery feed.
⌘ + 2	Movies	Open the Movies catalog.
⌘ + 3	TV Shows	Open the TV Shows catalog.
⌘ + 4	Trending	Open the Trending / Popular feeds.
⌘ + F	Search	Jump directly into the high-speed search bar.
⌘ + R	Hard Refresh	Purge in-memory metadata caches and re-fetch discovery rails.
⌘ + ,	Settings	Open Flux Preferences.
⌘ + /	Shortcuts Sheet	View onscreen shortcuts modal.
⌘ + W	Close Window	Close active video player or modal window.
⌘ + Q	Quit Flux	Safely shutdown FluxEngine daemon and quit.

---

2. Secret Player Diagnostic HUD ("Stats for Nerds")

During video playback, click the Tuning slider icon (🎛️) in the playback bar to open the Secret Player HUD.

The HUD is organized into 4 diagnostic and calibration panes:

1. Stats for Nerds (chart.xyaxis.line)

• Real-Time Framerate: Current FPS and dropped frame counters.
• Hardware Decoder: Confirms whether Apple Silicon VideoToolbox (videotoolbox-copy) is actively decoding the stream.
• Demuxer Cache Health: Live measurement of audio/video buffer lead time (in seconds and megabytes).
• Stream Bitrate & Dimensions: Exact incoming bitrate, codec profile, audio sample rate, and container format.

2. Subtitles Calibration (captions.bubble.fill)

• Subtitle Delay Adjustment: Fine-tune subtitle timing in seconds or milliseconds (e.g. +250ms or -500ms) to eliminate lip-sync drift.
• Font Scaling: Dynamically increase or decrease subtitle font size on screen.
• Vertical Positioning: Move subtitles higher or lower to avoid letterbox bars.

3. Audio Sync & Boost (waveform)

• A/V Sync Offset: Correct delayed audio tracks by adding or subtracting millisecond offsets.
• Dialogue Normalization: Boost vocal frequencies in quiet dialogue scenes while clamping explosive action sequences.
• Volume Boost: Amplify quiet audio tracks up to +200%.

4. Video Filters & Shaders (slider.horizontal.3)

• Deband Shader: Eliminates color banding and compression artifacts in dark scenes.
• Aspect Ratio Overrides: Switch between 16:9, 21:9 (ultrawide anamorphic), 4:3, or stretch-to-fit.
• Color Grading: Adjust brightness, contrast, saturation, and gamma curves directly on the GPU.