Command Reference

All available CLI flags and options.

Basic Usage

bash

java -jar target/ScayTux.jar [OPTIONS]

Run with no arguments to launch Interactive Mode. Add flags for direct command execution.

Flag	Description	Example
-i, --interactive	Force interactive mode	-i
--flap	Flap wings up and down	--flap
--eyes <bool>	Open (true) or close (false) eyes	--eyes true
--blink <n>	Blink eyes N times	--blink 5
--mouth <bool>	Open (true) or close (false) mouth	--mouth true
--talk <n>	Move mouth N times (simulate talking)	--talk 10
--spin <dir>	Spin left or right	--spin left
--val <n>	Duration/loops for spin (default 20)	--val 100
--led <color>	LED color (1=Red, 2=Blue, 3=Yellow)	--led 2
--intensity <n>	LED intensity (0-255)	--intensity 255
--say <text>	Speak text with TTS and lip sync	--say "Hello World"
--combo <id>	Run a cinematic combo (1-55)	--combo 6
--play <file>	Play MP3 file with auto dance	--play song.mp3
--spin-doctor	Run spin motor diagnostic	--spin-doctor
-l, --list	Check device connection	-l
-d, --debug	Debug HID input monitor	-d

Make Tux flap, blink, and speak:

bash

java -jar target/ScayTux.jar --flap --blink 3 --say "Hello!"

Spin left for a long time with blue LED:

bash

java -jar target/ScayTux.jar --spin left --val 200 --led 2 --intensity 255

Play music with auto-dance:

bash

java -jar target/ScayTux.jar --play assets/audio/billie.mp3

Run the Police Mode combo:

bash

java -jar target/ScayTux.jar --combo 6