Repository navigation
Releases
ThreadMix 0.3.0
Cleaner mixes: Beatmatch mode now mixes where a song's sections begin, the low end no longer drops out in the middle of a mix, and your music folder is left alone. On Windows, just run the installer over 0.2.0: it offers to remove the old version first (click OK). Your music folder, library, settings and downloaded models are kept.
New
- Your music folder is only read. ThreadMix used to write its library file and a
stemsfolder into your music folder. Now both live in a data folder of their own, which you choose on the welcome screen and can move in Settings > Library. The first scan after updating brings your existing library and stems across, and the DJ says in chat where they went. - Songs are remembered for good. Each song's analysis and stems are filed under a fingerprint of its sound, so moving or retagging a file, adding a second music folder with the same recordings, or starting over with a fresh library brings them back in moments instead of analysing them again. Settings > Library shows what the data folder uses and has Clean up cache, which removes songs that are no longer in your library and says how much it freed.
- Settings > Effects: turn the DJ's effects off one by one, or all of them with one switch. It applies at once, to the set that is playing.
- Keep the bass until the next track's comes in (Settings > Playback, on). When the next song opens without a bass, the playing song's bass and chords now stay until it has its own, instead of leaving at a fixed point and letting the bottom fall out of the mix.
- Let each mix choose its own length (Settings > Playback, on; Beatmatch mode). A mix whose drums hold on both songs may run twice as long as the length you set, and one with a gap in the groove half as long.
- Shift a track's key by a semitone to fit the mix (Settings > Playback, off). Turned on, a song may play a semitone higher or lower when that makes it fit the one before it.
Better mixes
- Beatmatch mode mixes where the music changes. It finds where each song's sections begin and brings the next song in, and takes the old one out, on those lines rather than on any eighth bar.
- The next song starts on the mix point, not a bar after it.
- A steadier lock. A beat the tracker missed can no longer shift a song by a beat against the other one, and the tempo no longer wobbles while two songs play together where the pulse is soft.
- Cleaner sound on most sound cards. Music is stored at 44.1 kHz and most sound cards run at 48; the conversion between the two used to dull the top of the sound and add a faint roughness to cymbals and voices. It no longer does. (Windows and Linux.)
Lighter on your computer
- Analysing your library while a set plays, without a graphics card: the stem separation now uses half the processor cores for as long as a set is playing, and all of them again when it stops. With an NVIDIA card nothing changes; there the two never got in each other's way.
- Stems are written faster after each song is separated, and the separation leaves more of the processor free.
Fixed
- Song titles and artists with accented letters or curly quotes could show as boxes or wrong characters.
- Clean up cache used to change nothing on screen; it now shows what it is doing and what it removed.
Windows: download ThreadMix-Windows-Setup.exe and run it. If Windows says "Windows protected your PC", click More info, then Run anyway. On first launch, choose your music folder and pick which AI models to download.
- Windows 10 or 11, 64-bit. An NVIDIA RTX 20-series card or newer makes the AI parts much faster; without one everything still works, just slower.
- 8 GB of memory to play, 16 GB for the DJ's brain (the language model).
Linux: two downloads. ThreadMix-Linux-Vulkan-x86_64.AppImage runs the DJ's brain and the lyrics on any graphics card with a Vulkan driver (AMD, Intel or NVIDIA) and falls back to the processor without one; ThreadMix-Linux-x86_64.AppImage always uses the processor. Make it executable and start it:
- GNOME (Files): right-click it > Properties > turn on Executable as Program, then double-click it.
- KDE (Dolphin): right-click it > Properties > Permissions > tick Allow executing file as program, then double-click it.
- Terminal:
chmod +x ThreadMix-Linux-*.AppImage && ./ThreadMix-Linux-Vulkan-x86_64.AppImage
Needs a 64-bit PC with Ubuntu 22.04, Linux Mint 21, Debian 12, Fedora 36 or newer, and FUSE (fuse3, already there on current desktops). Stem separation and beat tracking run on the processor in both, so the first scan is slow. If it cannot start, it says why in a window, and in ~/.config/BeatMix/logs/startup-error.txt.
Linux test build (for testers): ThreadMix-Linux-WebGPU-test-x86_64.AppImage is the Vulkan download above with one experiment added: it can run the stem separation on the graphics card. Nothing in it does that unless asked, and it is not yet known to be right or faster on every card. To try it on your machine, make it executable and run ./ThreadMix-Linux-WebGPU-test-x86_64.AppImage --stem-bench /path/to/a-song.mp3 in a terminal (MP3, FLAC, WAV or Ogg; the stem model must already be downloaded in ThreadMix). It separates two minutes of the song on the graphics card and on the processor, and prints how long each took and whether the two agree; send back everything it prints. Everyone else should use the two downloads above.
macOS: there is no new Mac build yet. ThreadMix-macOS.zip is still the Mac version from 0.1.1, with none of the changes above; it keeps its library in your music folder as before. Download it, open it if your browser has not already, and drag ThreadMix into your Applications folder. The app is not signed by Apple yet, so the first time you open it macOS stops it:
- If it says Apple could not verify ThreadMix, click Done, then go to System Settings > Privacy & Security, scroll down and click Open Anyway next to ThreadMix, and confirm.
- If it says ThreadMix "is damaged and can't be opened", it is not damaged: macOS says this about apps that are not signed. Open Terminal and run
xattr -dr com.apple.quarantine /Applications/ThreadMix.app, then open it again.
Needs a Mac with Apple Silicon (M1 or later) and macOS 14 or later.
Source code: ThreadMix-source.zip is the complete source of this version, ThreadMix-macOS-source.zip the source the Mac version was built from, and ThreadMix-Linux-WebGPU-test-source.zip the source of the Linux test build. ThreadMix's own code is under the GNU GPL v2 or later; the app is distributed under the GNU AGPL v3 and its library scanner under the GNU GPL v2. See licenses/THIRD-PARTY.md in the zip, or next to the installed app, for every component.
ThreadMix 0.2.0
A DJ that plans the night: the energy now moves in chapters that are different every time, a new Quick Mix persona, the Festival stage visualizer, and an app that stays light while it plays. On Windows, just run the installer over 0.1.x: it offers to remove the old version first (click OK). Your music folder, library, settings and downloaded models are kept.
New
- A night with a shape, different every time. With no energy arc chosen, the DJ plans the evening in chapters (warm-up, build, peak, breather, wave, lift, cool-down, cruise), choosing each one as the set reaches it and from the music you have left at each energy. The energy view shows the chapters around the track playing.
- Quick Mix, a new persona: runs of short mixes built around each song's chorus, then a few records played long, then back again.
- The Festival stage, a new visualizer: an open-air main stage whose lights, lasers, haze and screens follow the drums, bass, synths and voice of the track, counting down the build-ups and landing on the drop. Settings > Visuals can keep one visualizer on all the time, and has Reduce flashing and Steady camera.
- Your music's worlds are kept apart. Folders and styles that belong together are played together, so a folder of ballroom dance music is no longer mixed in and out of your pop at random, and a waltz is never beatmatched into a 4/4 track. In Settings > Library > Folders, mark a folder to mix freely, keep together, or keep separate (played only when you ask for it).
- Skips and thumbs steer the style: a skip or a thumbs down plays less of that kind of music for the rest of the set, a thumbs up more, and the chat says what it is steering by.
- It remembers earlier sets: what you heard last night is less likely to come back tonight, and an artist rarely comes round again within six tracks.
- The language model is off while the music plays. It still learns each record's era, scene and hook while your library is analysed, but a set no longer loads several gigabytes into memory. The chat, the DJ talking between songs and the lines for the energy chapters come back with Settings > Playback > Use the language model while playing. The music it plays is the same either way. After updating it is off, so turn it on there if you used the chat.
- Pause analysis: a button beside the scan bar while your library is analysed. Pausing frees the processor and graphics card at once; Resume carries on where it stopped.
- Settings in tabs: Library, Playback, Models & voice, Visuals and Advanced.
- Hide info in party mode (bottom bar, or the I key) shows the whole picture.
- The +15s button is gone: click anywhere on the playing track's waveform to jump there. Viz * is now Next Visualization.
Better mixes
- Beatmatch mode mixes in and out at better places. It no longer skips minutes into a record, or leaves one early, for a slightly better drum match.
- Stem moves land on the beat: vocal drops, acapella moments, dub and echo throws start and end on the bar line, and only where the music has room for them.
Fixed
- Party mode on a 4K screen with display scaling ran at a few frames a second. It is smooth again.
- The app opened with a glimpse of the first visualizer before switching to the idle one.
- Linux (already in the Linux download added to 0.1.1 on 12 October): the visualizer stayed black and party mode kept the title bar and panels; the language model took up to twice its size in memory and was reloaded several times during a library scan; and the AI used only four processor threads. The scanner now runs at the lowest priority, so a browser beside it keeps its speed.
Windows: download ThreadMix-Windows-Setup.exe and run it. If Windows says "Windows protected your PC", click More info, then Run anyway. On first launch, choose your music folder and pick which AI models to download.
- Windows 10 or 11, 64-bit. An NVIDIA RTX 20-series card or newer makes the AI parts much faster; without one everything still works, just slower.
- 8 GB of memory to play, 16 GB for the DJ's brain (the language model).
Linux: two downloads. ThreadMix-Linux-Vulkan-x86_64.AppImage runs the DJ's brain and the lyrics on any graphics card with a Vulkan driver (AMD, Intel or NVIDIA) and falls back to the processor without one; ThreadMix-Linux-x86_64.AppImage always uses the processor. Make it executable and start it:
- GNOME (Files): right-click it > Properties > turn on Executable as Program, then double-click it.
- KDE (Dolphin): right-click it > Properties > Permissions > tick Allow executing file as program, then double-click it.
- Terminal:
chmod +x ThreadMix-Linux-*.AppImage && ./ThreadMix-Linux-Vulkan-x86_64.AppImage
Needs a 64-bit PC with Ubuntu 22.04, Linux Mint 21, Debian 12, Fedora 36 or newer, and FUSE (fuse3, already there on current desktops). Stem separation and beat tracking run on the processor in both, so the first scan is slow. If it cannot start, it says why in a window, and in ~/.config/BeatMix/logs/startup-error.txt.
macOS: there is no new Mac build yet. ThreadMix-macOS.zip is still the Mac version from 0.1.1, which already has the Festival stage, the Visuals setting and Hide info, but none of the other changes above. Download it, open it if your browser has not already, and drag ThreadMix into your Applications folder. The app is not signed by Apple yet, so the first time you open it macOS stops it:
- If it says Apple could not verify ThreadMix, click Done, then go to System Settings > Privacy & Security, scroll down and click Open Anyway next to ThreadMix, and confirm.
- If it says ThreadMix "is damaged and can't be opened", it is not damaged: macOS says this about apps that are not signed. Open Terminal and run
xattr -dr com.apple.quarantine /Applications/ThreadMix.app, then open it again.
Needs a Mac with Apple Silicon (M1 or later) and macOS 14 or later.
Source code: ThreadMix-source.zip is the complete source of this version, and ThreadMix-macOS-source.zip the source the Mac version was built from. ThreadMix's own code is under the GNU GPL v2 or later; the app is distributed under the GNU AGPL v3 and its library scanner under the GNU GPL v2. See licenses/THIRD-PARTY.md in the zip, or next to the installed app, for every component.
ThreadMix 0.1.1
Fixes and party-proofing, and a Linux version that works. On Windows, if you have 0.1.0, just run this installer: it offers to remove the old version first (click OK). Your music folder, settings and downloaded models are kept.
Fixed
- Linux: the app opened but could never play anything. It looked for its music scanner next to the downloaded file instead of inside it, so no library was ever built. It also only ran on the newest Linux releases; it now runs on Ubuntu 22.04, Linux Mint 21, Debian 12, Fedora 36 and anything newer.
- The library scan crashed when the music folder's path had letters outside English in it (å, ä, ö, é, Korean, ...).
- One unreadable folder (a network drive that drops, a folder deleted mid-scan) no longer stops the rest of the library being scanned.
- A model download that lost its connection deleted what it had and started over. Downloads now pick up where they stopped and retry by themselves.
- Your chat message reached the DJ twice, which made its answers worse.
- Quitting while the DJ was thinking could take up to a minute. It is immediate now.
New
- Choose where the music plays: Settings > Output. "System default" follows Windows, including when you change it while a set is playing.
- Unplugged headphones or speakers no longer stop the set for good: the music pauses, mid-blend if need be, and carries on from there when the output is back.
- The DJ's brain fits itself to your graphics card. When the language model does not fit in the card's memory, as much of it as fits runs on the card and the rest on the processor, instead of everything slowing to a crawl. On a processor too old for it (no AVX2), the DJ says so and carries on without it, instead of crashing.
- Lighter visuals: they pause while the window is minimised or covered, stop at 60 frames a second, lower their resolution on a slower graphics card, and show simple bars when there is no graphics acceleration or the driver cannot run the full ones.
- The library scan runs at low priority, so the computer stays usable while it works.
- Clearer messages: a folder with no music says so (and which file types are read), and files that cannot be read yet (AAC, M4A, ALAC) are listed in one line instead of failing quietly.
- Settings > Open logs: if something goes wrong, send these files. A crash now leaves a report there, on Windows and on Linux.
Windows: download ThreadMix-Windows-Setup.exe and run it. If Windows says "Windows protected your PC", click More info, then Run anyway. On first launch, choose your music folder and pick which AI models to download.
- Windows 10 or 11, 64-bit. An NVIDIA RTX 20-series card or newer makes the AI parts much faster; without one everything still works, just slower.
- 8 GB of memory to play, 16 GB for the DJ's brain (the language model).
Linux (updated): two downloads. ThreadMix-Linux-Vulkan-x86_64.AppImage runs the DJ’s brain and the lyrics on any graphics card with a Vulkan driver (AMD, Intel or NVIDIA) and falls back to the processor without one; ThreadMix-Linux-x86_64.AppImage always uses the processor. Make it executable and start it:
GNOME (Files): right-click it > Properties > turn on Executable as Program, then double-click it.
KDE (Dolphin): right-click it > Properties > Permissions > tick Allow executing file as program, then double-click it.
Terminal: chmod +x ThreadMix-Linux-*.AppImage && ./ThreadMix-Linux-Vulkan-x86_64.AppImage
Needs a 64-bit PC with Ubuntu 22.04, Linux Mint 21, Debian 12, Fedora 36 or newer, and FUSE (fuse3, already there on current desktops). The Linux version was built later than the Windows one and also has the Festival stage visualizer, the Visuals setting and Hide info in party mode. Also new on Linux: the visualizer works on AMD and Intel graphics (it stayed black there), party mode goes properly full screen, the language model uses about 40% less memory and all the processor’s cores, and the library scan gives way to other programs such as your browser. ThreadMix-Linux-source.zip is the source it was built from.
macOS (new): download ThreadMix-macOS.zip, open it if your browser has not already, and drag ThreadMix into your Applications folder. The app is not signed by Apple yet, so the first time you open it macOS stops it:
- If it says Apple could not verify ThreadMix, click Done, then go to System Settings > Privacy & Security, scroll down and click Open Anyway next to ThreadMix, and confirm.
- If it says ThreadMix "is damaged and can't be opened", it is not damaged: macOS says this about apps that are not signed. Open Terminal and run
xattr -dr com.apple.quarantine /Applications/ThreadMix.app, then open it again.
Needs a Mac with Apple Silicon (M1 or later) and macOS 14 or later. The Mac version was built a little later than the others and also has the Festival stage visualizer, a Visuals setting to keep one visualizer on all the time, and a Hide info button in party mode for the whole picture.
Source code: ThreadMix-source.zip is the complete source of this version, and ThreadMix-macOS-source.zip the source the Mac version was built from. ThreadMix's own code is under the GNU GPL v2 or later; the app is distributed under the GNU AGPL v3 and its library scanner under the GNU GPL v2. See licenses/THIRD-PARTY.md in the zip, or next to the installed app, for every component.
ThreadMix 0.1.0
The first public version of ThreadMix Auto DJ: a DJ that runs itself.
Windows: download ThreadMix-Windows-Setup.exe and run it. If Windows says "Windows protected your PC", click More info, then Run anyway. On first launch, choose your music folder and pick which AI models to download.
- Windows 10 or 11, 64-bit. An NVIDIA RTX 20-series card or newer makes the AI parts much faster; without one everything still works, just slower.
- 8 GB of memory to play, 16 GB for the DJ's brain (the language model).
macOS: coming soon.
Source code: ThreadMix-source.zip is the complete source of this version. ThreadMix's own code is under the GNU GPL v2 or later; the app is distributed under the GNU AGPL v3 and its library scanner under the GNU GPL v2. See licenses/THIRD-PARTY.md in the zip, or next to the installed app, for every component.