Configuration

Preferences menu

Open the gear menu in the lower-right corner. Viewer changes apply immediately and are saved on the machine running ArrayView.

Window defaults apply to the next launch. Remote SSH, VS Code Tunnel, and remote Jupyter sessions save to the remote backend user's ~/.arrayview/config.toml.

Per-environment defaults

Set a window backend for each detected environment:

arrayview config set window.terminal browser
arrayview config set window.vscode vscode
arrayview config set window.jupyter inline
arrayview config set window.ssh browser
arrayview config set window.default browser

arrayview config list     # show current config
arrayview config reset    # delete config file

Stored in ~/.arrayview/config.toml.

Viewer defaults

arrayview config set viewer.rounded_panes false
arrayview config set viewer.ortho_layout big-left
arrayview config set viewer.dimbar_mode extended

Ortho layouts: horizontal, big-left.

Dimbar modes: compact, extended.

Environment variable

ARRAYVIEW_WINDOW=browser uvx arrayview img.npy

Priority

Explicit --window flag > ARRAYVIEW_WINDOW env var > config file > built-in default.

Detected environments

Environment	Detected when
terminal	Plain terminal (no VS Code, SSH, or Jupyter)
vscode	VS Code integrated terminal
jupyter	Jupyter / IPython notebook kernel
ssh	SSH session without VS Code
julia	Julia via PythonCall / PyCall

MATLAB uses the detected terminal, VS Code, SSH, or remote route. Local MATLAB prefers a native window when available. See MATLAB and Julia.