Configuration
September 23, 2026 · View on GitHub
MovieBox-TUI stores its settings in config.json inside your platform configuration directory.
Interactive Settings Hub (/settings)
Enter /settings in the search bar or click [ ⚙ Settings ] on the Home screen to configure options interactively:
- General: Toggle automatic update checks, select default media player (
mpv,VLC,IINA,Android), and customize download directory. - Content Modes: Toggle Streaming Mode, enable or disable specific streaming providers (MovieBox, 4KHDHub, Dramachi, CircleFTP, DhakaFlix), and toggle Live TV Mode.
- Appearance: Select among 9 color themes (Mocha, Latte, Macchiato, Frappe, Nord, TokyoNight, Dracula, Gruvbox, RosePine) with live preview.
- Maintenance: Check for updates, re-test local BDIX network connectivity, clear disk cache, clear watch history, and open the GitHub repository.
Configuration File Paths
- Linux / macOS / Termux:
~/.config/moviebox-tui/config.json - Windows:
%APPDATA%\MovieBox-Tui\config.json
Configuration Options (config.json)
| Field | Type | Default | Description |
|---|---|---|---|
auto_update | bool | true | Check for application updates on launch |
default_player | string | "mpv" | Default player ("mpv", "vlc", "iina", "android") |
download_dir | string? | None | Custom download directory (defaults to ~/Downloads/MovieBox-TUI) |
streaming_enabled | bool | true | Enable on-demand streaming |
tv_enabled | bool | true | Enable live TV mode |
addons_enabled | bool | false | Enable Stremio Addons provider |
moviebox_enabled | bool | true | Enable MovieBox streaming provider |
fourkhdhub_enabled | bool | true | Enable 4KHDHub streaming provider |
dramachi_enabled | bool | true | Enable Dramachi streaming provider |
bdix_circleftp_enabled | bool | false | Enable CircleFTP (BDIX) provider |
bdix_dhakaflix_enabled | bool | false | Enable DhakaFlix (BDIX) provider |
theme | string | "TokyoNight" | Active color theme |
mpv_path | string? | None | Custom executable path for mpv |
vlc_path | string? | None | Custom executable path for VLC |
iina_path | string? | None | Custom executable path for IINA (macOS) |
Environment Variables
| Variable | Description |
|---|---|
MOVIEBOX_PLAYER | Force media player ("mpv", "vlc", "iina", "android") |
MOVIEBOX_MPV_PATH | Custom executable path for mpv |
MOVIEBOX_VLC_PATH | Custom executable path for VLC |
MOVIEBOX_IINA_PATH | Custom executable path for IINA (macOS) |
MOVIEBOX_CONFIG_DIR | Custom directory for config.json |
MOVIEBOX_DATA_DIR | Custom directory for watch history and favorites |
MOVIEBOX_CACHE_DIR | Custom directory for disk cache |
MOVIEBOX_THEME | Override active theme on launch (e.g. "TokyoNight", "Dracula") |
MOVIEBOX_LOG | Logging level ("error", "warn", "info", "debug", "trace") |
MOVIEBOX_NO_IMAGE | Set to "1" or "true" to disable terminal image previews |
MOVIEBOX_IMAGE_PROTOCOL | Force image protocol ("kitty", "sixel", "iterm2", or "off") |
MOVIEBOX_CELL_SIZE | Override font cell size for image scaling (e.g. "10x20") |
NO_COLOR | Force high-contrast monochrome mode |