Flux 1.0.1

Flux 1.0.1 — search fixes + contributions welcome

First bugfix release. Spotify and Apple Music song matching is dramatically
better, the sandbox no longer blocks Homebrew tools, and contributions are
now formally welcome.

⚠️ Unsigned build. This DMG is not code-signed or notarized yet —
a Developer ID is not configured. On first launch macOS will block it:

1. Open the DMG and drag Flux to Applications.
2. Right-click Flux in Applications → Open → confirm the prompt.
3. Subsequent launches won't ask.

See docs/RELEASE.md
for the signing roadmap. Updates after this are automatic via Sparkle
(Flux → Check for Updates…, ⌘⌥U).

Install

1. Download Flux-1.0.1.dmg below.
2. Open it, drag Flux to Applications.
3. Right-click → Open the first time, confirm the prompt.
4. Install the required processing tools (if you don't have them):

   brew install ffmpeg yt-dlp vips

Added

• Candidate picker for Spotify / Apple Music. After inspecting a catalog
  link, the "Matched downloadable source" panel now has a Show Matches…
  button. Opens a sheet with up to 10 candidates (5 YouTube, 5 SoundCloud)
  with thumbnails, durations, and channels. Pick any with Use This. A
  "Research a different name" field re-runs the search with custom text.
• SoundCloud as a second search source. Queried in parallel with YouTube
  — often carries exact slowed / remix / sped-up versions YouTube misses.
• Screenshots in the README — two captures wired into the top of the page.
• Pull requests are welcome. See
  CONTRIBUTING.md
  and the PR template.

Fixed

• Spotify inspection on niche tracks. yt-dlp's ytsearch returns zero
  entries for many slowed / remix / niche tracks. The inspector previously
  produced a broken inspection with garbage metadata; it now falls back to
  SoundCloud, which carries the song.
• "None of the processing tools is working" on Release builds. The
  Release configuration had ENABLE_APP_SANDBOX = YES while Debug was NO.
  Sandboxed apps can't stat or invoke Homebrew binaries, so tool detection
  always returned "Not available". Release now matches Debug.
• ytmsearch extractor not found. A previous iteration used
  ytmsearchN: (YouTube Music search), which no longer exists in modern
  yt-dlp. Replaced with ytsearch + scsearch.

Requirements

• macOS Tahoe 26 or later
• Apple silicon
• FFmpeg, FFprobe, yt-dlp (brew install ffmpeg yt-dlp vips)

SHA-256

add3b75cc9f9cdbe1bcdc106ef6e8890195563d89180567955865775ddfdb6b0   Flux-1.0.1.dmg

Changelog

Full changelog: CHANGELOG.md

---

Made for the Mac. Built with care. · fiwlabs.dev

Flux 1.0.0

Flux 1.0.0 — first public cut

Native macOS media workbench. Inspection, conversion, image editing with Apple
Vision background removal, and yt-dlp downloading under one roof. Local-first:
no accounts, no telemetry, no cloud uploads.

⚠️ Unsigned build. This DMG is not code-signed or notarized yet — a
Developer ID is not yet configured. On first launch macOS will block it:

1. Open the DMG and drag Flux to Applications.
2. Right-click Flux in Applications → Open → confirm the prompt.
3. Subsequent launches won't ask.

See docs/RELEASE.md
for the signing roadmap. Updates after this are automatic via Sparkle
(Flux → Check for Updates…, ⌘⌥U).

Install

1. Download Flux-1.0.0.dmg below.
2. Open it, drag Flux to Applications.
3. Right-click → Open the first time, confirm the prompt.
4. Install the required processing tools (if you don't have them):

   brew install ffmpeg yt-dlp vips

Highlights

• Inspect — video, audio, image, GIF; codecs, duration, dimensions, FPS,
  channels, file size
• Convert — video / audio / image transcoding through FFmpeg; MP3, M4A,
  Opus, FLAC, WAV extraction; PNG, JPEG, WebP, HEIC, AVIF, JPEG XL image
  export; palette-based GIF creation; video trimming with resolution / FPS /
  audio / quality controls
• Edit — Apple Vision background removal (on-device); Erase + Restore mask
  brushes; Canvas editor with text, layers, shapes, resize, crop, rotate,
  opacity
• Download — yt-dlp integration with a native UI; link recognition for
  YouTube, Shorts, TikTok, SoundCloud, Spotify, Apple Music (metadata only —
  Flux does not decrypt or rip protected streams)
• Workflow — batch processing with shared settings; reusable export
  presets; persistent jobs queue with plain-English recovery suggestions
• Reliability — pre-flight validation (tools, source/destination, disk
  space, codec/format compatibility, trim ranges, filename safety, collisions);
  atomic output; Foundation.Process argument arrays (no shell strings, no
  injection surface)

Requirements

• macOS Tahoe 26 or later
• Apple silicon
• FFmpeg, FFprobe, yt-dlp (brew install ffmpeg yt-dlp vips)

SHA-256

1198ff010911b0374293c123905cbd8bef3e93db314e08a3ac226af2bbcce35b   Flux-1.0.0.dmg

Changelog

Full changelog: CHANGELOG.md

---

Made for the Mac. Built with care. · fiwlabs.dev