Loading documentation...

Settings & Preferences

Customize the viewer, analysis defaults, and display options to match your workflow.

Overview

Detego has two levels of settings:

Global preferences — Apply to all recordings and persist across sessions. Configured on the Settings page (/settings).
Per-recording display configuration — Saved individually for each recording as part of its cloud data. Includes channel visibility, cursor positions, annotations, protection settings, and more.

Global preferences act as defaults — when you open a new recording, it inherits your global settings. Once you customize anything for a specific recording, those per-recording overrides take precedence.

Global Preferences

The Settings page is organized into six sections. Changes take effect immediately and auto-save to both localStorage and (when signed in) your cloud profile for cross-device sync.

Appearance

Setting	Options	Default	Description
Theme	Light, Dark	Light	Controls the overall color scheme of the application
Color Convention	IEC, ANSI	IEC	Phase color convention for waveforms, phasors, and all channel visualizations
Chart Font Size	8 – 18 px	11 px	Base font size for chart axis labels and tick marks
Sidebar Width	160 – 400 px	224 px	Default width of the channel controls sidebar when opening a new file

Viewer Defaults

Setting	Options	Default	Description
Drag Mode	Zoom, Pan	Zoom	Default interaction mode when clicking and dragging on the waveform
Y-Axis Scaling	Fit, Proportional	Fit	Default vertical scaling mode for channels
Digital Visibility	On, Off	On	Whether digital channels are visible by default
Default Tab	Any viewer tab	Waveforms	Which tab is selected when first opening a recording
Channel Grouping	None, By Type, By Phase, Custom	None	Default grouping mode for the channel sidebar. Custom lets you define your own groups via the group editor.
Split Ratio	0.50 – 0.95	0.75	Default proportion of screen space allocated to analog vs. digital channels
Line Width	0.5 – 4 px	1.5 px	Waveform trace thickness
Grid Lines	On, Off	On	Whether chart grid lines are displayed

Analysis Defaults

Setting	Options	Default	Description
Nominal Frequency	50, 60 Hz	50 Hz	System frequency used for DFT window sizing and per-unit calculations
IEEE 519 Voltage Class	Below 69 kV, 69–161 kV, Above 161 kV	Below 69 kV	Voltage class for harmonic distortion limit evaluation per IEEE 519
Harmonics Max Order	5 – 50	25	Highest harmonic order computed in spectrum analysis
Harmonics Default View	Spectrum, Trend	Spectrum	Initial view mode when opening the Harmonics tab

Annotation Defaults

Setting	Options	Default	Description
Default Color	Hex color	#3b82f6 (blue)	Default color for new annotations
Default Type	Text Note, Event Marker, RMS Stamp	Text Note	Default annotation tool selected when entering annotation mode
Auto-Annotate Faults	On, Off	Off	Automatically place annotations at detected fault inception and clearance points

Dashboard Defaults

Setting	Options	Default	Description
Sort Order	Upload date, Recording date, Station name	Upload date	Default sort order for the recordings table
View Mode	List, Grid	List	Default display mode for recordings
Records Per Page	10, 25, 50, 100	25	Number of recordings shown per page

Upload Defaults

Setting	Options	Default	Description
Default Folder	Any folder or None	None	Automatically assign uploaded recordings to this folder
Auto-Open Single File	On, Off	On	When uploading a single file, automatically open it in the viewer

Reset

Each section has a Reset button to restore that group to defaults. There is also a global Reset All button at the top of the Settings page to restore everything at once.

Per-Recording Display Config

When you work with a recording in the viewer, your display state is saved automatically as part of that recording's data. The following are persisted per-recording:

Channel visibility — Which analog and digital channels are shown or hidden
Channel heights — Individual channel subplot heights (if you have resized them)
Color scheme — IEC or ANSI override for this specific recording
Cursor positions — Single cursor time, dual cursor A/B positions, and dual-cursor mode toggle
Zoom range — The current X-axis (time) range
Channel grouping — None, by type, by phase, or custom (including the custom group definitions)
Split ratio — Analog vs. digital vertical space allocation
Annotations — All waveform annotations (markers, stamps, notes, event markers)
Computed signals — Any derived signals created in the Compute tab
Protection settings — Distance protection zones, overcurrent stages, fault location parameters, and differential settings
Power configuration — V-I channel pairing for power calculations
Primary/secondary scaling — CT and VT ratios (global and per-channel overrides) and the current display mode
User report — The full block-based report from the Report tab
Differential settings — Transformer configuration and bias characteristic

This auto-save triggers 2 seconds after any change (debounced). When you reopen a recording from the dashboard, the entire display state is restored — including cursor position, zoom level, and annotations.

New recordings

When you open a recording for the first time, it inherits your global preferences as initial values. From that point on, any changes are saved per-recording and do not affect your global defaults.

Device Settings as Templates

When a recording is linked to a device (via the dashboard or device management), the device's protection settings are copied as initial values for that recording. This includes:

CT and VT ratios
Line impedance (Z1, Z0, magnitude, angle)
Distance protection zone settings
Overcurrent stage settings
Differential bias characteristic
Transformer configuration (vector group, rated MVA, winding voltages)

Customizing these values on the recording does not write back to the device template. The device serves as a one-time seed — after linking, the recording has its own independent copy. To change device-level defaults, edit the device directly in the{" "}Device Management page.

Local-Only Mode

The viewer toolbar includes a Cloud / Local toggle that controls where recording data is stored:

Cloud mode (default when signed in) — Recordings, display configuration, and reports are saved to Supabase. They appear on your dashboard and sync across devices.
Local-only mode — Recordings are parsed and displayed in the browser but nothing is sent to the server. No cloud persistence, no dashboard entry. Useful for sensitive data that should not leave your machine, or for offline work.

When you are not signed in, local-only mode is the default and only option. Files are still fully parsed and all analysis features work — you just cannot save to the cloud or access the dashboard.

Session-only

In local-only mode, closing the browser tab loses all data. There is no recovery. If you need to preserve your work, sign in and switch to cloud mode before closing.

Color Conventions

Detego supports two industry-standard phase color conventions:

IEC (International)

Phase	Color
A (L1)	Red
B (L2)	Yellow
C (L3)	Blue

ANSI (North American)

Phase	Color
A	Black
B	Red
C	Blue

The color convention affects all visualizations — waveform traces, phasor diagrams, impedance plots, harmonic spectra, and protection characteristics. Set your preferred convention in Settings > Appearance > Color Convention, or override per-recording by changing the color scheme in the viewer toolbar.

Settings Persistence

Global settings use a two-tier persistence strategy:

localStorage — Settings are written to the browser immediately on every change. This ensures instant access on the next page load, even offline.
Supabase profile — When signed in, settings are also pushed to your cloud profile in the background. On load, the app compares local and remote timestamps and keeps the most recent version (last-write-wins).

This means your settings follow you across devices when signed in, while still working fully offline via localStorage.

PreviousMerging Recordings NextPhasors