# 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
  `jp` Japanese

`-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.

`-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`
`-test-fpga-implementation inputpath Circuitimapfile cicuitimpname cicuitimpboard`
`-test-circ-gen testCircPathInput testCircPathOutput`
`-questa[yes|no]`

Next: User's Guide.