Repository navigation
Releases
Euphoria 2026.11.5
Euphoria 2026.11.5.
Download Euphoria-2026.11.5.dmg below, open it and drag Euphoria onto Applications. The app is signed with a Developer ID and notarized by Apple, so it opens without a warning. Installation has the details. It needs a Mac with Apple Silicon and macOS 15.0 or later.
On Linux, download Euphoria-2026.11.5-x86_64.AppImage, make it executable with chmod +x and run it. The command line tool is in euphoria-2026.11.5-x86_64-unknown-linux-gnu.tar.gz. Both need an x86_64 Linux with glibc 2.35 or later; ldd --version shows yours.
Features
- desktop: Analyze again in the track right-click menu re-runs analysis for the selected tracks (#194)
- desktop: Planner candidate list with one-click audition, draggable B and window markers (#195)
- desktop: Planner transport on the decks engine, in-place stem separation, Back to plan (#186)
- Set stage (warm-up, build, peak) from tempo, loudness and loudness range percentiles, with --stage, filter chips and inspector line (#190)
- desktop: Show embedded cover art and folder images in the inspector, player bar, focus view and decks (#187)
- desktop: Media keys and Now Playing on macOS through MPRemoteCommandCenter and MPNowPlayingInfoCenter (#192)
- desktop: Check by ear tone, piano and chords follow Hear it in another key (#193)
- desktop: Playback tempo control with key lock in the focus header, and metronome clicks locked to the playing track's beat grid (#191)
- desktop: Play chord button for the key's triad in Check by ear (#182)
Fixes
- desktop: Say "to review" under an unsure key or BPM, and drop it once checked (#188)
- desktop: Hide the track player while the decks are open, and say plainly when the decks' sound skips (#185)
- desktop: Label the focus stem rows, one Vocals row from the vocals stem, solo and mute stems by clicking their names (#184)
- desktop: Show each key or tempo once per file in the Write tags preview, and retake the docs screenshots (#183)
Documentation
- accuracy: Publish key and tempo accuracy by genre (#199)
Every change: v2026.11.4...v2026.11.5
Euphoria 2026.11.4
Euphoria 2026.11.4.
Download Euphoria-2026.11.4.dmg below, open it and drag Euphoria onto Applications. The app is signed with a Developer ID and notarized by Apple, so it opens without a warning. Installation has the details. It needs a Mac with Apple Silicon and macOS 15.0 or later.
On Linux, download Euphoria-2026.11.4-x86_64.AppImage, make it executable with chmod +x and run it. The command line tool is in euphoria-2026.11.4-x86_64-unknown-linux-gnu.tar.gz. Both need an x86_64 Linux with glibc 2.35 or later; ldd --version shows yours.
Features
- cli: Review reasons, tempo labels, --bpm/--energy filters and euphoria next from shared core logic (#179)
- desktop: Shared controls module with switch rows, segmented controls and radius, gap and text tokens (#178)
Fixes
- tags: Count Looks right confirmations as high confidence in tag writes, example preview for a missing file (#180)
- cli: Confirm engine/virtualdj exports, tags undo --list/--dry-run, euphoria completions, schema_version (#176)
- desktop: A click on a track only selects it, double-click, Space or the play button plays it (#177)
Every change: v2026.11.3...v2026.11.4
Euphoria 2026.11.3
Euphoria 2026.11.3.
Download Euphoria-2026.11.3.dmg below, open it and drag Euphoria onto Applications. The app is signed with a Developer ID and notarized by Apple, so it opens without a warning. Installation has the details. It needs a Mac with Apple Silicon and macOS 15.0 or later.
On Linux, download Euphoria-2026.11.3-x86_64.AppImage, make it executable with chmod +x and run it. The command line tool is in euphoria-2026.11.3-x86_64-unknown-linux-gnu.tar.gz. Both need an x86_64 Linux with glibc 2.35 or later; ldd --version shows yours.
Features
- desktop: Shared motion module with dialog, strip, focus view and theme fades, and analysis time left (#173)
- desktop: One Key notation setting, a Write tags preview with rules and a counted button, and an In your files box bound to every writing option (#171)
- desktop: Inspector Mixes section follows the playing track with Keep/Lift/Drop energy and reason pills (#169)
- desktop: Hover row actions (play, star, add to set) and a three-step first run card (#167)
- desktop: Easy / Pitch move / Big jump tempo chips, wheel-step relation names and a stems link in the planner and focus plan card (#172)
- desktop: Draw a built set as bars over its energy curve, with summary chips and a details list (#170)
- desktop: Command palette on Command P with key, tempo and energy search and the menu's commands (#168)
- desktop: End tag writes, exports and saves with a toast that offers Undo or Show in Finder (#165)
- desktop: Draw the track's waveform as the player bar's seek bar, with cue letters and section ticks (#166)
- desktop: Collapsible inspector sections with chevrons, auto-open and 180 ms height motion; Deck strip section tabs (#164)
- desktop: Filter bar on the track list for BPM range, quality verdicts and energy range (#161)
- desktop: Play tracks and transitions from the set builder, and lock tracks in place (#162)
- desktop: Needs review chips and an inspector box with a one-click fix per reason (#159)
- desktop: Remove the Quality to check sidebar entry; show Missing files only when a file is missing (#160)
- desktop: Slide the sidebar out and back over 220 ms with a cubic ease-out (#158)
- desktop: Live "In your files" preview in Settings > Writing tags, planned by plan_verified_writes (#155)
- desktop: Remove the Key first theme, load saved key-first settings as Slate (#156)
- desktop: Write key and tempo to files after analysis by default (#153)
- desktop: Setting to write key and tempo into files after analysis, and analysed values suggested in the tag editor (#152)
- desktop: Up and down arrows on the metronome tempo field (#151)
- desktop: Trace the toolbar logo while analysis, tag writing, stems or exports run (#149)
Fixes
- release: Let the notarized command line tool load the libraries Homebrew re-signs (#175)
- desktop: Read the key notation from the one setting in the Next list (#174)
- desktop: Say tags are filled in by default, and what the held-tags strip is waiting for (#163)
- desktop: One preview row per field, and show existing comment text as a placeholder (#157)
- desktop: Remove the "for " button beside Write tags in the toolbar (#154)
Documentation
- accuracy: Show how often the key is exact or a fifth away, the share that mixes (#150)
Every change: v2026.11.2...v2026.11.3
Euphoria 2026.11.2
Euphoria 2026.11.2.
Download Euphoria-2026.11.2.dmg below, open it and drag Euphoria onto Applications. The app is signed with a Developer ID and notarized by Apple, so it opens without a warning. Installation has the details. It needs a Mac with Apple Silicon and macOS 15.0 or later.
On Linux, download Euphoria-2026.11.2-x86_64.AppImage, make it executable with chmod +x and run it. The command line tool is in euphoria-2026.11.2-x86_64-unknown-linux-gnu.tar.gz. Both need an x86_64 Linux with glibc 2.35 or later; ldd --version shows yours.
Features
- release: Sign with Developer ID and notarize with notarytool in the Release workflow (#144)
- core: Detect keys with drone-v2, exact on 69.9% of GiantSteps against 60.6% (#143)
Fixes
- desktop: Clear the "Close the decks" notice when the decks close (#148)
- release: Don't set a Finder flag on the app in the disk image, which breaks strict signature checks (#147)
Documentation
- release: Read the Developer ID certificate's own expiry instead of assuming five years (#146)
Every change: v2026.11.1...v2026.11.2
Euphoria 2026.11.1
Euphoria 2026.11.1.
Download Euphoria-2026.11.1.dmg below, open it and drag Euphoria onto Applications. The app is not notarized, so the first time you open it, right click it in Applications and choose Open. Installation has the details. It needs a Mac with Apple Silicon and macOS 15.0 or later.
On Linux, download Euphoria-2026.11.1-x86_64.AppImage, make it executable with chmod +x and run it. The command line tool is in euphoria-2026.11.1-x86_64-unknown-linux-gnu.tar.gz. Both need an x86_64 Linux with glibc 2.35 or later; ldd --version shows yours.
Breaking changes
- tags: Keep existing keys and tempos, skip low-confidence values and ask before writing while a DJ program runs (#136)
tags writekeeps existing keys and tempos, skips low-confidence values and writes no label with the generic preset unless--overwrite,--include-low-confidenceand--label comment-startare given.
Features
- desktop: Metronome toggle and BPM field in the toolbar, synthesized clicks counted in the audio callback (#140)
- tags: Keep existing keys and tempos, skip low-confidence values and ask before writing while a DJ program runs (#136)
- core: Fit energy weights to listener arousal from DEAM and PMEmo, model version 2 (#135)
- core: Find section boundaries with Foote novelty on chroma, MFCC and level, and label them per track energy (#134)
- core: Choose the tempo among the tempogram's best candidates by mid band onset repeats (#132)
- desktop: Show the Camelot wheel in every theme, the Deck strip and the focus view (#130)
- desktop: Count audio output underruns through an app logger and open the output with an explicit 40 ms buffer (#131)
- desktop: Plan transitions in the focus view with a clash column, a Transition tab and a planner sub-view (#128)
- cli: Euphoria plan ranks 16/32/64 bar transition windows from sections, energy, key and stems (#124)
- desktop: Focus view with stacked lanes, mixes into and plan panels (#126)
- desktop: Export stems, acapella and instrumental as WAV files, also in the shifted key (#123)
- desktop: Label the energy strip and add a vocals lane from the separated vocals stem (#122)
- desktop: Export the library to rekordbox, Traktor, Engine DJ, VirtualDJ and M3U8 from File > Export Library (#112)
- desktop: Mixes well with uses the suggestion filter, and a Cues column in the table (#110)
- Treat moved, deleted or unplugged files as missing in the core, CLI and desktop library (#107)
- Override a track's energy like key and tempo (cache migration 10, corrections export schema 2) (#111)
- Compare the key in TKEY, INITIALKEY and MP4 KEY tags with the detected key and flag conflicts (#105)
- cli: Use the beat grid from a rekordbox collection XML in analyze and export (#109)
- desktop: Write Serato Markers2 and BeatGrid cue markers from the tag-write flow (#106)
- desktop: Filter deck suggestions by tempo and energy range, key relations, genre and favorites pool (#104)
- cli: Keep --json output clean by showing only the count bar (#98)
- cli: Export key, tempo, beat grid and hot cues into an Engine DJ library database (#93)
- cli: Export key, tempo, beat grid, cues and energy into VirtualDJ's database.xml (#85)
- desktop: Draw an energy curve and build a set along it in a Set builder page (#91)
- desktop: Mashup mode on the decks: layering finder with key shift and stem checks, per-stem levels, WAV export (#83)
- tags: Write Serato Markers2 cue points and BeatGrid with tags write --serato-markers (#81)
- app: Star tracks and save favorite transitions in the playlists database (#86)
- cli: Order tracks along an energy curve with euphoria set build (#87)
- desktop: Loop 1 to 16 bars on a deck from its next downbeat (#84)
- cli: Write Open Key codes in the rekordbox export with --key-notation open-key (#89)
- cli: Export key and tempo corrections as JSON Lines (#68)
- Change a track's key by pitch shifting and export the shifted copy (#67)
- desktop: Edit cue points on the waveform (#65)
- Separate tracks into four stems with Demucs htdemucs through ONNX Runtime (#73)
- desktop: Two decks with time-stretched beatmatching, downbeat starts, a mixer and next track suggestions (#60)
- Support ALAC, Ogg Vorbis and MP4 audio (#64)
- cli: Export key, tempo, beat grid and cue points as a Traktor NML collection (#71)
- Build the desktop app on Linux and release an AppImage and CLI tarball (#70)
- research: Validate native CQT inputs for key inference (#75)
- cli: Redesign the analyze output, progress and messages (#58)
Fixes
- release: Grant the Homebrew job read access so GitHub starts the Release workflow (#142)
- Scan keeps going past unreadable folders, flag damaged audio, budget decoded minutes (#137)
- desktop: Show only errors from libraries in the terminal unless EUPHORIA_LOG is set (#141)
- library: Refresh stem plans and skip unchanged Engine DJ exports (#139)
- core: Label a lossless file that rolls off gently as limited bandwidth, not re-encoded, and judge lossy files per channel (#138)
- core: Find cue sections from novelty segments and a drift-tolerant kick, so the Outro follows the last body section (#120)
- desktop: Mix stems frame by frame in playback, play the original file for Full track, add Remove stems (#119)
- desktop: Show good quality in full text and tracks to check in the quiet colour (#118)
- release: Push the Homebrew tap with a Jazz app token scoped to the tap (#117)
- release: Take the cask and formula macOS requirement from the release notes (#114)
- Let the Homebrew publish token write to the tap (#101)
- core: Charge a key-over-time section once and end it at silence (#97)
- desktop: Resolve macOS link errors from prebuilt ONNX Runtime (#95)
- Keep edited cues, beat grids and cued tracks right (#80)
- ci: Sync Cargo.lock and fmt after the feature merges (#78)
- desktop: Show Euphoria on macOS with an explicit desktop package (#74)
- ci: Collect contract and lifecycle context for reviews (#76)
- core: Measure confidence from the final fitted beat grid (#66)
- core: Fit the beat grid's tempo to where the beats of the whole track fall (#61)
- Preserve corrections, playlists and tag undo (#62)
Performance
- stems: Export htdemucs attention one head at a time to lower peak memory (#103)
- stems: Stream separated stems to the cache's WAV files and measure quality, time and memory (#88)
- research: Qualify native CQT and measure composed inference (#77)
- research: Validate bounded native K10 CPU inference (#72)
Documentation
- accuracy: Score section boundaries against SALAMI Internet Archive recordings (#133)
- Install with bre...
Euphoria 2026.11.0
Euphoria 2026.11.0.
Download Euphoria-2026.11.0.dmg below, open it and drag Euphoria onto Applications. The app is not notarized, so the first time you open it, right click it in Applications and choose Open. Installation has the details. It needs a Mac with Apple Silicon and macOS 15.0 or later.
Features
- Edit tag fields across many tracks with find and replace, preview and undo (#57)
- desktop: Build playlists and export them to rekordbox and M3U8 (#54)
- core: Place automatic cue points and export them to rekordbox with --cues (#56)
- app: Check the key by ear and correct the key or tempo (#53)
- core: Detect a beat grid and export it to rekordbox with --beat-grid (#52)
- desktop: Package Euphoria.app and a disk image, and publish releases with a GitHub Action (#48)
- desktop: Review by confidence, show it in the track detail, and choose key display and tempo range (#49)
- Report the sound quality of every track for DJ use (#40)
- Rate key and tempo confidence and let users choose the tempo range (#36)
- app: Show the energy curve, key changes and a full Camelot wheel (#37)
- bench: Score rekordbox's own analysis on the benchmark previews (#35)
- app: Write tags with a preview and undo, show titles and artists, and resize columns (#32)
- app: Browse added folders as a tree and show folders relative to it (#29)
- tags: Correct the DJ program presets and add a rekordbox test kit (#30)
- core: Report tuning and key over time, and correct detuned tracks (#24)
- bench: Score the energy rating against reference ratings (#26)
- app: Fold the sidebar and resize the track detail (#25)
- app: Play tracks and colour the waveform by frequency (#23)
- cli: Write key, tempo and energy into file tags (#22)
- app: Show which tracks are queued and which are being analyzed (#19)
- app: Show the Euphoria icon in the Dock (#18)
- core: Read and write analysis tags with preview and undo (#9)
- cli: Export to rekordbox (#16)
- app: Add the desktop app (#13)
- core: Add an energy rating from 1 to 10 (#14)
- core: Remember analyses in a local cache (#10)
- core: Export rekordbox XML (#8)
- cli: Add euphoria analyze command (#4)
- core: Add harmony module for mixing in key (#7)
- core: Decode audio and detect key and tempo (#1)
Fixes
- core: Claim a key change only on clear evidence (#39)
- tags: Write the energy label into the RIFF INFO comment of WAV files (#41)
- app: Size folder column by rendered path widths (#31)
- core: Refuse files that declare an unusable sample rate (#15)
- cli: Exit quietly when the reader of the output goes away (#12)
Performance
- core: Measure the stereo cutoff of both channels in one FFT (#51)
- core: Analyze tracks faster and with less memory (#17)