Messages and troubleshooting

This chapter lists every message XZ Mods can show you, what it means and the one thing to do about it. Find the words you see on the screen in the tables below. Messages in capitals come from the player. Messages in normal case come from the XZ Mods app on your computer.

#If the player will not start with the USB

XZ Mods runs from the USB. Without the USB the player starts as it was.

1. Switch the player off.
2. Remove the XZ Mods USB and switch the player on. It starts without XZ Mods. Play from a stick without XZ Mods if you are in a set.
3. On your computer, open the USB in the XZ Mods app. If it says Update available, choose Update USB. If it says Up to date, open Updates › XZ Mods version › Restore or update a loader by hand and update the loader again. The app keeps a backup of the old loader each time.
4. Try the USB again. If it still does not start, report the problem.

Check these first:

If XZ Mods started after a network update and stopped working, open CONNECT › UPDATES and push PREVIOUS VERSION, then switch the player off and on. See Updates over the network.

If the sound goes wrong while you test, stop playback and switch the player off and on. Load the same track again and check the original mix before you go on.

#Stems on the USB

When a deck cannot play stems, its stem row says why and its last button offers the next step. In CLASSIC the row sits under the deck's waveform. Open the button to see the deck's setup page in MODS.

MODS · USB STEMS

⤢1234567

1. 1
   STANDALONE STEMS SETUP

   The three things stems need, in order.

2. 2
   Steps

   1 CHECK ENGINE, 2 TURN ON (ALL DECKS), 3 LOAD A PREPARED TRACK.

3. 3
   Deck state

   The deck and why it has no stems.

4. 4
   Next step

   The one thing to do.

5. 5
   Deck

   Choose DECK 1 or DECK 2 to check the other deck.

6. 6
   CHECK THIS DECK AGAIN

   Reads the deck again after you fixed it.

7. 7
   State

   The deck's stem state in a word or two.

Every state on both interfaces, with pictures, is in Stems.

#Notices on the play screen modern

A notice is a short message in the middle of the lanes. It clears on its own after a few seconds, and the deck keeps playing.

MODERN · Play screen

⤢1

1. 1
   Notice

   What happened. Nothing else on the screen changes.

Notice	What to do
DECK 1 DID NOT LOAD THE TRACK	Load the track again. If it fails again, check the file in your DJ software
THE TRACK ON USB 2 COULD NOT BE READ BECAUSE THE DEVICE WAS REMOVED WHILE IT WAS LOADING	Plug the USB back in and load the track again
USB1 IS NOT CONNECTED, USB2 IS NOT CONNECTED	Plug in the USB, or choose the other source
USB SOURCE CHANGED: SELECT TRACK AGAIN	The USB changed under the list. Choose the track again
SELECT A TRACK, THEN PRESS LOAD	Highlight a track first
OPEN A TRACK LIST TO LOAD, NO USB TRACK LIST TO LOAD FROM	Open a track list on a USB, then load
LOAD FROM THIS LIST IS OFF	Loading from this list is switched off. See Browsing and loading
THIS ROW CANNOT BE LOADED, THAT DECK CANNOT LOAD THIS TRACK	Choose another track or another deck
TAG LIST IS FULL: 100 TRACKS	Remove a track from the tag list first
MATCHING NEEDS A MASTER DECK	Set a master deck, then use MATCHING
NO MASTER DECK: BPM FILTER OFF, NO MASTER KEY: KEY FILTER OFF	The filter has nothing to compare with. Set a master deck
COMPUTER BROWSING IS NOT AVAILABLE YET, LINK BROWSING IS NOT AVAILABLE YET	Browse a USB instead. These sources come in a later version
LINK DID NOT OPEN, EXPORT MODE DID NOT OPEN	Try again. The player's own screen did not open
MODS DID NOT OPEN: PUSH AGAIN	Push again
TOUCH CANNOT OPEN THIS YET: PUSH THE ENCODER	Use the encoder for this item
THAT SETTING CANNOT CHANGE HERE	Change it in the player's own UTILITY. Hold MENU
DECK 3 AND 4 ARE NOT RUNNING	Set up four decks first. See Four decks
KEY SHIFT REFUSED: AUDIO LOAD TOO HIGH	The measured audio workload leaves too little headroom for a new shift. Current shifts keep running. Check SYSTEM READOUT and retry when the load falls. See Keys and KEY SYNC
THIS DECK IS MASTER	KEY SYNC matches a deck to the master. Make another deck the master first
A player warning such as E-8307: USB ACCESS ERROR	The player raised its own warning window. MODERN says it once in the player's words and keeps working. See The player's own warnings
THIS DJ PROFILE CANNOT BE READ	Make the profile again in the XZ Mods app. See Connect and DJ profiles

#Errors on a deck

When the player cannot play a track, XZ Mods shows the player's own error code and text on that deck. XZ Mods never hides these errors.

MODERN · Play screen

⤢12

1. 1
   Error

   The player's own code and text.

2. 2
   CHOOSE TRACK

   Opens browse so you can load another track.

• MODERN. The error covers the deck's lane, with CHOOSE TRACK. While MODS is open, the strip at the top of the dock turns red with each deck's badge, the code, the player's text and SHOW DECK. Tap the strip to close MODS and see the deck.
• CLASSIC. The player's own error stays visible in the deck's lower area, also while MODS is open. Touches there go to the player.

#The player's own warnings

The player sometimes raises its own warning window, for example about a USB or a device. XZ Mods shows it and keeps working.

• MODERN. The play screen says the warning once, in the player's own words, for example E-8307: USB ACCESS ERROR. Browse, the decks and every control keep working.
• MODS, in either interface. MODS stays open on the same page. The strip at the top of the dock turns red with the warning's code and text, and REPORT THIS. The strip goes when the warning does.
• CLASSIC with MODS closed. CLASSIC shows the player's window. Touches, keys and the encoder go to the player until it closes the window. The button above LINK still does its own job: out of the box it switches to MODERN, which keeps working over the window.

MODS · dock

⤢⤢1

1. 1
   Warning

   The player's code and text.

#LOOPBACK CABLE CONNECTED

With the loopback cable in, the play screen stays as it is in MODERN, MODS and CLASSIC, and decks 3 and 4 work as described in Four decks. If CLASSIC shows a LOOPBACK CABLE CONNECTED card, the cable is in and nothing is wrong.

#When settings cannot be saved

Every change in MODS saves on its own to the USB. The save state at the right of the MODS dock says what happened. Lines that say NOT SAVED or NO SETTINGS USB show in amber. The full list is in Saving to the USB.

A padlock beside a setting means XZ Mods shows it but cannot change it there. The help under it says why. See UTILITY, the player's own settings.

#Messages in the XZ Mods app

Every "needs setup" state in the app comes with one button that starts a short guide. Press it.

Every page of the app is in The XZ Mods app.

#The diary on your USB sticks

XZ Mods keeps a short diagnostic diary in VJ.Tools/XZ-Mods-diary/ on each mounted USB stick, including music sticks. If a problem happens during a set, keep those sticks so you can include their diaries in a later report.

The diary records the XZ Mods version, settings fingerprint, USB slots, interface, deck view, state changes and fixed notice codes. It also records available CPU, memory, audio, SYNC, key-processing and USB-read measurements. It never records track titles, music paths, serial numbers or network identities. A missing measurement stays unknown.

Each stick holds at most 4 MiB of diary files. Older segments are replaced first, and the previous session's latest segment is kept when a new session starts. Writing pauses during track loads, RAM copies and heavy USB reads. No diary is created on a read-only stick or when less than 64 MiB of free space plus a small write reserve remains. Read-only test sessions save nothing. Normal USB-loader sessions write diary entries when these conditions allow it. Long busy periods and removal can leave gaps.

The diary stays on the sticks. Nothing is sent until you choose to include it in a report.

#Report a problem

When something goes wrong, send a report. It helps fix the problem for everyone.

• On the player. Open MODS › EXTRAS › REPORT AN ISSUE, or push REPORT THIS beside an error in the dock. Choose a topic, add words if you like, and send. Offline, the report waits on the stick for your computer. See Report an issue.
• On your computer. In the XZ Mods app, open Feedback at the top right and choose Report a problem. Only one box is required, and My reports in Feedback shows where your report is afterwards. See Report a problem or share an idea.
• On GitHub. Open an issue at https://github.com/OpticMystic/XZ-Mods/issues.

Say what you did, what you expected and what happened. The app adds the cleaned-up details itself, and you can see and untick each one. Nothing is sent until you press Send privately, and the app posts nothing publicly. From the player, the public GitHub issue is a separate step you submit yourself.