Boot access · Navigation · System menu · Themes · Games

Vocal Menu System

A practical guide to entering, navigating, and using the Crystal Focus X vocal menu, including font selection, system settings, themes, games, USB access, and the menu sound files behind it.

What you will learn

How to enter the vocal menu correctly
How button and gesture navigation works
What appears in the full, simple, and disabled menu modes
Which files and config settings control the menu

Main files

Menu intro: menu.wav
Menu background: menubgnd.wav
Config control: simplemenu, menuvol, menugest

Best used for

Changing fonts without a computer
Adjusting volume and strip lengths on-board
Tuning blade colors from the saber itself
Accessing themes, tracks, games, and USB mode

Crystal Focus X Guide

Vocal Menu System

What Is the Vocal Menu?

The Vocal Menu is the built-in voice-guided configuration system of the Crystal Focus X. It lets you select sound fonts, adjust volume and power, change LED strip lengths, tune blade colors, switch themes, access USB storage, and more without needing a computer.

Each menu item announces itself with a spoken name and shows a matching graphic on the OLED when one is installed. A looping background sound plays while the menu is active, so you always know you are inside the menu.

Entering the Vocal Menu

The most common way to enter the vocal menu is to press and hold the AUX button while the saber is off and not ignited, then keep holding it until you hear the menu intro sound.

The saber is on but the blade is off.
You press and hold AUX.
After the hold time, the vocal menu starts.
menu.wav plays, followed by the looping background track menubgnd.wav.
The menu starts on the last-used font.

Tip: Release AUX once you hear the vocal menu start. If you keep holding too long, the saber can enter Deep Sleep instead.

An alternate way to enter the menu is to hold AUX during boot, for example while inserting the battery or flipping the kill switch back on. That also works when the menu is enabled.

If the saber uses Mute On The Boot with motb=1, the menu audio uses the MOTB volume. Otherwise it uses the dedicated menu volume from menuvol=.

Menu Navigation

Button Controls

Action	Button	Effect
Next item	AUX short press	Move forward to the next menu item
Previous item	Activator short press	Move backward to the previous menu item
Select / Confirm	AUX or Activator long press	Select the current item or enter a sub-menu
Skip multiple items	AUX + Activator together	Jump forward by several items

Gesture Navigation

When menugest=1 is enabled in config.txt, you can navigate with motion as well.

Gesture	Effect
Twist right	Next item
Twist left	Previous item
Clash	Select or confirm current item

The saber should be held roughly horizontal for twist gestures to register reliably.

Menu Structure

The exact structure depends on the simplemenu= setting in config.txt.

Full Menu

MAIN MENU
├── Font 1
├── Font 2
├── Font 3
├── ...
├── Font N
├── Tracks
├── USB
├── System
│   ├── Volume
│   ├── Power
│   ├── Blade Length
│   ├── Aux Length
│   ├── Accents Length
│   ├── Aux Accents Length
│   ├── Trident Length
│   ├── Blade Colors
│   │   ├── Color Profile
│   │   ├── Blade Color
│   │   ├── Flash Color
│   │   ├── Lockup Color
│   │   ├── Bolt Color
│   │   ├── Crystal Color
│   │   ├── FX Color
│   │   ├── Flicker Color
│   │   ├── Stab Color
│   │   ├── Drag Color
│   │   └── Up
│   ├── Magnetic Calibration
│   ├── SD Card Test
│   └── Up
├── Accents Length
├── Theme
├── Games
└── Quit

Simplified Menu

MAIN MENU
├── Font 1
├── Font 2
├── ...
├── Font N
├── Tracks
└── Quit

This mode hides System, Theme, Games, and USB. It is useful for sabers that only need quick font selection.

Disabled Menu

When simplemenu=2, the vocal menu is completely disabled. Holding AUX during boot does nothing.

Font Selection

Fonts make up the main body of the menu. Each font entry plays the font’s own font.wav so you can identify it by ear.

AUX short press moves to the next font.
Activator short press moves to the previous font.
AUX + Activator together jumps forward by about one-fifth of the font list.

When a font is highlighted, the OLED shows that font’s font.bmp, the font number appears in the corner, and the accent LEDs show a glyph representation of the font number.

Long-press AUX or Activator to select the current font. The selection is saved, the font name plays once more as validation, and the menu exits.

You can hide individual fonts from the menu with skip=1 in that font’s font_config.txt. Skipped fonts are automatically bypassed while browsing.

Tracks / iSaber Mode

The Tracks item appears after the last font. Selecting it activates the track player, also called iSaber mode, and immediately exits the vocal menu. For full details on playback, use the Audio Tracks guide.

System Sub-Menu

Long-press on System to enter the system settings area.

Volume

The Volume menu gives you three separate sliders:

Slider	What it controls	Config key
Main	Saber sound effects volume	`volume=`
UI	Beep and UI feedback volume	`beepvol=`
Menu	Vocal menu voice and background volume	`menuvol=`

AUX short press increases the current slider by 10%.
Activator short press decreases it by 10%.
Long-press cycles to the next slider.
After the third slider, a long-press exits and saves the values.

Range is 10% to 100%.

Power

This adjusts the blade LED power level or drive current.

Blade Length and Other Strip Lengths

The menu can adjust several strip lengths directly on the saber:

Blade Length
Aux Length
Accents Length
Aux Accents Length
Trident Length

In these screens, AUX short press adds 1 pixel, Activator short press removes 1 pixel, and a long-press saves the new value to config.txt.

Blade Colors

The Blade Colors menu is a nested sub-menu with 10 color slots:

Color Slot	Purpose
Color Profile	Select a stored color profile by number
Blade Color	Main blade glow color
Flash Color	Flash-on-Clash color
Lockup Color	Lockup effect color
Bolt Color	Blaster bolt color
Crystal Color	Crystal chamber color
FX Color	General FX color
Flicker Color	Hum flicker modulation color
Stab Color	Stab effect color
Drag Color	Drag effect color

Select Up to return to the System menu.

Magnetic Calibration

When an OLED is installed, this runs the three-axis magnetometer calibration process with on-screen feedback.

SD Card Test

When an OLED is installed, this benchmarks the SD card with repeated read and write tests and displays the results.

Theme Sub-Menu

If your saber uses themes, the Theme entry appears in the main menu. Long-press to enter it, then browse themes just like you browse fonts. Selecting a theme reloads the theme package and switches the saber into that themed setup.

Games Sub-Menu

With an OLED installed, the Games entry opens a sub-menu that can contain:

Invaders
Pong
Snake
RTFM
Tetris
Jedi Trainer
MAAG
Kill The Bit
ASCII Star Wars

USB Storage Access

In the full menu, selecting USB puts the SD card into USB mass-storage mode so a computer can access it over the USB cable without removing the SD card from the saber.

Exiting the Menu

There are two normal ways to leave the vocal menu:

Select Quit and long-press.
Select any font or Tracks, which exits automatically.

If valsnd=1 is enabled, the saber plays the selected font name again as confirmation on exit. If you changed settings such as volume or strip lengths, the updated values are saved automatically.

OLED Display During the Menu

Context	What the OLED shows
Menu entry	Firmware version when `showversion=1`
Font item	The font’s `font.bmp`, animated if multi-frame, plus the font number
Non-font item	The item’s matching BMP such as `volume.bmp` or `system.bmp`
Volume sub-menu	Three labeled slider bars
No OLED installed	The menu still works by voice only

Sound Files Reference

The vocal menu relies on WAV and BMP pairs stored in the extra/UI/ folder, or in the active theme’s extra/UI/ folder when theming is active.

Background and Navigation Sounds

File	Purpose
`menu.wav`	Intro sound when entering the menu
`menubgnd.wav`	Looping background sound during the menu
`beep.wav`	Generic UI confirmation beep
`ok.wav`	Selection confirmation
`cancel.wav`	Cancellation or exit sound
`plus.wav`	Increment feedback
`minus.wav`	Decrement feedback
`neutral.wav`	Neutral feedback

Menu Item Sounds

Each spoken menu item has a matching BMP with the same file stem. Common examples include:

File stem	Menu item
`system`	System sub-menu
`volume`	Volume setting
`power`	Power setting
`length`	Blade length
`auxlength`	Aux blade length
`accentslength`	Accents strip length
`auxaccentslength`	Secondary accents length
`tridentlength`	Trident strip length
`colors`	Blade Colors sub-menu
`theme`	Theme sub-menu
`usb`	USB mass-storage mode
`games`	Games sub-menu
`magic`	Magnetic calibration
`sdtest`	SD card test
`up`	Go back one level
`quit`	Exit the menu

Per-Font Files

font.wav identifies the font by voice in the menu.
font.bmp is the visual identifier shown on the OLED.

Per-Theme Files

theme.wav is the spoken theme name.
theme.bmp is the visual theme image.

Configuration

Key	Values	Default	Description
`simplemenu=`	`0` / `1` / `2`	`0`	`0` = full menu, `1` = fonts plus Tracks and Quit only, `2` = menu disabled
`menuvol=`	`10` to `100`	`100`	Menu voice and background volume
`valsnd=`	`0` / `1`	`1`	Play the selected font name again on exit
`menugest=`	`0` / `1`	`0`	Enable gesture navigation in the menu
`quickmenu-pixies=`	`0` / `1`	`0`	Add a quick Accents Length shortcut to the main menu

Per-Font Option

Key	Values	Default	Description
`skip=`	`0` / `1`	`0`	Hide this font from the vocal menu

Quick Reference

Task	How
Enter the menu	Hold AUX while powering on
Browse forward	AUX short press
Browse backward	Activator short press
Skip many fonts	AUX + Activator together
Select an item	Long-press AUX or Activator
Enter a sub-menu	Long-press on System, Blade Colors, Theme, or Games
Go back one level	Select Up and long-press
Exit the menu	Select Quit and long-press, or select a font
Enable gesture navigation	Set `menugest=1`
Use simplified menu	Set `simplemenu=1`
Disable the menu	Set `simplemenu=2`
Skip a font	Add `skip=1` to that font’s `font_config.txt`