Skip to content

Config Commands

setup

Interactive wizard to configure AI providers and models.

max config setup

This wizard will guide you through:

  • Choosing your AI provider (Google Gemini, OpenAI, Ollama, or custom)
  • Setting model preferences
  • For Ollama: selecting a local model (no API key needed)

Supported Providers:

Provider API Key Notes
Gemini Required Google's free tier available
OpenAI Required Pay-as-you-go
Ollama Not needed Run AI locally
Custom Required Use your own API endpoint

show

Show current configuration.

max config show

set

Set configuration value.

max config set <KEY> <VALUE>

grab

Configure download preferences.

max config grab

Interactive wizard to set: - Default video/audio quality - Auto-strip playlist info - Embed metadata - Default type (video/audio) - Default download folder - Queue system enabled/disabled

reset

Reset configuration to defaults.

max config reset [--global | --local]

validate

Validate current configuration.

max config validate

export

Export configuration to file.

max config export <file.json>

import

Import configuration from file.

max config import <file.json>

setup-ffmpeg

Auto-download and install FFmpeg to ~/.max_cli/bin/. Platform-specific binaries are downloaded and validated automatically.

max config setup-ffmpeg

This command: - Detects your OS and architecture - Downloads the appropriate FFmpeg binary - Validates the binary after download - Stores it in ~/.max_cli/bin/ for automatic resolution