Bring work in and out
13.1Import a KiCad or EasyEDA Pro design
Open a schematic from another tool as a circuit that runs.
Before you startFor a hierarchical KiCad design, a zip of the whole project folder.
- Press Ctrl+I and choose the file:
.kicad_sch,.kicad_pro, a project.zip,.eproor.eprj. You can also drop the file on the window.You should see"Importing <file>…" while it runs, then a new tab and the Import report. - Read Not recognised in the report: parts placed as boxes. Click a row to select and zoom to its part.
- Click Assign model… on each IC that matters. reopens the report later.
- If the report added no supply, place a DC source on the supply net.
- Press Ctrl+R if the circuit is paused.You should seeThe board runs. Hold the pointer over a net to read its voltage.
ResultEvery net keeps the same pins as in the source. The report says how many it checked.
| If you see | Do this |
|---|---|
| "No supply in the imported circuit: add a DC source" | Place a DC source on the supply net. |
E_IMPORT_FORMAT | KiCad 5 files aren't read. Save the design in KiCad 6 or later. |
See alsoImporting KiCad and EasyEDA Pro.
13.2Save a picture, a plot or the data
Get the schematic, a plot or the numbers into a document or a spreadsheet.
- For the schematic, press Ctrl+Shift+P. Choose SVG for documents or PNG for slides, and Light (print) colours. Copy PNG puts the picture on the clipboard for a chat or a slide.
- For a plot, click PNG in the Analysis view's toolbar.
- For data, click Export CSV in the Analysis view, or right-click a scope and choose Export CSV.
ResultFiles named after the circuit, such as rc-filter.svg, transient.csv or scope1.csv.
| If you see | Do this |
|---|---|
| "Nothing to export: the sheet is empty." | Open the circuit you meant, or draw something first. |
| "Nothing to export: run an analysis first." | Run the analysis, then export. |
See alsoExport and reports.
13.3Write a report
Make one file that shows the circuit, every analysis you ran and whether it passes.
Before you startA circuit you have run. The report covers the analyses run in this session.
- Press Ctrl+Shift+G.You should seeA dialog with one tick box per section.
- Tick the sections you want. Tick Run what is missing to run analyses you have not run yet.
- Press Generate.You should seeA panel at the bottom shows the step, the runs and the time. Desktop: then a Save dialog for
name-report.html. Browser: the file downloads. - Open the file in a browser and print it to PDF if you need one.
ResultOne HTML file with the fonts inside. The summary lists every named measurement with PASS or FAIL and four verdicts. Further sections hold the parts against their ratings, each analysis, the tolerance results, the spectrum, the diagnostics and the netlist.
See alsoGenerate report.
13.4Send a circuit to someone who has no BetterSPICE
Let someone open your circuit and watch it run in a browser, with nothing to install.
- Choose .You should seeThe dialog shows the link, its length and the viewer address.
- Click Copy link and paste the link into your message.
- If the dialog says the link is too long or too big, choose instead and attach the file.
ResultThe circuit travels inside the link, after the #, and nothing is uploaded. The other person sees it running with the scope, the sliders and the inspector.
| If you see | Do this |
|---|---|
| The dialog offers no link | The viewer address is still the placeholder. Type your viewer address in the dialog, or use Export interactive HTML. |
| A part runs as a generic device in the viewer | The viewer has no vendor model library. Open the circuit in the desktop app once, so it stores the live equivalent in the file. |
See alsoShare link and interactive HTML, The browser viewer.
13.5Export a netlist for another simulator
Write the circuit as a SPICE netlist that ngspice runs.
- Press Ctrl+Alt+N.You should seeA message says where the
.cirfile went and how many symbol-only parts were left out. - Run it with
bspice ngspice file.cir, or in ngspice.
ResultHierarchical sheets are flattened and every model parameter is written out. Behavioural parts that ngspice has no equivalent for become comments.
| If you see | Do this |
|---|---|
E_EXPORT | The message gives the first problems and their fixes. The rest are in Diagnostics. |
See alsoExport SPICE netlist, Files and formats.
13.6Run simulations from a script
Check and simulate circuits without the window, for scripts and build servers.
- Open a terminal in the install folder, or add it to your path.
- Check a folder of circuits:
bspice validate examples. - Run an analysis to CSV:
bspice tran rc.bsc --stop 10m --max-step 10u --out run.csv. - Use the exit code: 0 success, 1 diagnostics with errors, 2 a usage error.
ResultThe same engine and the same files as the app. Vendor-model runs need the app, or export-spice and ngspice.
| If you see | Do this |
|---|---|
| Unknown option | The message lists the options that command knows. |
| A value a thousand million times off | On the command line 1M is milli. Write 1meg. |
See alsoThe command line (bspice).
13.7Hand a task to an AI agent and check what it did
Let an AI agent edit and simulate the circuit you have open, while you watch.
Before you startClaude Code (or another MCP client) set up with the bspice mcp server (Setting up Claude Code).
- Open the circuit in the desktop app.
- Ask the agent, for example "Add a 10 µF output capacitor and show me the ripple."You should seeA bar at the top of the canvas names the agent and what it's doing. Its cursor moves to each part it touches.
- Press Esc or Take over at any time to stop it.
- Open Activity (Alt+7) to read every edit and run it made.
- Press Ctrl+Z to undo any of its edits.
ResultParts it changed carry an AI · name badge in the inspector. Parts and symbols it creates go to My parts.
| If you see | Do this |
|---|---|
| AI agents cannot connect | Set BSPICE_PORT to a free port for both the app and the agent. |
See alsoWorking with an AI agent.