Menu

Theme

Advanced features · How-to · CHECKED ON 5.0.0

Logisim library: loading, merging files and copying circuits

The Logisim library route depends on what you need. To reuse a circuit from another .circ file, Logisim-evolution 5.0.0 offers File, Merge… (Ctrl+M), which copies chosen circuits into your project, and Export Circuit in a circuit's right-click menu, which saves one circuit to a new file. You can also load the other file as a library (Project, Load Library, Logisim-evolution Library…), which keeps it linked by a relative path instead of copying it. The TTL chips are built in, so most people need no external library.
FOR
Students combining work from two files, and teachers sharing component libraries
CHECKED
12 Nov 2026
Checked against Logisim-evolution 5.0.0 on 1 machines
On this page

Copy one circuit into another file

Method Copies or links Where it is Tested
File, Merge… Copies the circuits you choose File menu, Ctrl+M yes
Export Circuit Writes one circuit to a new file Right-click the circuit in the explorer yes
Load as a library Links, no copy Project, Load Library yes
Copy and paste between windows Copies selected parts Edit menu, Ctrl+C and Ctrl+V yes, plain parts

Merge

  1. Open the project that should receive the circuit

    Open your own file. Nothing is added until you confirm the dialog.

  2. Choose File, Merge…

    A file chooser opens with the current file name filled in. Pick the other .circ file.

  3. Tick the circuits

    The dialog says Select circuit(s) to merge into the project and lists the circuits of that file. Include dependencies is ticked by default, and a line below counts the selected circuits. Press OK.

LAB lab-lnx · Linux lab5.0.02026-11-12

The Merge dialog: a list with one circuit named fadd, a ticked box Include dependencies and the line Total to merge: 1 selected circuit(s).

The Merge dialog lists the circuits of the chosen file.lab-lnx-le500-merge-dialog-01
Merge dialog listing one circuit, fadd, with Include dependencies ticked.
LAB lab-lnx · Linux lab5.0.02026-11-12
After the library is unloaded, the merge copies fadd into the project as an ordinary circuit.lab-lnx-le500-merge-result-01
The explorer pane after the merge: a circuit named fadd now sits next to main at the top level, with no library folder.
LAB lab-lnx · Linux lab5.0.02026-11-12

An error dialog saying circuit fadd cannot be merged because the project already has a circuit of the same name in the loaded library components.

Merging fails while a library with the same circuit name is loaded. The dialog suggests unloading the library or renaming the sheet.lab-lnx-le500-merge-conflict-01
Error dialog: circuit fadd cannot be merged because a loaded library already has a circuit of that name.

Export Circuit

Right-click a circuit in the explorer and choose Export Circuit. The menu entry is not in the Project menu. A save chooser opens with the circuit name as the file name, and a message confirms Circuit successfully exported to the file.

LAB lab-lnx · Linux lab5.0.02026-11-12

The right-click menu of a circuit in the explorer, with Export Circuit between Get Circuit Statistics and Set As Main Circuit.

Export Circuit lives in the circuit context menu in the explorer.lab-lnx-le500-export-circuit-menu-01
Right-click menu of a circuit in the explorer, with Export Circuit highlighted among its items.

In our test the exported file had the exported circuit as its main circuit and nothing else. A circuit with no dependencies showed no dependency dialog; we did not export one with dependencies, so we do not describe that dialog.

Copy and paste

Two windows of the same Logisim session share a clipboard for parts. After File, Extract and open project bundle… we had two windows open; Ctrl+A and Ctrl+C in one, then Ctrl+V in the other, attached the pasted pins to the pointer and marked that project modified.

LAB lab-lnx · Linux lab5.0.02026-11-12

Two Logisim windows open; in the front window a pasted selection of two pins (Pin x 2) is attached to the pointer and the project name is marked modified.

Parts copied in one window were pasted into another window of the same session.lab-lnx-le500-paste-between-windows-01
Two Logisim windows; a pasted pair of pins is attached to the pointer in the front window.

Load a .circ file as a library

  1. Open Project, Load Library

    The submenu has three items: Built-in Library…, Logisim-evolution Library… and JAR Library….

  2. Pick the .circ file

    Choose Logisim-evolution Library… and select the file. A folder named after the file appears in the explorer with its circuits inside.

  3. Save

    The project is marked modified. Saving writes the link.

LAB lab-lnx · Linux lab5.0.02026-11-12

The Project menu of Logisim-evolution 5.0.0 with its Load Library submenu open, showing Built-in Library, Logisim-evolution Library and JAR Library.

Project, Load Library has three items: Built-in Library (a submenu), Logisim-evolution Library and JAR Library.lab-lnx-le500-libraries-01
Project menu with the Load Library submenu open: Built-in Library, Logisim-evolution Library, JAR Library.
LAB lab-lnx · Linux lab5.0.02026-11-12
A loaded .circ library appears as a folder named after the file. Its circuits can be placed but not edited here.lab-lnx-le500-libraries-02
The explorer pane after loading a library file: a folder named components with one circuit, fadd, below the built-in folders.

The link is stored as a relative path next to the library file, for example file#components.circ. No circuit is copied, so the library file must travel with yours. See the .circ file for where the line sits in the file.

circ-libraries-uses-library · mainscroll to see all
XY
A main file that loads the library below by relative path. The circuit itself is only a pin wired to a pin. CC BY 4.0 · SHA-256 c8f6e33d65bb
Describe this circuit

Components: Input pin X; Input pin Y.

  • Input pin X connects to Input pin Y (net X, Y).

Download circ-libraries-components.circ (the library, one circuit named fadd) and circ-libraries-uses-library.circ. Keep them in the same folder. Both were saved by 5.0.0 and do not open in 2.7.1.

If the library file moves

When the library file is missing, Logisim shows The required library file is missing and a file chooser follows so you can point to the new place (more on files that will not open).

LAB lab-lnx · Linux lab5.0.02026-11-12

An information dialog: the required library file components.circ is missing, please select the file from the following dialog.

The message shown when a library file has moved.lab-lnx-le500-library-missing-01
Dialog saying the required library file components.circ is missing and asking you to pick it.

Built-in libraries

A new file loads Wiring, Gates, Plexers, Arithmetic, Floating Point Arithmetic, Memory and Input/Output. Other built-in libraries are added from Project, Load Library, Built-in Library…. The counts below are components per library in our component data for 5.0.0 and 2.7.1; see all components.

Components per library, from our component data.
Wiring14
HDL-IP2
Arithmetic13
Floating Point Arithmetic18
TTL65
Gates13
BFH mega functions2
Plexers5
Base1
Input/Output17
Input/Output Extra7
TCL2
Memory11
System On a Chip8

TTL and IC libraries

Logisim-evolution 5.0.0 has 65 TTL chips built in, including the 74181, so you do not need to download a TTL library. The TTL page lists them. Classic 2.7.1 has none.

JAR libraries

Project, Load Library, JAR Library… opens a chooser for .jar files.

LAB lab-lnx · Linux lab5.0.02026-11-12
Project, Load Library, JAR Library opens a chooser filtered to .jar files.lab-lnx-le500-jar-chooser-01
A file chooser titled for Java Archive files (*.jar), with an empty file list and a File Name field.

We built a tiny library of our own (a Java class that extends the Library class, one tool, and the manifest line Library-Class: DemoLib). It loaded and showed up as a folder.

LAB lab-lnx · Linux lab5.0.02026-11-12
A loaded JAR library appears as a folder with the name the library gives itself.lab-lnx-le500-jar-loaded-01
The explorer pane with a new folder named Demo library below Input/Output after a JAR library was loaded.
  • Saved form. Saving wrote jar#demolib.jar#DemoLib: a path relative to the project, then the class name.
  • Name clash. A first version whose tool was the built-in Constant was refused: Library contains following tool present in the workspace.
  • No manifest line. A JAR without Library-Class made Logisim ask for the class name. We could not enter a valid name with our key driver, so we do not know what happens after a correct name.
LAB lab-lnx · Linux lab5.0.02026-11-12
A JAR library whose tool has the same name as one already in the project is refused with this message.lab-lnx-le500-jar-name-clash-01
An error dialog: Library contains following tool present in the workspace: CONSTANT.

Send the whole project as one bundle

File, Export project bundle… (Ctrl+Shift+E) asks for a file name ending in .lsebdl, then a form for the project name, authors, keywords and description.

LAB lab-lnx · Linux lab5.0.02026-11-12
File, Export project bundle first asks where to save the .lsebdl file.lab-lnx-le500-bundle-save-01
A save chooser for a Logisim project bundle (*.lsebdl) with the file name uses-lib.lsebdl.
LAB lab-lnx · Linux lab5.0.02026-11-12
After the file name, a form collects the bundle metadata.lab-lnx-le500-bundle-metadata-01
A form with Project name, Authors, Keywords and Project description fields and Save and Cancel buttons.

This is the easy way to hand in a project that depends on a library file.

Substitute a library from the command line

The 5.0.0 help lists --substitute lib1 lib2, which substitutes one library for another. It works in a headless run (F135), with two conditions: write lib1 exactly as the library name is stored in the circuit file (for a library saved next to the file, just libA.circ), and keep the original library present, because a missing library stops the run at a prompt before any substitution.

We used a main file that loads libA.circ, whose circuit adder inverts its input, and a replacement libB.circ whose adder passes the input through. The input was a constant 1.

Terminal
java -jar logisim-evolution-5.0.0-all.jar --tty table user.circ
Y
0
java -jar logisim-evolution-5.0.0-all.jar --tty table --substitute libA.circ libB.circ user.circ
Y
1

-s is the short form, the option can also come after the file name, and the second name can be a path. An absolute path as the first name did nothing in our run. The replacement needs a circuit with the same name and pins as the one it replaces. The command line page covers the other options.

Not tested

We did not test loading libraries automatically at startup, more than one substitution pair, the Add main circuit prefix option, an export of a circuit with dependencies, or pasting circuits that contain subcircuits.

See also subcircuits, the usual way to reuse a circuit inside one file.

For VHDL entities and HDL export, see VHDL and Verilog.

Frequently asked questions

How do I copy a circuit from one Logisim file to another?

Use File, Merge… and pick the file, or right-click the circuit in the explorer and choose Export Circuit to save it to its own file. Both worked in our 5.0.0 test (F118).

Why can't I paste between two Logisim windows?

In our test pasting two pins between two windows of the same session worked (F124). If it fails for you, Merge and Export Circuit do not depend on the clipboard.

Where is the TTL library in Logisim-evolution?

It is a built-in library with 65 chips. Add it from Project, Load Library, Built-in Library… if it is not in your explorer.

How do I load a JAR library?

Project, Load Library, JAR Library… is the menu item. A tiny JAR we built loaded fine (F124). A JAR runs code on your computer, so load only ones you trust.

What happens if I move a library file?

Logisim stores the library as a relative path. When the file is missing it says so and opens a file chooser so you can point to it (F118).

Sources

  1. Library, merge and export tests on Logisim-evolution 5.0.0, logisim.dev lab data: test-data/lab25-2026-11-12-libraries/, src/content/circuits/circ-libraries-*

Try: , , ,