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:
- Open the DMG and drag Flux to Applications.
- Right-click Flux in Applications → Open → confirm the prompt.
- 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
- Download
Flux-1.0.1.dmgbelow. - Open it, drag Flux to Applications.
- Right-click → Open the first time, confirm the prompt.
- 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
ytsearchreturns 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 hadENABLE_APP_SANDBOX = YESwhile Debug wasNO.
Sandboxed apps can't stat or invoke Homebrew binaries, so tool detection
always returned "Not available". Release now matches Debug. ytmsearchextractor not found. A previous iteration used
ytmsearchN:(YouTube Music search), which no longer exists in modern
yt-dlp. Replaced withytsearch+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