Command-line options

You can configure many of Logisim's application preferences via command line options. This can be particularly useful in a laboratory of single-student computers where you want Logisim to start up the same for students every time, regardless of how previous students may have configured the program.

The overall command-line syntax is as follows.

java -jar jarFileName [options] [filenames]

The optional additional files named on the command line will be opened as separate windows within Logisim.

The following example starts Logisim in its basic configuration.

java -jar jarFileName  -plain -gates shaped -locale en

Supported options include the following.

-plain
-empty
-template templateFile

Configures the template for Logisim to use.

-gates [shaped|rectangular]

Configures which type of gate to use.

-locale localeIdentifier

Configures which translation to use. As of this writing, the supported locales include:

de German
el Greek
en English
es Spanish
fr French
pt Portugais
ru Russian
it Italian
nl Dutch
-accents [yes|no]

This is only relevant for languages that use characters outside the 7-bit ASCII character set; this would include languages using accented characters, and it would not include English. If no, characters outside the 7-bit ASCII character set are replaced with equivalents appropriate to the language; this would be useful for Java/OS combinations where such characters are not supported well.

-clearprops

Clear all application preferences at startup, so Logisim will act as if it were being executed on the host system for the first time.

-nosplash

Hides the initial Logisim splash screen.

-help

Displays a summary of the command line options.

-version

Displays the Logisim version number.

-noupdates

Do not update the software.

-analyze

Displays the combinatorial analysis menus.

-load filename

Load an image in RAM (works only with -tty)

-sub file1 file2

load the file by replacing the library file (file1) with the library file (file2). More information in Substituting libraries

-tty [table|speed|tty|halt|stats]

Run without GUI. More information in Other verification

-testvector circuitname vectorfile projectfile

Run the circuitname tests in projectfile based on vectors in vectorfile. More information in Window Text Vector

-geom WxH|WxH+X+Y

Opens Logisim with a window dimensioned according to the parameters W (width) and H (height) or with the upper left corner positioned according to the parameters X,Y.
Example: -geom 600x400+100+100

Undocumented Options

-test-circuit testCircuitPathInput
-testvector
-test-fpga-implementation inputpath Circuitimapfile cicuitimpname cicuitimpboard
-test-circ-gen testCircPathInput testCircPathOutput
-questa[yes|no]

Next: User's Guide.