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.