emuStudio is a desktop application which allows emulation of various computers. Besides emulation, it contains source code editor, which can be used to write and then compile programs then to be instantly emulated. Virtual computers, as the emulators are called, are represented by plugins of various type (compiler, memory, CPU and device), combined in a computer configuration. The computer configuration can be opened during startup.
The application has also command-line interface, which allows executing automatic “load-compile-emulate” workflow, possibly without graphical interface. This workflow is called “automatic emulation” and has its specifics, discussed per virtual computer.
A logger is used by emuStudio which helps debugging of the application and plugins.
At first, please download emuStudio distribution. It is either a TAR or ZIP file in the form
emuStudio-[VERSION].zip. For Linux/Mac environments, a TAR variant will be more suitable since it preserves file attributes and execution permissions. Unpack the file where you want to have emuStudio installed.
Before running, Java 11 or later must be installed. Then, emuStudio can be run by executing the following script:
- On Linux / Mac
- On Windows:
NOTE: Currently supported are Linux and Windows. Mac is NOT supported, but it might work to some extent.
emuStudio accepts several command line arguments. Their description is accessible with
$ ./emuStudio --help Usage: emuStudio [-hV] [-cl] [-i=FILE] [-cn=NAME | -cf=FILE | -ci=INDEX] [COMMAND] Universal emulation platform and framework -cl, --computers-list list all existing virtual computers -h, --help Show this help message and exit. -i, --input-file=FILE input file name (source code) -V, --version Print version information and exit. Virtual computer -cf, --computer-file=FILE virtual computer configuration file -ci, --computer-index=INDEX virtual computer index (see -cl for options) -cn, --computer-name=NAME virtual computer name (see -cl for options) Commands: automation, auto run emulation automation
Automation command has its own usage:
$ ./emuStudio auto --help Usage: emuStudio automation [-hV] [--[no-]gui] [-s=ADDRESS] [-w=MILLIS] run emulation automation --[no-]gui show/don't show GUI during automation -h, --help Show this help message and exit. -s, --start-address=ADDRESS program start address -V, --version Print version information and exit. -w, --waitmax=MILLIS limit emulation time to max MILLIS (force kill afterwards)