Audio Tracks & Music Player

What Are Audio Tracks?

The CFX has a built-in music player that can play WAV audio files such as background music, character themes, ambient soundscapes, or any other audio you want. Tracks play through the saber speaker alongside normal saber sounds.

A special file named cantina.wav can also live in the global tracks/ folder for quick serial access.

Where Track Files Go

Global Tracks

SD Card Root/
└── tracks/
    ├── track1.wav
    ├── track2.wav
    ├── track3.wav
    └── cantina.wav

Global tracks are shared across all fonts, but they require iSaber mode to be active.

Font-Local Tracks

1-MyFont/
├── hum.wav
├── clash1.wav
├── ...
└── tracks/
    ├── track1.wav
    ├── track2.wav
    ├── idle1.wav
    └── idle2.wav

Font-local tracks belong to one sound font only. When you change fonts, the local track library changes too.

Themed Tracks

0-Jedi/
└── tracks/
    ├── track1.wav
    └── track2.wav

When themes are active, global tracks go in the theme’s tracks/ folder. Font-local tracks still live inside the font folder within that theme.

Track Audio Format

For the best compatibility, keep your track files in this format:

TL;DR: WAV, 16-bit PCM, mono, 44.1 kHz recommended or 22.05 kHz.

Using this format helps avoid playback issues and keeps behavior consistent across regular tracks, idle tracks, and themed track folders.

File Naming Rules

• Files must be WAV format with a .wav extension.
• Track files must be named track1.wav, track2.wav, track3.wav, and so on.
• Idle files must be named idle1.wav, idle2.wav, and so on.
• Numbering must be sequential starting from 1.

Important: If you skip a number, files after that gap will not be found. For example, if you have track1.wav and track3.wav but no track2.wav, only track1.wav will be detected.

Global Tracks vs. Font-Local Tracks

The CFX handles two separate track pools. Font-local tracks are always available when the current font has a tracks/ subfolder. They work immediately with no extra setup. Global tracks require iSaber mode to be active.

• When iSaber mode is active, playback uses the global tracks/ folder.
• When iSaber mode is not active, playback uses the current font’s local tracks/ subfolder, if it exists.
• The saber still keeps using the previously selected font for normal blade sounds, even when global tracks are active.

Tip: If your fonts do not have their own tracks/ subfolders, you need to activate iSaber mode through the vocal menu before the player can use global tracks.

Playing Tracks

Tracks play only when the blade is OFF. If a track is playing and you ignite the blade, the track stops automatically.

Double-Click the Activator

• First double-click starts playback, after a confirmation beep.
• While playing, double-click pauses the track.
• While paused, double-click resumes playback.

This only works when tracks are available.

Long-Press the Activator

When trackgest=0, holding the activator while the blade is off skips to the next track.

• Two-button saber: about 1 second
• Single-button saber: about 2 seconds

Twist Gestures

When trackgest=1 is enabled, you can skip by twisting the saber while holding the activator.

• Twist right: next track
• Twist left: previous track

When track gestures are enabled, the long-press skip method is disabled.

Idle Tracks

Idle tracks are ambient audio files that play automatically when the saber is idle and the blade is off. They are always font-specific and must live inside the font’s tracks/ subfolder.

• They start automatically when no other sound is active and the blade is off.
• They loop continuously by selecting one idle track after another.
• They are interrupted by regular track playback, blade ignition, or other sound effects.
• They follow the active shuffle mode.

Use case: Idle tracks are great for breathing sounds, ambient environments, or subtle background audio while the saber is resting.

Playback Behavior

What Happens When a Track Ends

• If loop=0, the player automatically advances to the next track and continues playback through the library.
• If loop=1, the current track repeats until you manually skip or stop it.

Track Playback While the Blade Is Active

Tracks do not play while the blade is on. If a track is playing and you ignite the blade, the track stops immediately. This is by design so the audio system stays focused on saber effects.

Configuration Settings

shuffle=

shuffle=2

loop=

loop=0

pause=

pause=1

trackgest=

trackgest=1

Vocal Menu — Tracks / iSaber Entry

In the vocal menu’s font list, the last entry after all your sound fonts is the Tracks item. Its selection sound and display image come from the global tracks/ folder. Selecting it activates iSaber mode, which tells the music player to use global tracks instead of font-local ones.

When you go back and select a regular font, iSaber mode is disabled again and the player switches back to that font’s local tracks, if available.

OLED Display — VU Meter

When tracks are available, the OLED can show a VU meter page that visualizes audio levels in real time during playback. The background image comes from vumeter.bmp in either the active theme’s extra/VUMETER/ folder or the root /extra/VUMETER/ folder.

The VU meter page appears in the OLED page rotation and can be cycled with the AUX button while the blade is off.

Serial Commands

Important: Track numbers in serial commands are 0-based. That means w-track=0 plays track1.wav, w-track=1 plays track2.wav, and so on.

SD Card Layout Examples

Minimal Setup — Font-Local Tracks Only

SD Card Root/
└── 1-MyFont/
    ├── hum.wav
    ├── clash1.wav
    └── tracks/
        ├── track1.wav
        └── track2.wav

No special config is needed. Double-click the activator with the blade off to start playback.

Global Tracks for All Fonts

SD Card Root/
├── tracks/
│   ├── track1.wav
│   ├── track2.wav
│   ├── track3.wav
│   └── font.bmp
├── 1-Jedi/
│   └── ...
└── 2-Sith/
    └── ...

Use the vocal menu’s Tracks entry to activate iSaber mode, then double-click the activator to play.

Mixed Setup — Both Global and Font-Local

SD Card Root/
├── tracks/
│   ├── track1.wav
│   └── track2.wav
├── 1-Jedi/
│   ├── hum.wav
│   └── tracks/
│       ├── track1.wav
│       ├── idle1.wav
│       └── idle2.wav
└── 2-Sith/
    ├── hum.wav
    └── tracks/
        └── track1.wav

Themed Setup

0-Jedi/
├── config.txt
├── tracks/
│   ├── track1.wav
│   └── track2.wav
├── 1-Guardian/
│   └── tracks/
│       ├── track1.wav
│       └── idle1.wav
└── 2-Sentinel/
    └── ...

Quick Reference

Tips

• Tracks only play with the blade off. Igniting the blade always stops track playback.
• Number files sequentially starting from 1. Gaps in numbering prevent later files from being found.
• Font-local tracks work immediately. Just add a tracks/ subfolder inside the font.
• Global tracks require iSaber mode.
• Idle tracks auto-play. Regular track playback overrides them.
• The shuffle= setting also affects idle tracks.
• Serial commands use 0-based numbering.

Crystal Focus X firmware guide · Audio Tracks & Music Player