BeebEm - BBC Micro and Master 128 Emulator

Command Line Options

The following command line options can be passed to BeebEm:

-Data <directory>	Use a specified data directory
-Prefs <file>	Preferences file to load
-Roms <file>	ROMs configuration file to load
-EcoStn <station>	Econet station number
-EcoFF <timeout>	Econet flag fill timeout, see the econet section
-FullScreen	Start in full screen mode
-DisMenu	Disables the drop down menus
-KbdCmd <cmd>	Keyboard command string to run (see below)
-NoAutoBoot	Disable auto-boot when disk image specified
-DebugScript <file>	Open debugger and execute the commands
<disk image file>	Disk image file to load. Two files can be specified for drives 0 and 1.
<tape file>	Tape file to load
<state file>	Save state file to load

Note: Command line options -Model and -Tube are no longer supported. Use the -Prefs option with different preferences files instead.

If you create a shortcut to BeebEm.exe on your desktop and edit the properties (right click the icon) you can add command line options and a disc, tape or state file name to the target box. Running the shortcut will then run the file.

These command lines can be put into Windows scripts. See the BeebEmLocal.vbs and BeebEmTorch.vbs scripts for examples.

You can also associate files with .ssd, .dsd or .uef extensions with BeebEm using Windows Explorer. Double clicking on one of these files will automatically run it in BeebEm.

Command line examples:

Run Zalaga with its own preferences	BeebEm -Prefs ZalagaPrefs.cfg Zalaga.ssd
Run the Torch Z80 with its own preferences	BeebEm -Prefs Torch.cfg -Roms Roms_Torch.cfg
Run BeebEm with an alternative set of data files	BeebEm -Data \Users\Mike\Documents\BeebEmGames
To run BeebEm from a USB drive and access the local USB drive data	BeebEm -Data -
To load and run the test tape image	BeebEm -KbdCmd "OSCLI\s2\STAPE\s2\S\nPAGE=3584\nCH.\s22\S\n" test.uef

Command Line Parameter Notes

If the specified <data directory> does not exist BeebEm will offer to create it. BeebEm will copy a default set of data to the data directory. The default data directory is 'My Documents\BeebEm'. If a data directory of "-" is specified BeebEm will use the "UserData" directory where the BeebEm.exe file exists (this is useful for running from a USB drive).

The preferences and ROMs configuration file names are relative to the data directory.

If a disk image or a state file name is passed to BeebEm on the command line it will be run automatically (but see -NoAutoBoot option). The name can include the full path or it can just be the name of a file in the 'DiscIms' or 'BeebState' directory.

If a tape image name is passed to BeebEm on the command line it will be loaded. The name can include the full path or it can just be the name of a file in the 'Tapes' directory. To run the tape image use the -KbdCmd option.

Startup Key Sequence

The -KbdCmd option allows a string of key presses to be passed to BeebEm. The string can include the following key sequences:

String	Key Sequence
\n	press and release of enter/return
\s	press shift
\S	release shift
\c	press control
\C	release control
\\	press and release of \ key
0-9	press and release of a number key
A-Z	press and release of a letter key
'-=[];'#,./	press and release of a symbol key
\dNNNN	set inter-keypress delay to NNNN milliseconds. Note that very low delays can result in loss of presses.

So, for example, run a tape image using commands such as:

BeebEm -KbdCmd "OSCLI\s2\STAPE\s2\S\nPAGE=3584\nCH.\s22\S\n" test.uef

BeebEm -KbdCmd "OSCLI\s2\STAPE\s2\S\nOSCLI\s2\SRUN\s2\S\n" game.uef