config

View and modify qwen-tts configuration.

Configuration is stored in ~/.config/qwen-tts/config.toml.

Subcommands

config init

Initialize configuration with auto-detected platform settings.

qwen-tts config init

This command:

  1. Detects your operating system and hardware (Apple Silicon, NVIDIA GPU, or CPU-only).
  2. Selects the appropriate backend (mlx, cuda, or cpu).
  3. Creates the directory structure at ~/.qwen-tts/ (models, voices, outputs).
  4. Writes default values to ~/.config/qwen-tts/config.toml.

Run this once after installation, or again to reset to defaults.

config show

Display the current configuration.

qwen-tts config show

Prints the full contents of config.toml in TOML format.

config set

Set a single configuration value.

qwen-tts config set <KEY> <VALUE>
ArgumentDescription
KEYThe configuration key to set.
VALUEThe new value.

Examples:

qwen-tts config set default_voice "Ethan"
qwen-tts config set default_speed 1.2
qwen-tts config set auto_play false
qwen-tts config set backend cuda
qwen-tts config set model_variant lite
qwen-tts config set auto_cleanup false
qwen-tts config set cleanup_age_hours 48

Configuration Keys

KeyTypeDefaultDescription
python_pathstring~/.qwen-tts/venv/bin/pythonPath to the Python interpreter in the virtual environment.
models_dirstring~/.qwen-tts/modelsDirectory where downloaded models are stored.
voices_dirstring~/.qwen-tts/voicesDirectory where saved voice references are stored.
output_dirstring~/.qwen-tts/outputsDefault directory for generated audio files.
backendstringauto-detectedInference backend: mlx, cuda, or cpu.
default_voicestringVivianDefault voice name for the speak command.
default_speedfloat1.0Default speech speed multiplier.
auto_playbooltrueAutomatically play audio after generation.
model_variantstringproActive model variant: pro or lite.
auto_cleanupbooltrueAutomatically delete old output files on each run.
cleanup_age_hoursinteger24Minimum age in hours before an output file is cleaned up.

For a detailed description of each key, see Configuration.