Install and start
BetterSPICE installs in one step and opens on a circuit that's already running. ngspice comes with the installer, so you need nothing else for the tutorials.
01.1Install the desktop app
- Run
BetterSPICE_<version>_x64-setup.exe. You don't need administrator rights.You should seeThe installer finishes without questions. It installs for your user account, adds BetterSPICE to the Start menu, adds the Microsoft WebView2 runtime if Windows lacks it, and registers the file types.bsc(circuit),.bspart(part) and.bssym(symbol). - Start BetterSPICE from the Start menu.You should seeA bridge rectifier feeding an LDO opens, already running. The status bar at the bottom says ngspice 47 ready.If you seengspice not found, the tutorials still work. Only circuits with vendor models need ngspice. ngspice for vendor models says where BetterSPICE looks for it.
Double-click any .bsc file in Explorer to open it. If BetterSPICE is already open, the file opens in a new tab of the same window. Double-click a .bspart or .bssym file to add that part or symbol to My parts.
01.2Optional: PSpice for TI
You need this only for Texas Instruments models that Cadence has encrypted. Install the free PSpice for TI from ti.com into its default folder (C:\Cadence\PSpiceTI). BetterSPICE finds it and runs those models in it, hidden. PSpice for encrypted models explains the limits.
01.3NixOS
On NixOS, use the Nix package rather than the AppImage. It builds BetterSPICE from source on the system's own WebKitGTK, Mesa and graphics drivers, with ngspice from nixpkgs and the bspice command line. The installer's Linux/NixOS folder has the flake (the source), a prebuilt copy you can import without building, and a README with the NixOS and home-manager lines.
- Copy the flake folder to the NixOS computer and add the model library zip to the Nix store once:
nix-store --add-fixed sha256 BetterSPICE-0.2.1-Model-Library.zip
- Run it, or install it into your profile:
nix run .#betterspice-full nix profile install .#betterspice-full
You should seeThe BetterSPICE window. The status bar says that ngspice (nixpkgs'libngspice) is ready.betterspicewithout-fullleaves out the model library (about 3 GB).
The AppImage also runs on NixOS through run-betterspice-nixos.sh in the same folder (it uses appimage-run). If the window stays blank or the start stops with an EGL_NOT_INITIALIZED error, check that hardware.graphics.enable = true is set, then try WEBKIT_DISABLE_DMABUF_RENDERER=1 (BetterSPICE's default on Linux) or =0 in front of the command.
01.4Updates and patches
BetterSPICE keeps itself up to date from its private releases server. About two seconds after it starts it asks quietly whether there is a newer version, and an Update pill with the version number appears in the menu bar when there is. asks at once. To turn the check at the start off, clear Check at every start in that dialog.
- Click the pill.You should seeWhat changed, and how much there is to download. For a small change that is a patch: only the files that changed.
- Click Update.You should seeThe download and its check. You can keep working: the open app does not change until it starts again.
- Click Restart now.You should seeBetterSPICE closes, asking first about unsaved work, and starts again as the new version. A short panel lists what the version brings. It shows once, and opens it again.
You can also install a patch by hand, with no server and no internet. A patch is one file, BetterSPICE-<version>-Windows-Patch.exe. Double-click it: it finds the installed copy, says what will change and asks. takes the same file from inside the app. On Linux it is sudo ./BetterSPICE-<version>-Linux-deb-Patch, or -Arch-Patch on Arch.
A patch changes the app's own files only: your circuits, settings and parts, and the model library, stay as they are. Every file is checked against the release's signature before anything changes, and if a file can't be replaced, or the PC stops half way, every file is put back. An AppImage is replaced as a whole. A Nix install can't be changed from inside the app: update it from the new flake (see the NixOS README).
01.5The browser version
The same app runs in a current Chrome or Edge, without ngspice and PSpice. Desktop or browser lists every difference.