Source code coming soon. The GitHub repository is private for now and opens to everyone very soon.
BetterSPICE Beta 0.8.0 Join the beta Download soon
Part V  The app in detailReferenceContentsIndex
19

The window in detail

Every part of the window in detail. A tour of the window has the map with the ten numbered areas.

19.1The toolbar in detail

The toolbar. Run / Pause is orange while the live simulation runs. The Simulate group is on the right.
Figure 19.1The toolbar. Run / Pause is orange while the live simulation runs. The Simulate group is on the right.
The toolbar in detail
GroupControls
FileNew, Open, Save, Import
UndoUndo, Redo
ClipboardCut, Copy, Paste
TransformRotate, Mirror, Delete
ZoomZoom in, Zoom out, Zoom to fit
DrawSelect tool, Wire, Bus, Ground, Power flag, Probe. The active tool is highlighted.
NetsNet label, Global label, Sheet port, Bus entry
GraphicsText, Line, Rectangle, Circle
RunRun / Pause. When the live engine stops on an error it becomes a red Halted button that opens Diagnostics. Then Step, Reset and the simulated time.
TimebaseSimulated time per real second: a slider, a field, a unit list (ps, ns, µs, ms, s) and "/s". Range 1 ps/s to 10 s/s. Timebase and speed explains it.
CurrentCurrent dot speed, 0.01x to 100x, and Fit. Display only, the simulation doesn't change.
TimestepThe live engine's timestep, read only.
SimulateSimulate for and max step are the Transient setup's stop time and maximum timestep. Simulate F5 runs it. An empty max step reads Auto with the step, for example Auto 50 µs: BetterSPICE picks it from the circuit (Auto maximum step).
.acShows the AC range, for example 1 Hz–1 MHz. Click to open the AC setup.
.stepShows the stepped parameter and the number of values, for example R1.r ×5. Click to open the step setup.

When the window is narrow, the groups that matter least fold into a More tools menu first, and they come back as soon as there's room. Then the Simulate for and max step labels go (the fields keep their tooltips), then the file buttons and the bus, ground and power tools fold. The timebase and current sliders stay until after that: the current slider folds next, and only then does the timebase become a compact Timebase 10 ms/s ▾ button (a click opens the full slider, value and unit, and Esc or a click outside closes it). With room again, the timebase slider is the first thing to come back. Select, Wire, Probe and Meter probe never fold, and Undo and Redo fold last.

Number fields in the toolbar show the value with its unit, such as 200 ms. Click a field to select its value, type 200m, 0.2 or 1u, and press Enter. A second click places the caret. Esc cancels. Text that's not a number turns the field red and a message says what was kept, for example "Simulate for: "abc" is not a value (try 4.7k, 100n, 2.2u), kept 200 ms."

19.2The status bar in detail

The status bar.
Figure 19.2The status bar.
The status bar in detail
ItemShows
EngineLive MNA · WASM for the fast engine, Live MNA · native in the desktop app for a circuit of 100 parts or more (the same frames, about 1.4x as fast on a 578-part board), Live MNA · JS when the WebAssembly engine could not load and the slower JavaScript fallback runs, then · running, · paused or · halted (after an error). Live MNA · idle on an empty sheet. Hold the pointer over it for what the engine does. This is where the run state is shown: the canvas no longer has Running and Paused pills.
AccurateDesktop: checking…, then ngspice 47 ready or ngspice not found. Browser: built-in engine.
StepThe live engine's timestep.
CostMicroseconds of computer time per simulated step.
NodesThe number of nets in the circuit.
RenderFrames per second while running, a dash when paused.
ThreadsWhat may run side by side, always shown: Steps and tolerance 16 threads is how many threads parameter steps, Monte Carlo runs and the analysis pool may use. After a run it also says what that run used, for example Last run 1 thread (a transient goes step by step) or Last run 5 threads for a parameter step. Hold the pointer over it for the Threads setting and the reason a single transient uses one core: each time step needs the one before it (Threads).
DiagnosticsA red badge with the number of errors, an amber badge with the number of warnings, or none. The badge is red only when there's an error. Warnings alone are amber. Open pins are counted once your edits have paused for 1.5 s. Click it to open Diagnostics (Alt+6).
HintWhat the active tool does, for example "Wire: click to start, click to bend or end · double-click ends · Esc stops". With no tool active: "Ctrl+R run · . step · R C L D place · Ctrl+K everything · E examples".

19.3Canvas overlays

The canvas shows only what needs your attention. The one state pill is the red Halted · code pill at the bottom left, which opens Diagnostics. Running and paused aren't drawn on the canvas: they are in the status bar and on the toolbar's Run / Pause button. The engine's description (MNA, Newton iteration, companion models, explained in How the live engine works) is the tooltip of the status bar's engine item. An AI agent at work adds the presence bar (Working with an AI agent). Inside a hierarchical sheet a breadcrumb sits at the top left (Hierarchical sheets and buses). The Overview button at the bottom right opens the minimap (Moving around).

19.4Tabs

Every open circuit has a tab above the canvas. The tab shows the file name, with a dot when there are unsaved changes, and the full path as its tooltip. The window title follows the active tab: name • - BetterSPICE, where the dot marks unsaved changes. What a tab says depends on where the circuit came from:

Tabs
The tab readsIt is
rc-lowpass.bscA circuit saved in a file.
untitled · not saved, untitled 2 · not saved, …A new circuit that was never saved. Each new one gets the next number, so tabs never share a name. File›New reuses an untouched empty untitled tab instead of opening another.
RC low-pass, 1.6 kHz · exampleAn example, named by its title. It's not your file: File›Save as keeps a copy, and the first Save asks for a name. The menu bar says example (Save as to keep a copy) until you do.
Five open circuits, three examples and two untitled ones, with the list open from the arrow at the right end.
Figure 19.3Five open circuits, three examples and two untitled ones, with the list open from the arrow at the right end.

Double-click the tab of an unsaved circuit or an example to rename the circuit in place (one undo step). With many tabs, ‹ and › arrows appear at the ends of the tab strip and the active tab always scrolls into view. The down-arrow button (▾) at the right end of the strip lists every open circuit with its state and unsaved dot: pick one to switch to it.

Switching tabs keeps each circuit's live simulation as you left it: its traces, scope history, logic recordings, timebase, and whether it was running or paused. A circuit you open fresh always runs. BetterSPICE keeps up to four background tabs this way. A tab beyond that restarts from t = 0 when you return. The tool goes back to Select on a switch.

Tabs
ToDo this
Switch tabClick it, or Ctrl+Tab and Ctrl+Shift+Tab.
Close a tabClick its ×, middle-click it, or press Ctrl+W. A tab with unsaved changes asks Save, Don't save or Cancel in place.
Open a new tabNew (unless the open tab is an untouched empty circuit), Open, Import, opening an example while you have work open, crash recovery, files opened from Explorer and files dropped on the window all open new tabs.
See every tabClick the down-arrow button at the right end of the tab strip, or use the ‹ and › arrows.
Rename an unsaved circuitDouble-click its tab, type the name and press Enter.

19.5Views

Views
ViewKeyShows
SchematicCtrl+1The canvas and the dock.
AnalysisCtrl+2Only the Analysis view: the result of the last analysis.
SplitCtrl+3The schematic on top and the Analysis view below. In Split a plain click selects, drags and wires as in the Schematic view. Alt+click a net or a two-pin part adds its trace.

Every way of starting a run shows its result the same way: F5, Ctrl+F5, F9, the analysis keys, and Run in the setup. From the Schematic view the window splits, so the schematic stays visible. In Split and Analysis the view stays as it is.

19.6Resizing panes

View›Hide library (Ctrl+B), View›Hide inspector and measurements (Ctrl+Shift+B) and View›Hide dock (Ctrl+J) give the canvas more room. They are remembered, and a command that needs a hidden pane (a dock tab key, the library search, My parts) shows it again.

Every pane edge can be dragged: the library width, the inspector width (260 px to 45 % of the window), the Measurements height, the dock height and the split height. Double-click an edge to put that one back. Ctrl+F6 moves the keyboard focus to the next pane (library search, canvas, inspector or dock, skipping hidden panes) and Ctrl+Shift+F6 to the previous one. The pane's name is announced to screen readers. With an edge focused, the arrow keys move it by 16 px, with Shift by 64 px. The sizes are remembered, and sizes saved on a larger monitor are fitted to the window. View›Reset pane sizes puts every pane back.

19.7Themes and colours

The dark theme (default).
Figure 19.4The dark theme (default).
The light theme, for printing and bright rooms.
Figure 19.5The light theme, for printing and bright rooms.
Themes and colours
SettingKeyWhat changes
Light themeCtrl+Shift+LThe whole interface switches to a light background. The layout stays the same.
Live lookView, Live lookNew (the default) or Classic, the look of version 0.3 and earlier. The look you pick is kept (Live look).
Voltage coloursCtrl+Shift+KClassic look only. Default: positive wires green, negative red, zero grey, current dots yellow. Design colours: positive orange, negative blue, zero grey, dots white. The colour saturates at the circuit's voltage range, 10 V by default. In the New look the entry is greyed out, because that look has one scale for every circuit.

The theme, the live look, the voltage colours, the pane sizes, hidden panes, the current dot speed, the view mode, the dock tab, the library filter chips, the open library families and its scroll position are remembered for the next start. There's no separate settings dialog. Open, Save and Export dialogs start in the open file's folder, or the last folder you used.

19.8Messages

Short messages (toasts) appear at the top right of the canvas, up to three at a time. A coloured rule marks the kind: red for a failure. Some carry one button, such as Undo after Clear activity log, or Place now after a part is saved to My parts. Click a message to close it. It stays while the pointer is over it. Every message is also listed in Activity as a notice, so you can read it again later.

A message at the top right of the canvas: probing a net twice adds nothing.
Figure 19.6A message at the top right of the canvas: probing a net twice adds nothing.

19.9What's new

A short panel lists what a version brings. It opens by itself once, on the first start after the app's version changed, and it waits for any open dialog to close first. Close it with Close or Esc. Help›What's new opens it at any time. A patch release without notes shows nothing.

The What's new panel for version 0.8.0.
Figure 19.7The What's new panel for version 0.8.0.

19.10Pop-out windows

The whole dock, any scope, all scopes together and the Analysis view can each move into their own window, which you can put on a second monitor. They show the same live data, with no copying. Close the window or press Dock back to return it. Keys pressed in a pop-out, such as Ctrl+R, reach the main window. Pop-outs close when the app closes.

19.11Start where you left off

The tabs you had open come back at the next start, in the same order, with the tab you were on in front. Saved files are read again from disk, and a file that is gone is skipped with a note. Examples and unsaved circuits come back from their kept text, still marked unsaved, and a note says so: "Reopened N unsaved circuit(s) from <time>. Save to keep it." With nothing to reopen, the app starts with a blank sheet. File›Reopen the last session on start turns this off, for a blank start every time.

19.12Autosave and recovery

Every circuit with unsaved changes is copied to the app's storage 1.5 seconds after each change. If the app or the computer stops, the next start reopens those circuits in their own tabs, marked unsaved, with the message "Recovered N unsaved circuit(s) from <date>. Save to keep it."

In the desktop app, closing the window with unsaved tabs asks Save before closing BetterSPICE? with Save, Don't save and Cancel. Save saves every unsaved tab, asking for a name where there's none.

cautionDon't save cannot be undone. Don't save discards your unsaved changes and also deletes the autosave copy, so BetterSPICE cannot recover the circuit at the next start. Choose Cancel to go back to your work, or Save to keep it.