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 I  LearnExplanationContentsIndex
08

The guided tours

BetterSPICE teaches itself on a practice circuit. The Quick intro takes about two minutes; the Full tour goes through every part of the app, a chapter at a time. Both ask you to do the thing, with your own mouse and keys.

08.1Start a tour

The first time BetterSPICE opens on a computer, a welcome card offers both. It shows once. Not now closes it and says where the tours are. They are always under Help: Quick intro and Full tour. The command palette (Ctrl+K) finds them too: type tour.

08.2What a step looks like

The window dims and turns gray everywhere except the part the step is about, which stays at full brightness inside a thin orange outline. A card sits beside it, never on top of it, with a pointer to the thing, a title, a sentence or two, Step N of M and a progress bar. The spotlight follows the real element when you resize the window or open a pane.

What a step looks like
On the cardWhat it does
Next and BackMove one step on or back. The first step has no Back. → or Enter is Next and ← is Back, on a step you only read.
Try it stepsWait for you. The card says Waiting for you until the change is really there (a part placed, a wire joining two pins, a probe added, a run started), then Done and Next. While it waits, only the highlighted area answers clicks.
Do it for meMakes the same change itself, so you can see it done. Ctrl+Z takes it back like any edit.
Skip stepGoes on without doing it. Later steps put in what they need themselves, so nothing gets stuck.
Not quiteA short correction when you did something else, for example placed a different part.
Skip tutorial or EscAsks Leave the tour?. Esc first closes a menu, a dialog or a tool you have open, then asks.

08.3Your own work is not touched

  • The tour works in its own tab, Practice circuit. Your circuits stay in their tabs, with their unsaved edits, undo history, selection and view, exactly as they were.
  • The practice circuit is never saved, never autosaved and never counted as unsaved changes, so closing the window in the middle of a tour asks nothing and leaves nothing behind.
  • What the tour changes in the window (the view, hidden panes, the dock tab, run or pause, the timebase, the library search) is put back when it ends.

08.4The Quick intro

Eight steps: find parts in the library, place a resistor (R), wire it in, close the loop, add a probe (P), run it and read the scope (Ctrl+R, 1 to 4), change a value while it runs, and where to come back to.

08.5The Full tour

Eleven chapters, listed when you start it. Pick any chapter; the list ticks the ones you finished and Continue takes you back to the step you left, even after you close the app.

The Full tour
ChapterCovers
1 The windowMenus, toolbar, library, sheet, inspector, dock, the command palette.
2 Drawing and editingPlace, move, rotate, name nets, undo, copy and delete.
3 Parts and the librarySearch, vendor filters, My parts, the Part Wizard, family keys.
4 ModelsVendor models, the ≠ datasheet note, Assign model, Edit a copy of a model, Quick model.
5 Live simulation and the inspectorPause and step, the timebase, changing a part while it runs, colours and current dots.
6 Probes, scopes and the dockProbes, trace chips, a second scope, the Bode and FFT tabs.
7 Simulate and analysisF5 transient, F7 AC sweep, the other analyses, the Analysis view.
8 Sheets, subcircuits and modulesCreate a module, open it, the pin window, the Monitor, back up.
9 Digital, control and MCUGates, the logic analyzer, the Console, controllers.
10 Reports, export and importThe report, image and netlist export, KiCad and EasyEDA Pro import.
11 Examples, AI agents and helpThe examples, working with an AI agent, the shortcut list, Help.