Repository navigation
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.