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
20

Menus and the command palette

Every command lives in a menu. The same commands are in the command palette, and most have a key. The tables list each entry as the app shows it, read from the app's own command list.

20.1Using the menus

  • Click a menu title to open it. While one is open, moving the pointer over another title switches to it. Click outside to close.
  • Keyboard: F10 opens File. Up and Down move between entries, Left and Right switch menus, Enter runs, Esc closes.
  • Each row shows a tick when the setting is on, the label and the first shortcut. Greyed rows can't run now. Running one anyway, from the palette or a key, shows a message saying why, for example "Select a part first, then assign its model (or double-click the part)."
  • Long menus use two or three columns. A menu that would run off the right edge of the window moves left to fit. Submenus such as Place›Transmission line and View›Scope tools open to the side. From the keyboard, F10 and the arrow keys walk the menus, Right or Enter on a row with a ▸ opens its submenu and Left comes back.

20.2File

20.3Edit

20.4View

20.5Place

20.6Simulate

20.7Analysis

20.8Tools

20.9Examples

20.10Help

20.11Command palette

Ctrl+K opens a search box over every command and every part and model in the library. Type part of a name, for example exp png or tlv9062. The search matches letters in order, so a few letters are enough, and whole-word matches rank first. Up and Down choose, Enter runs, Esc closes. With nothing typed, it lists the last five commands you ran from it under Recent. Rows come in menu order (File, Edit, View …). Commands that can't run now are listed dimmed, after the ones that can, so the first row is never one you can't use. Enter on one says why, for example "Select a part first." or "Nothing to undo." Every row shows the command's menu and shortcut, so the palette is also the quickest way to learn the keys.

The command palette (Ctrl+K).
Figure 20.10The command palette (Ctrl+K).
Help › Keyboard shortcuts (?), with its filter box.
Figure 20.11Help › Keyboard shortcuts (?), with its filter box.

20.12Keyboard rules

  • Keys are matched by letter, so they work on any keyboard layout. With a non-Latin layout, punctuation keys follow the key position.
  • While you type in a text or number field, every shell shortcut with Ctrl or an F-key still works, and the field commits its text first: type a stop time, then press F5. Canvas keys such as Ctrl+Z and Ctrl+C act on the text in the field.
  • A focused slider keeps only its arrow, Home, End and Page keys, and a tick box or button only Space and Enter. Every other shortcut works.
  • While a dialog or menu is open, only Esc and Ctrl+K reach the app. E opens the examples only when no other dialog is open.
  • The symbol editor turns every other key off while it's open, except Esc.
  • Esc does the most useful thing first: in a dialog field, give up the edit of that field, then close a dialog, close a menu, take over from an AI agent, leave a placing or drawing tool, and then clear the selection. So typing 999 into a field and pressing Esc keeps the old value and leaves the dialog open. The next Esc closes it.

20.13About

Help › About BetterSPICE.
Figure 20.12Help › About BetterSPICE.

About lists the version, the live engine, the ngspice version, WebView2, Tauri, Windows and the settings folder (%APPDATA%\BetterSPICE). The browser version shows the version and engine only.

20.14The user guide

The user guide is this manual inside the app: the same text, tables and pictures, made from the same source files as the PDF, so the two cannot differ. It is part of the app, so it works offline, in both themes. Open it with Help›User guide, with the F1 help hint at the right end of the status bar, or with F1.

F1 opens the section about the thing under the pointer

  • Point at something and press F1. A menu or a menu entry, a toolbar button, a library group or tile, the inspector and its fields, a dock tab, a plot, the status bar, or a dialog and its tabs and steps: the guide opens at the section that explains it. Pointing at Run opens Run, pause, step and reset, and pointing at the Bode tab opens Bode tab.
  • On the schematic, a part opens the entry for its type, for example Resistor or MOSFET (N, P) in Devices: passives and Devices: semiconductors. A wire opens Wires, a net label, power flag or ground opens Labels, flags and ground, and a module box opens Hierarchical sheets and buses. A diagnostic marker opens its code in the table in Every code, A to Z.
  • With the pointer over nothing in particular, F1 opens the guide where you left it, at the contents the first time.
  • From the keyboard, move to a control with Tab and press F1: the guide follows the keyboard focus when you have not moved the pointer since.
  • It works while a dialog or menu is open, without closing it: the guide appears in front. In a text or number field, F1 leaves the text and the caret alone, and the field keeps what you typed.
  • In a pop-out window (a scope, the dock, the Analysis view), F1 opens the guide in that window.

Using the guide

  • The Contents button, and the tree beside the text when the panel is wide, list every chapter. Links in the text jump to the section they name, and Back and Forward (Alt+Left, Alt+Right, or the mouse side buttons) walk your path.
  • The search box finds every section that has all the words you type, best first. Enter opens the first. The words are marked in the section you open.
  • Find (Ctrl+F) searches the section you are reading and steps through the matches with Enter and Shift+Enter. Click a picture to enlarge it, and click it again to shrink it.
  • Three buttons choose where the guide is shown: a floating panel on the right of the window (the default, wide enough to read beside the circuit, and drag its left edge to resize it), a Guide tab in the dock, or its own pop-out window. The panel and the tab are remembered. Esc closes the panel.
  • PDF in the guide's bar, and Help›User manual (PDF), open the printable manual where the PDF is installed.