Skip to content

Releases: OpticMystic/XZ-Mods

XZ Mods 0.3.0-preview.13 tester beta

Pre-release

Choose a tag to compare

@OpticMystic OpticMystic released this 16 Oct 11:52

XZ Mods 0.3.0-preview.13 beta

Beta software. Back up your USB and test before a set. Stable remains 0.2.1.

Windows 10/11 x64. XDJ-XZ firmware 1.26.

Screenshots, download and installation instructions

Windows app and USB setup

  • A redesigned app with four sections: USB, Stems, XZ Screen and Tools.
  • Automatic USB detection, a read-only file tree, and a setup flow that previews loader changes before writing.
  • DJ Profile, Repair library, mod-version selection, loader backups and app updates are grouped in Tools.
  • Beta update checks run automatically at launch. Signed updates install from the app and reopen it when finished.
  • Choose and keep a specific controller build, with local archives and a loader restore option.

Waveforms and stem controls

  • 3-band waveforms display lows, mids and highs in blue, amber and white.
  • 3-stem waveforms display drums, harmonics and vocals as separate colored layers.
  • Stem controls have full-height and compact sizes, positions below or outside the waveforms, and a hidden layout.
  • Key feedback shows the original key, playing key and cents as the tempo changes.

MODS menu and DJ profiles

  • The redesigned MODS menu has a section rail and a help panel for the selected control.
  • The MODS header displays the active DJ profile with its name and logo.
  • The Windows app provides a DJ profile editor and a profile-track export for rekordbox.

Stem preparation

  • A single Stems page with track search, filters, track details and per-track preparation progress.
  • Balanced, Fast and Light preparation options, with storage estimates, cancellation and retry.
  • Stem preparation from MP3, WAV and FLAC sources, including 24-bit and floating-point audio.
  • Import external stem files or ZIP sets, assign their roles and check alignment against the exported track.
  • Prepared bundles include stem waveform data for the controller’s stem view.

Live screen and OBS

  • XZ Screen displays a read-only view of the controller and provides a local Browser Source URL for OBS.
  • Choose 16-bit color or an 8-bit, 256-color view at the controller’s full screen resolution. The rate badge shows the measured frame rate.
  • The preview reconnects after a lost connection and clears disconnected images.

Library repair

  • Repair supported rekordbox Device Library errors caused by broken playback-history chains or invalid data in unused catalog pages.
  • Repairs include catalog backups and an undo option, while preserving track IDs, playlists and prepared stems.
  • Changed USBs, stale inspections, unsupported damage and an open rekordbox session block a repair.

Fixes

  • Corrected MP3 stem timing so prepared stems follow the player’s track timeline. Older affected bundles are marked for preparation again.
  • Corrected sample decoding when importing variable-bitrate MP3 stems.
  • Corrected stem-control state when a newly loaded track replaces the previous track.
  • Prevented browsing another USB from silently replacing the active settings profile.
  • Improved compatibility with older saved settings when updating a loader or switching mod versions.
  • Windows app upgrades now back up the previous bundled resources before installing the replacement.
  • Library repair now includes transaction journals in its backups and checks for changes before repair or undo.

Beta notes

  • Key Sync off controls, including SHIFT + SYNC and Master Tempo, still need confirmation on an XDJ-XZ running this loader.
  • Controller changes require updating the USB loader. Updating the Windows app alone does not change it.

XZ Mods 0.3.0-preview.11 — Tester beta

Choose a tag to compare

@OpticMystic OpticMystic released this 16 Oct 09:38

XZ Mods 0.3.0-preview.11 tester beta

This is a prerelease for testers. Stable remains 0.2.1. Extended controller qualification is pending.

Windows 10/11 x64. XDJ-XZ firmware 1.26. No matching Mac beta is included.

Full changelog and tester instructions: https://beta.xzmods.com/

A simpler desktop app

  • The sidebar has four places: USB, Stems, XZ Screen and Tools. DJ Profile, Repair library, Network updates, XZ Mods version, App updates and About live in Tools.
  • Plug in a USB and the app detects it. The USB page shows one status and action, your DJ profile, games and stems, and a read-only file tree.
  • USB installation and updates use a short flow with an optional DJ profile, a review of planned writes and read-back verification. Existing music, playlists and prepared stems are preserved.
  • Windows upgrades archive the complete previous resource folder, including runtime helpers and caches. Mod versions have immutable local archives, paired runtime/receiver files and an optional pin across network updates.
  • Older settings can be adapted with a backup when switching builds. The existing loader backup and restore path remains available.

Stem preparation and playback

  • Balanced stem separation uses Mel-Band RoFormer vocals and fine-tuned Demucs drums, with GPU acceleration when available. Fast and Light presets are also offered. The earlier Vocal focus preset is retired.
  • The stem page has one selection and preparation bar, storage estimates, filters, search, track details, per-track progress, cancellation and retry. Verified bundles can be reused.
  • Engine setup checks the computer, recommends a quality, downloads the engine and tests it on 30 seconds of your music before the first batch.
  • Prepare from MP3 exports and 24-bit, float or other-rate WAV and FLAC. MP3 decoding retains the player timeline; older MP3 bundles are marked for preparation again. Direct AIFF and AAC source preparation is not supported.
  • Import external stems or ZIP sets, assign roles and check alignment with the USB track. A vocals/instrumental pair can continue after engine setup.
  • Bundles include per-stem waveform analysis for scrolling and overview strips. Existing XZ Mods bundles can gain waveforms without separating again. Imported VBR MP3 stems are decoded in one read.
  • Adds OverCue OVPGZ004 44.1 kHz FLAC playback alongside earlier zlib and 96 kHz FLAC sets. Checks include decoded pages, full PCM hashes and source identity.
  • Adds experimental AZ MODS and RX3 prepared-stem compatibility, including a bass role on four-stem tracks. Mismatched sets fall back to original audio. Physical-controller acceptance is pending.
  • Fixes a track-generation race where a physical stem pad could change audio levels before the renderer reconciled the new track. The engine reset, generation publication and controls now share synchronization. Audible controller verification remains open.

DJ profiles and saved settings

  • Create a DJ profile with a name, tagline and logo. Include it during USB setup, edit it later, or export a silent profile track for rekordbox with embedded logos and a silence check.
  • The native MODS header displays the active DJ profile. Switch USB profiles, edit a profile on the player and recognize named DJPROFILE folders using the USB rekordbox color when no profile color is set.
  • Browsing another USB no longer restores its settings automatically or silently transfers an established profile save destination. Boot restoration and explicit profile actions remain available.
  • Queued edits retain their proven settings owner. Blank USB targets require an unowned profile or an explicit Apply+Save action. After a USB remount, saves remain local until reboot or explicit ownership is established.
  • Current 515-byte default settings profiles are accepted during loader updates and build switches. Records over the parser limit are left untouched.

Live Streamer and OBS

  • XZ Screen previews the controller and supplies a local OBS Browser Source URL. The controller endpoint is read-only; stale pictures clear on disconnect and the app reconnects automatically.
  • The lossless RGB565 path targets 30 fps with bounded delivery and GPU drawing. The rate badge shows measured frames. A PC replay reached 30 fps; this is not a measured XDJ-XZ frame rate.
  • An experimental full-resolution RGB332 mode sends 384,000 bytes per frame using a fixed 256-color palette. Original 16-bit streaming remains selectable, and older loaders keep their working preview.
  • Slow controller captures use a bounded five-second receive/stall budget. A shared three-second frame expiry keeps the desktop and OBS picture visible during variable capture timing; closed sockets clear the image immediately.
  • An optional saved USB-browsing cover replaces unrecognized screens with the XZ Mods logo before sending frames or still images to OBS. Recognized stock performance screens return automatically. Menus and custom themes remain covered; physical privacy acceptance is pending.

Library repair and other tools

  • Repair library handles supported blank-page interruptions in Device Library playback-history chains, with track IDs, playlists and prepared stems preserved.
  • Clears invalid data in unused Device Library pages. This correction restored the tested XZME library in Windows rekordbox. Active pages and file length stay unchanged.
  • Backs up the catalog and OneLibrary transaction journals, refuses stale inspections, changed USB identities, unsupported damage and repairs while rekordbox is open, and supports exact undo while the catalog is unchanged.
  • Game choices share one catalog and one USB write flow. A USB without a loader defaults to supported free games; an existing loader keeps its selections. My House was removed because the required native GZDoom port is not qualified.
  • The macOS source filters to local disk volumes, improves controller network address defaults, uses native fonts and points App updates to downloads. These source changes do not imply a matching Mac beta binary is available.

Controller changes

  • Wave Rider is now hill surfing. The loaded track's waveform becomes the hills, and two players can ride co-op or versus on the two jogs.
  • Small jog turns now tilt the Wave Rider ship instead of spinning it, and CUE adds weight on the slopes. SPIN LIFT is an optional quick jog spin near a crest.
  • SHIFT + SYNC shifts the key of a deck to match the master deck. KEY SETUP checks both tracks and the master before it turns on.
  • The USB track list shows each track's key before its title. Green fits the master deck. Amber fits but is detuned.
  • Experimental. With rekordbox in PERFORMANCE mode on a computer, the onscreen stem buttons switch that track's stems. Showing the computer track's 3-band waveform on the XZ needs a companion program on the computer and the XZ network connection. It was seen once in a test capture and has not been confirmed by watching a deck.
  • Muting stems on both decks does less audio work per block. This targets the distortion heard when muting stems on two decks. It is not yet confirmed on an XZ.
  • RAM TRACKS copies the playing track into memory, with its prepared stems when there is room, so it keeps playing after USB STOP. One track per deck, up to 64 MB. This is experimental. Keeping the title and waveform on screen after the USB leaves is not confirmed yet.
  • RHYTHM LAB adds ten short rhythm studies by VJ OpticMystic for the jogs and pads. They are prototypes, and you can rate each one.
  • STATIC SURFER is a rhythm platformer by VJ OpticMystic. Tap to jump and tilt the jog to pass through the glyphs.
  • The jog now sets the Wave Rider board's angle. Nose down gains speed and nose up launches. You can calibrate your jog and remap the action button.
  • Pick a color for drums, harmonics and vocals, or let the theme choose. Drums are now blue and harmonics red by default. Stem rows, pad lights and the STEMS waveform all follow the choice.
  • The STEMS button cycles five stem row layouts. Rows can be full or half height, below the waveforms or at the outer edges, or hidden. Each stem button fills left to right with its level.
  • Each deck shows its original key, playing key and cents in the beat countdown area. Linked decks show MASTER and SYNC. Turn KEY FEEDBACK off to get the stock countdown back.
  • SORT and COLUMN sit above the USB track list and open the native sort menu. KEY FORMAT picks Classic or Camelot keys and is saved on each USB.
  • APPS runs XZ SDK apps from the USB, when you tap RUN or each time the USB goes in. DJ controls keep working while an app runs.
  • Changing stem rows or stem levels no longer freezes BROWSE.
  • Every MODS page has a BACK button, and the physical BACK button steps back one page.
  • MODS works without the touchscreen. The REKORDBOX key opens and closes it, the browse encoder moves between controls and a push selects. Turn REKORDBOX KEY off to get the stock key back.
  • The MODS menu has a section rail on the left and an info box that explains the selected control and shows whether your change was saved.
  • Spin the jog in the air to flip the Wave Rider board, then land level to bank flips and crests. Three perfect landings in a row light a rocket. Three new worlds use VJ OpticMystic's artwork.
  • The Wave Rider board answers the jog faster in the air, and spinning back brakes it sooner.
  • Pressing MASTER TEMPO while Key Sync is on returns that deck to its original key. Master Tempo stays on, and the next press works as stock.
  • Wave Rider has EASY, NORMAL and HARD. EASY is the default and holds the air angle you set. Clean landings show the points they earned.
  • METRICS shows CPU, RAM and chip temperature next to STEMS and MODS. It is off by default. The temperature turns yellow at 80 C and flashes red at 90 C.
  • Pulling the USB, or loading one without settings, keeps your current settings. The XZ remembers...
Read more

XZ Mods 0.2.1 hotfix for 0.2.0

Choose a tag to compare

@OpticMystic OpticMystic released this 03 Oct 01:28

New features

  • XZ Mods 0.2.1 is the hotfix for 0.2.0. Use this desktop preparation tool for new loaders and existing-loader updates.
  • Includes the 0.2.0 feature set: FLAC stems, selected-track batches, layered waveforms, Beat Arcade, Wave Rider and game downloads.

Bug fixes

  • Corrects the old 0.1.9 labels in the bundled app so its version is correct before the startup check finishes.
  • Identifies the hotfix consistently in the app, Python backend, signed updater feed and website.

Other changes

  • The paired controller runtime is the same verified payload shipped with 0.2.0. This hotfix updates the desktop package and version labels.
  • Installing this app does not change your USB. Prepare or update its loader separately when ready.
  • A portable folder is not replaced by the Windows installer. After installing, open XZ Mods from the desktop shortcut; to stay portable, replace the folder with the current ZIP.
  • Mac previews remain ad-hoc signed and not notarized. My House still requires a qualified native GZDoom port.

XZ Mods 0.2.0

Choose a tag to compare

@OpticMystic OpticMystic released this 02 Oct 23:37

New features

  • Apple Silicon and Intel Mac utilities for macOS 14 or later. Apple Silicon can generate stems; both architectures can import stems and use USB, settings, waveform and game tools.
  • Read the new OverCue OVPGZ003 FLAC stem pages alongside existing OVPGZ001 zlib pages. Generate and import now write FLAC pages and verify all seven playback mixes.
  • Prepare selected tracks as a batch, reuse verified stems, see each track's progress, cancel safely, and retry failed tracks.
  • Layered Vocals, Drums and Harmonics waveforms with a live playhead, plus a backed-up 3-band waveform preparation tool.
  • Beat Arcade rhythm games and Wave Rider, a jog-wheel game driven by the loaded track's real waveform. Open them when wanted through MODS > Extras > Games.
  • Games setup downloads Doom shareware, Chex Quest and Freedoom, checks the downloads, and prepares supported data on the selected USB. Bring your own licensed commercial IWAD.

Bug fixes

  • Disk-backed audio processing bounds whole-track memory instead of loading long tracks and seven mixes into RAM.
  • CPU Vocal focus reduces attention memory; long FLAC source inspection uses bounded reads.
  • Improved native waveform refresh and theme rendering while preserving deck transport and existing stem controls.
  • Beat Arcade and Wave Rider stay closed during normal startup. The automatic game opening switch is only a local test option.

Other changes

  • Installing or updating the desktop app does not update an existing controller USB. Open USB loader and use Back up and update loader to install the matching runtime.
  • Mac packages use an ad-hoc signature and are not notarized. Follow the Mac setup instructions before opening the downloaded utility.
  • The newest native runtime remains experimental. Physical game-control feel, real-song phase alignment and extended two-deck cold-boot qualification are still pending. MyHouse stays visible as unavailable until native GZDoom support is qualified.

XZ Mods 0.1.10

Choose a tag to compare

@OpticMystic OpticMystic released this 02 Oct 22:58

New features

  • Apple Silicon and Intel Mac utilities for macOS 14 or later. Apple Silicon can generate stems; both architectures can import stems and use USB, settings, waveform and game tools.
  • Read the new OverCue OVPGZ003 FLAC stem pages alongside existing OVPGZ001 zlib pages. Generate and import now write FLAC pages and verify all seven playback mixes.
  • Prepare selected tracks as a batch, reuse verified stems, see each track's progress, cancel safely, and retry failed tracks.
  • Layered Vocals, Drums and Harmonics waveforms with a live playhead, plus a backed-up 3-band waveform preparation tool.
  • Beat Arcade rhythm games and Wave Rider, a jog-wheel game driven by the loaded track's real waveform. Open them when wanted through MODS > Extras > Games.
  • Games setup downloads Doom shareware, Chex Quest and Freedoom, checks the downloads, and prepares supported data on the selected USB. Bring your own licensed commercial IWAD.

Bug fixes

  • Disk-backed audio processing bounds whole-track memory instead of loading long tracks and seven mixes into RAM.
  • CPU Vocal focus reduces attention memory; long FLAC source inspection uses bounded reads.
  • Improved native waveform refresh and theme rendering while preserving deck transport and existing stem controls.
  • Beat Arcade and Wave Rider stay closed during normal startup. The automatic game opening switch is only a local test option.

Other changes

  • Installing or updating the desktop app does not update an existing controller USB. Open USB loader and use Back up and update loader to install the matching runtime.
  • Mac packages use an ad-hoc signature and are not notarized. Follow the Mac setup instructions before opening the downloaded utility.
  • The newest native runtime remains experimental. Physical game-control feel, real-song phase alignment and extended two-deck cold-boot qualification are still pending. MyHouse stays visible as unavailable until native GZDoom support is qualified.

XZ Mods 0.1.9

Choose a tag to compare

@OpticMystic OpticMystic released this 28 Sep 11:08

Download Windows installer · Portable ZIP

For XDJ-XZ firmware 1.26. After updating the app, use USB loader → Back up and update loader to update your controller USB.

New features

  • Native player artwork for the Game Boy, Super Nintendo, Windows 95, Game Boy Color, Aqua and DMG theme families.
  • Dedicated Glass panels with readable data wells and clearer focus states.
  • Separate green LCD waveform areas for DMG, and theme-specific title bars for Windows 95, RPG, Aqua and DMG.

Bug fixes

  • More saturated LCARS orange and violet, connected panel rails, and corrected deck-2 title colors.
  • Fixed title text contrast and antialiasing against each theme's background.
  • Preserved stronger waveform and cue colors instead of washing them toward the text color.
  • Reduced oversized Glass menu capsules and overpowering background gradients.
  • Kept cue regions, playheads, tempo readouts and transparent artwork masks protected.

Other changes

  • After installing, use USB loader > Back up and update loader to put these changes on an existing USB. Installing the app alone does not update the controller loader.
  • Theme IDs and saved selections are unchanged.

Verified: portable native renderer tests, AddressSanitizer/UndefinedBehaviorSanitizer integration, ARM build and isolated controller tests, and bounded ARM waveform benchmarks. Live visual acceptance of every new theme is still pending. The controller USB was not rewritten during development.

XZ Mods 0.1.8

Choose a tag to compare

@OpticMystic OpticMystic released this 28 Sep 09:59

Download Windows installer · Portable ZIP

For XDJ-XZ firmware 1.26. After updating the app, use USB loader → Back up and update loader to update an existing USB.

New features

  • Install XZ Mods with the Windows installer, or download the optional portable ZIP.
  • The app checks for updates at startup. Review the release notes, then download and install a signed update.
  • Update an existing USB loader with a backup and restore option, and edit the settings saved on your USB.
  • Use 24 controller themes with consistent MODS menu positions and a top-right Close button.
  • Customize four backward/forward Beat Jump pairs on each of two pages under Controls. Hold Shift and tap Beat Jump for page 2.
  • Page 2 is enabled by default with 16, 32, 64 and 128 beats. Labels show both beats and bars; red/orange pad shades identify the second page.
  • Assign stem shortcuts through an eight-pad diagram in Controls.
  • Browse the Rekordbox USB library with automatic drive selection, free space and stem status. Generate stems with Open-Unmix HQ or Vocal focus.
  • Import multiple instrument stems, assign them to Drums, Vocals or Harmonics, and combine them into OverCue files for an exported track.

Bug fixes

  • Fixed track-title contrast in LCARS and Analog themes.
  • Keep theme, pad and Beat Jump settings saved between controller restarts when the settings USB is writable.
  • Fixed the narrow, vertically wrapped Prepare a new USB card and rewrote the app instructions.
  • Fixed Open-Unmix model loading and Vocal focus processing on Windows CPUs.
  • Allow exFAT music libraries in the stem browser and importer, separately from boot-loader requirements.

Other changes

  • Removed the 3-band waveform, DJ branding and VJ.Tools pages from the Windows app.

The standalone new-track export prototype passed a user controller test. It is not yet connected to the app interface and is not included as an app feature in this release.

XZ Mods 0.1.5

Choose a tag to compare

@OpticMystic OpticMystic released this 25 Sep 23:59

XZ Mods 0.1.5

Plug in a FAT/FAT32 USB, open Prepare USB, click Choose USB and prepare loader, and select the USB root. XZ Mods downloads and checks the official XDJ-XZ 1.26 firmware and boot support, builds the loader, verifies the encrypted image, and writes autoexec.bin to the USB root. The app preserves existing music and refuses to replace an existing loader.

The first run downloads about 330 MB. Later builds reuse verified local downloads. Local firmware and staging-folder workflows remain under Advanced options. The Windows ZIP includes the app and runtime; VJ.Tools and a developer Python installation are not required.

Verification before publication covered manufacturer downloads against pinned hashes, fresh packaged boot-support extraction, a complete image build and decrypt round trip, backend checks, toolkit tests, ZIP integrity, and launch of the packaged Windows app. After publication, the user successfully prepared a USB with 0.1.5 and cold-booted an XDJ-XZ with MODS running from that USB. This confirms the loader path on that setup. Extended two-deck performance, every display style, and experimental Gate Cue, Smart Cue, Groove, and X-PAD behavior remain separate qualification work.

Firmware 1.26 is the only supported target. The loader runs in RAM and does not flash the XZ firmware. The public ZIP excludes firmware, boot-support files, and generated personal images.
The ZIP keeps its original preview filename so its published checksum and the exact tested bytes stay unchanged. GitHub now marks v0.1.5 as the stable Latest release; experimental controls retain their separate readiness limits.

XZ Mods 0.1.3 developer preview

Pre-release

Choose a tag to compare

@OpticMystic OpticMystic released this 25 Sep 20:12

Known startup issue: the Windows-generated artwork checksum list can stop this loader before MODS appears. A corrected 0.1.4 package is undergoing independent boot verification.

XZ Mods 0.1.3 updates the Windows USB builder to the runtime tested on the XZ.

  • Separate, taller Vocals / Harmonics / Drums / Bypass rows beneath both native waveforms.
  • Tap to mute and slide horizontally to adjust a stem's volume.
  • Simpler MODS navigation and twelve display styles, including Game Boy, SNES, Windows 95, Game Boy Color and Aqua / iTunes.
  • Correct bright/dim physical pad feedback, pure green/blue/red colors and both A–D/E–H banks.
  • XZ Mods loading artwork applied automatically to a validated GUI copy in RAM.
  • The same runtime and display bridge are bundled with the VJ.Tools USB loader.

Download XZ-Mods-Builder-preview-win64.zip, extract it and keep XZ Mods.exe beside resources. The illustrated guide is included. To update an existing stick, build into an empty staging folder, back up its old autoexec.bin, then copy the new image to the USB root. The builder intentionally does not overwrite existing loader files. Existing tracks and stem caches do not need rebuilding.

Split rows, clean audio, pad brightness and primary pad colors were confirmed in RAM trials. Both packaged builders passed encrypted image round-trip checks. The artwork patch was checked to change only its two permitted image regions. Full theme coverage, cold-boot and extended two-deck qualification remain in progress; this is a developer preview.

Runtime SHA256: 218aca8d00d354d67e780e061d3cc0727eb5a82f530abf0534c719018316c134.

The public files contain no manufacturer firmware, boot keys or personal USB images. Supply your own supported 1.26 firmware and local boot key. Device modifications remain in RAM and clear on power-off; booting with the mod USB present loads them again.

User guide · Website

XZ Mods 0.1.2 developer preview

Choose a tag to compare

@OpticMystic OpticMystic released this 24 Sep 15:22

XZ Mods 0.1.2 developer preview

This preview adds connection-gated VJ.Tools access, default-on stems when no saved USB setting exists, brighter default stem cue colors, selectable A-D/E-H stem banks, and OverCue v4 checking.

The native-screen VJ.Tools corner button appears only while the MODS VJ.TOOLS CONNECTION setting is enabled and the network connection is live. The VJ.Tools settings remain available in MODS while offline.

This remains an experimental developer preview. Native-player, two-deck audio, and cold-boot acceptance are recorded separately from the build checks. Runtime SHA-256: f931d91b5068ecfb41295460fab39407279ad58d01e6aebe581dc7407461afb3. Receiver SHA-256: dac426e2a3856ab08b60060d4c0c117ff5f828d6dd32bef03d558ccfdbfe83e6.