Menu

Theme

Advanced features · Reference · CHECKED ON 5.0.0

How to save Logisim file: .circ saving, opening and version compatibility

A .circ file is a Logisim project saved as plain XML text. How to save Logisim file: choose File, Save (Ctrl+S) and open it with File, Open. The second line of the file records which version saved it (for example source="5.0.0"). Logisim-evolution 5.0.0 opens classic 2.7.1 files after a compatibility warning, but classic 2.7.1 cannot open files saved by 5.0.0. Keep a copy before saving an old file in a newer version. Right after opening a file in 5.0.0 the wires look grey: click once on the canvas or press Ctrl+R.
FOR
Students saving, submitting and converting files
CHECKED
11 Nov 2026
Checked against Logisim-evolution 5.0.0 on 3 machines
On this page

Save and open correctly

Use File, Save (CtrlS (⌘S on macOS)), File, Save As (CtrlShiftS (⌘⇧S on macOS)) and File, Open (CtrlO (⌘O on macOS)), or File, Open Recent. One file holds all of a project’s circuits.

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

The File menu in Logisim-evolution 5.0.0 on Linux: New, Merge, Open, Open Recent, Close, Save, Save As, Extract and open project bundle, Export project bundle, Export Image, Print, Preferences and Exit, with their shortcuts.

The 5.0.0 File menu (F46). Linux lab.lab-lnx-le500-menu-file-01
The File menu of Logisim-evolution 5.0.0 on Linux, from New to Exit, with shortcuts.

The File menu also has Export project bundle and Extract and open project bundle (F46). We did not test them.

Which version made this file?

Open the file in a text editor. The second line is the project element, and its source attribute holds the version that saved it, for example source="5.0.0" or source="2.7.1". The format version, version="1.0", stays the same.

Inside a .circ file

The top of our own 5.0.0 half-adder file:

circ-tutorial-half-adder.circ
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<project source="5.0.0" version="1.0">
This file is intended to be loaded by Logisim-evolution v5.0.0(https://github.com/logisim-evolution/).

<lib desc="#Wiring" name="0"/>
<lib desc="#Gates" name="1"/>
<lib desc="#Plexers" name="2"/>
...
<main name="main"/>
<options>
  <a name="gateUndefined" val="ignore"/>
  <a name="simlimit" val="1000"/>
  <a name="simrand" val="0"/>
</options>
<mappings/>
<toolbar> ... </toolbar>
<circuit name="main"> ... </circuit>
</project>

In order:

  1. An XML declaration.
  2. The project element with source (the version that saved the file) and version (the format version).
  3. A free-text line naming the program the file is for.
  4. One lib element per library. Built-in libraries have a desc starting with #, such as #Wiring or #Gates; the name number is what components use to say which library they come from. A loaded .circ or .jar library shows a file path.
  5. main: which circuit is the main one.
  6. options: the project’s simulation options. 5.0.0 files record simlimit (1,000) and simrand; our classic files use sim_limit.
  7. mappings and toolbar: keyboard mappings and the toolbar. A file with an empty toolbar opens with no tool buttons (F83).
  8. One circuit element per circuit, with comp entries (library number, location, component name and a attribute pairs) and wire entries (from and to).
  9. ROM contents are stored in a contents attribute (F12, see ROM).

Compatibility between versions

FeatureOpened in 2.7.1Opened in 3.8.0Opened in 4.1.0Opened in 5.0.0
Saved by 2.7.1Opened in 2.7.1: yesits own filesOpened in 3.8.0: untestedOpened in 4.1.0: untestedOpened in 5.0.0: partialopens with an Old file format warning; labels converted to VHDL-safe names (F02)
Saved by 3.8.0 or 4.1.0Opened in 2.7.1: untestedOpened in 3.8.0: untestedOpened in 4.1.0: untestedOpened in 5.0.0: untested
Saved by 5.0.0Opened in 2.7.1: nobuilt-in library FPArithmetic is not available (F04)Opened in 3.8.0: yesfour basic-component files gave correct tables (F68)Opened in 4.1.0: yesfour basic-component files gave correct tables (F68)Opened in 5.0.0: yesgrey until a click or Ctrl+R (F45)

Saved by 2.7.1

  • Opened in 2.7.1yesits own files
  • Opened in 3.8.0untested
  • Opened in 4.1.0untested
  • Opened in 5.0.0partialopens with an Old file format warning; labels converted to VHDL-safe names (F02)

Saved by 3.8.0 or 4.1.0

  • Opened in 2.7.1untested
  • Opened in 3.8.0untested
  • Opened in 4.1.0untested
  • Opened in 5.0.0untested

Saved by 5.0.0

  • Opened in 2.7.1nobuilt-in library FPArithmetic is not available (F04)
  • Opened in 3.8.0yesfour basic-component files gave correct tables (F68)
  • Opened in 4.1.0yesfour basic-component files gave correct tables (F68)
  • Opened in 5.0.0yesgrey until a click or Ctrl+R (F45)

The 3.8.0 and 4.1.0 results cover files that use only basic components. Files with parts new in 5.0.0 were not tested. Cells say untested where we did not run the combination.

What changes when 5.0.0 opens an old file

Labels are converted to names that are valid in VHDL (F02). The project’s notes say a 4.0.0 change to pin Type and Behavior can affect floating inputs, and that a 5.0.0 change affects RAM line enables; we did not test either.

Online and other tools

We did not test opening a 5.0.0 file in the online version of classic Logisim. It is expected to fail as 2.7.1 does. See Logisim online.

Convert a file to the current format

Open the old file in 5.0.0 and use Save As with a new name. Never overwrite the original. From the command line, --new-file-format in.circ out.circ converts a file, with three caveats: it needs a display, it stops at the compatibility dialog until it is dismissed, and it did not exit after writing in our test (F18). There is no safe way to convert from Evolution back to 2.7.1: rebuild the circuit, or use the version your course asks for (which version).

My .circ will not open

The built-in library FPArithmetic is not available in this version.

A file from 5.0.0 opened in 2.7.1: open it in Logisim-evolution instead (F04).

XML formatting error: …

The file is not a Logisim file. A browser download saved under a .circ name is a common cause; open it in a text editor and see whether it starts with an HTML tag.

The required library file ‘…’ is missing. Please select the file from the following dialog.

A library file moved. See Libraries. For anything else, look the message up in the error list.

Frequently asked questions

What is a .circ file?

Logisim's project file: XML text holding your circuits, their components and wires, and the project's options.

How do I save a Logisim file?

Choose File, Save (Ctrl+S), or File, Save As (Ctrl+Shift+S) for a new name. The file ends in .circ.

Can Logisim 2.7.1 open Logisim-evolution files?

Not a file saved by 5.0.0: 2.7.1 says the built-in library FPArithmetic is not available in this version (F04).

Can 5.0.0 open my old 2.7.1 file?

Yes, after a dialog titled Old file format, compatibility mode (F02). Keep a copy before you save it again.

Do files from 5.0.0 open in 4.1.0 or 3.8.0?

In our test four files that use only basic components gave the correct tables in both (F68). We did not test components that are new in 5.0.0.

Why are my wires grey when I open my file?

Click once on the canvas or press Ctrl+R. It happens with any file in 5.0.0 (F45, F49).

Sources

  1. File compatibility tests, logisim.dev lab data: test-data/lab5-2026-11-11-components2/logs/file-5.0.0-in-*.txt, test-data/lab1-2026-11-09-linux-local/logs/

Try: , , ,