Skip to content

Command Line Arguments

Jump to bottom Edit New page
Adrien Bertrand edited this page May 14, 2026 · 18 revisions

To run CEmu from the command line, use the name of the CEmu program followed by the various switches. Some switches require an additional argument; see below for the various types of available switches.

CEmu <switches>

Switches

-s <file>, --send <file>

Sends the file to the emulator. This may force a calculator reset. To specify multiple files, use multiple switches, i.e:

-s <file 1> -s <file 2> -s <file n>

-a <file>, --send-arch <file>

Behaves just like the -s switch, but forces files to be stored in the archive.

-m <file>, --send-ram <file>

Behaves just like the -s switch, but forces files to be stored in RAM.

-r <rom file>, --rom <rom file>

Forces CEmu to load a new rom rather than the preconfigured ROM image.

-t <autotester file>, --auto-test <autotester file> [--no-test-dialog]

CEmu forces a calculator reset and executes the file with the AutoTester. --no-test-dialog is optional and suppresses the output of the test statistics from the AutoTester.

-g <settings file>, --settings <settings file>

Uses an external file to load the configured settings. This is uses an ini configuration file.

-i <image file>, --image <image file>

CEmu uses the supplied image file to begin emulation.

-d <debug file>, --debug-info <debug file>

Imports the debugging information for the CEmu debugger.

--speed <percentage>

Sets the emulation speed for the emulated calculator.

-u, --unthrottled

Sets CEmu to run at unthrottled speed after boot.

-n, --no-state

Do not load the saved image state from the settings

--reload-rom

Force a rom reload

--no-reset

Do not reset when sending files (Might cause emulated crashes if not at homescreen)

--id <string id>

Command line arguments are routed to the specified CEmu id. This allows you to send commands directly to a current CEmu process. The id is specified in the title of the window; i.e. CEmu | Calculator would have id Calculator.

--screenshot <file>

Saves a PNG screenshot of the calculator display to the given filepath. Only used when also using --id to send a command to a running process.

--launch <prgm>

Launch the program specified by prgm.

--keys <sequence>

Presses physical calculator keys from a comma-separated sequence.

Examples:

--keys clear,clear,clear,1,2,3,+,4,5,6,enter
--keys 2nd,mode,delay:250,enter
--keys down:right,delay:100,up:right

The sequence parser is exact and case-sensitive. It does not trim spaces.

Supported sequence steps:

  • keyName or press:keyName: press and release a key
  • delay:<ms>: wait for the specified number of milliseconds
  • hold:keyName:<ms>: hold a key for the specified number of milliseconds, then release it
  • down:keyName: press and hold a key
  • up:keyName: release a key

Accepted key names:

graph, trace, zoom, window, wind, y=, yequ, 2nd, mode, del,
on, sto, ln, log, ^2, sq, -1, inv, math, alpha,
0, 1, 4, 7, comma, sin, apps, xton, xtn,
dot, 2, 5, 8, lpar, cos, prgm, stat,
(-), neg, 3, 6, 9, rpar, tan, vars,
enter, +, add, -, sub, *, mul, /, div, ^, pow, clear, clr,
down, left, right, up

The literal punctuation key names ,, ., (, and ) are also accepted, but , cannot be used directly in --keys because comma separates sequence steps. Use comma instead.

When used with --id, the key sequence is sent to the matching running CEmu process.

-?, -h, --help

Lists all available command line arguments. (Not all of them are on this page.)

Add a custom footer

Clone this wiki locally