Skip to content

Configuration

Preferences menu

Press ? or click the ? in the lower-right corner, then open the Preferences tab. Viewer changes apply immediately and are saved on the machine running ArrayView, in ~/.arrayview/config.toml.

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
arrayview config set viewer.turn_animation fade
arrayview config set viewer.qmri_start straight
arrayview config set viewer.qmri_maps t1,t2,pd,t1w
arrayview config set viewer.roi_shape freehand

Ortho layouts: horizontal, big-left.

Dimbar modes: compact, extended.

ROI shapes (what i starts drawing with): circle (default), rect, freehand, floodfill.

Turn animations (r / t / o): rotate (default), fade.

qMRI start (q): picker (default) first shows which maps and contrasts to open; straight opens the qmri_maps at once. qmri_maps names maps (t1, t2, pd, b1, db0, phase) and synthetic contrasts (t1w, t2w, pdw, t2flair, stir, psir); unset means t1, t2, pd.

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.

Reopen where you left off

Turn on Reopen where you left off in the Preferences menu (or arrayview config set viewer.remember_view true) and opening a file again brings back its slice, view (normal, 3-plane, qMRI), colormap and rotation. The display range comes back too, unless the file has changed since. Options given at launch, such as --index or --cmap, take precedence. Views are kept in ~/.arrayview/view_memory.json; a comparison of several arrays is not remembered.