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  LearnHow-toContentsIndex
01

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

  1. 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).
  2. 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.

  1. 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
  2. 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. betterspice without -full leaves 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. Help›Check for updates asks at once. To turn the check at the start off, clear Check at every start in that dialog.

  1. 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.
  2. Click Update.You should seeThe download and its check. You can keep working: the open app does not change until it starts again.
  3. 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 Help›What's new 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. Help›Install patch file 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.

tipNext. Run the Quick start, or build your first circuit in Tutorial 1: Draw an RC filter and watch it run.