Getting started
What is Logisim?
A free program for designing and simulating digital logic circuits on screen. The original Logisim by Carl Burch stopped at version 2.7.1; Logisim-evolution is the maintained continuation and is what most people should use today.
Next step: What is Logisim
Is Logisim free?
Yes. Classic Logisim is GPLv2 and Logisim-evolution is GPLv3, both free to download and use. Beware download portals that repackage them: use the links on our download page.
Next step: Download safely
How do I use Logisim-evolution?
Install it, choose File, New, pick components from the library tree on the left and place them on the canvas, join them with wires, and use the Poke tool to change inputs and watch outputs. Our tutorial walks through a half adder in about 15 minutes.
Next step: Start the tutorial
Which version should I install?
Use the version your course names. If it names none, use Logisim-evolution 5.0.0. Files saved by 5.0.0 do not open in classic 2.7.1 (F04), so everyone who exchanges files should use the same version.
Next step: Which version to use
Is Logisim still developed?
Classic Logisim stopped at 2.7.1 in 2011. Logisim-evolution is active: version 5.0.0 was released on 12 Sep 2026 according to our data, checked on 9 Nov 2026.
Next step: Release history
Who makes Logisim-evolution?
A group of open-source developers on GitHub. This site is independent: we are not the developers, we do not host the program and we do not speak for them.
Next step: Independence
Installing and running
Do I need Java?
Not with an installer: every installer carries its own Java runtime (F27). The plain jar file needs Java 21; Java 8 and 17 fail with a class-version error (F20).
Next step: Java requirements
Why does my Mac say Logisim-evolution is Not Opened?
On macOS 15 a downloaded copy shows “Logisim-evolution” Not Opened with the text that Apple could not verify it, and buttons Done and Move to Trash, with no Open button (F64). The app is not notarized (F29). Click Done, then try System Settings, Privacy & Security, Open Anyway; we have not tested that override.
Next step: Install on macOS
Can I use Logisim on a Chromebook, iPad or phone?
Chromebooks run Linux apps in a Debian container, and the 5.0.0 .deb installs and runs in a Debian 12 container (F59); we did not test a physical Chromebook. logisim.app runs classic Logisim in the browser, and it opened in emulated iPad and phone browsers (F63), though that does not prove touch use is comfortable.
Next step: Logisim online
Is there an online version?
logisim.app runs classic Logisim in the browser. In our desktop check it was usable after 5 to 15 seconds and transferred about 28.7 MB (F50). It opens classic files only.
Next step: Logisim online
Why does apt install logisim give me an old version?
On Ubuntu 24.04 the package installs classic 2.7.1, not Logisim-evolution (F22). Use the official .deb or another route from the Linux page.
Next step: Install on Linux
Why does the Snap install version 3.8.0?
The Snap we checked was version 3.8.0 from 2023 and printed a GTK error on start (F53). The Flathub package was 5.0.0 when we checked (F52).
Next step: Install on Linux
Why can't the Flatpak see my files?
It is allowed to read and write only your home folder (F52), so files on other drives or in /tmp are not visible to it. Move the file into your home folder.
Next step: Install on Linux
Can I install it with winget, Chocolatey or Scoop?
winget installs the MSI and verifies its hash (F56). Chocolatey and Scoop install the jar, so you also need Java 21 (F57).
Next step: Install on Windows
How do I reset Logisim's settings?
5.0.0 has a --clear-prefs command-line option that clears saved preferences at startup. We did not run it. Uninstalling the Windows MSI leaves preferences behind (F26).
Next step: Command line options
Using Logisim
What do the wire colours mean?
Red (E) means two outputs drive the wire with different values. Blue (U) means nothing drives it. Orange with “Incompatible widths” means the connected components have different bit widths. Grey everywhere after opening a file means the values are not shown yet: click the canvas or press Ctrl+R.
Next step: Wire colours
Why are all wires grey after I open a file?
Click once on the canvas or press Ctrl+R (Command R on a Mac). We saw it on Linux, a Windows desktop and macOS 15, also with files saved by 5.0.0 (F45, F49, F64).
Next step: Wire colours
What does E mean in Logisim?
Error: two drivers on one wire disagree, so the net shows E and is drawn red. If both drivers give the same value, that value shows (F07).
Next step: Error messages
What does U mean in Logisim?
Unknown: nothing drives the net. It shows U in tty output and the wire is drawn blue (F08).
Next step: Wire colours
What does a red wire mean?
Two outputs drive the same wire with different values (E, F07). Remove one driver or use a controlled buffer to share the wire.
Next step: Wire colours
Why is my clock not ticking?
In our test the clock stayed idle until ticks were enabled: Simulate, Auto-Tick Enabled (Ctrl+K), or step with Ctrl+T (F81, F82).
Next step: Clock and simulation
How do I make a subcircuit?
Add a circuit with Project, Add Circuit, build it with labelled pins, then place it in another circuit from the tree. Our guide shows it with a 4-bit adder.
Next step: Subcircuits
How do I get a truth table of my circuit?
Choose Project, Analyze Circuit and open the Table tab. To go the other way, our truth table tool turns a table into a circuit.
Next step: Combinational Analysis
What is the maximum bit width?
Upstream describes 64 bits in Logisim-evolution and 32 in classic 2.7.1. Our test vector tool accepts widths from 1 to 64, the range 5.0.0 accepted (F107).
Next step: Splitter and buses
Does Logisim autosave?
Logisim-evolution has an Autosave tab in Preferences (F47). We did not test what it recovers after a crash.
Next step: Interface and preferences
Files
How do I open a .circ file?
Open it in Logisim with File, Open. To look at a file without installing anything, our viewer shows which version saved it, its pins and a drawing, in your browser.
Next step: The .circ viewer
Why won't my file open in Logisim 2.7.1?
Every file saved by 5.0.0 declares a library that 2.7.1 does not have, so it stops with a file error naming FPArithmetic (F04). Open it in 5.0.0, or ask for a copy saved in classic format.
Next step: The .circ file
Why does 5.0.0 warn Old file format?
The file was made by original Logisim. 5.0.0 says some components have evolved and converts labels to names valid in VHDL (F02). Dismiss the dialog and check your labels.
Next step: The .circ file
How do I copy a circuit from one file to another?
Use File, Merge… (Ctrl+M) to bring circuits from another file into the open project (F46). We did not test every case.
Next step: The .circ file
How do I export an image?
File, Export Image… in the main window; the timing diagram has its own export with six file types (F97).
Next step: Timing diagrams
Courses and grading
My course uses an older version. Can I use 5.0.0?
Only if everyone who exchanges files can open them. 5.0.0 files do not open in 2.7.1 (F04). Check your course page first.
Next step: Which version to use
How do I test my circuit automatically?
Write a test vector and load it with Simulate, Test Vector…, or build and check one with our tool. For grading from the command line see the autograder recipe.
Next step: Test vectors
Why did the autograder fail when my circuit works?
Usual causes are a pin label that differs in capitals or spelling, a missing pin, a main circuit not named as the lab says, or a file that opens a dialog (F102).
Next step: Test vectors
About this site
Is logisim.dev official?
No. We are an independent guide with no connection to the Logisim developers, and we say so on every page that needs it.
Next step: Independence
Where do your downloads come from?
We do not host Logisim. Our download page links only to the developers' own release pages and the package managers we tested.
Next step: Download safely
How do you test?
On a Linux lab and GitHub-hosted runners, with every claim tied to a finding ID. Where we could not test, the page says so.
Next step: How we test
I found a mistake.
Please tell us. Our corrections page explains how, and lists what we have fixed.
Next step: Corrections
To reuse a circuit from another file, see libraries, merging and copying circuits.
To put a circuit in a report, see export images and print.