|
BeebEm - BBC Micro and Master 128 Emulator |
|
Command Line OptionsThe following command line options can be passed to BeebEm:
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:
Command Line Parameter NotesIf the data directory specified using the -Data or -CustomData option 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. The -Data option tells BeebEm to use a new data directory as the default data directory. The default is stored in the Windows Registry under 'HKEY_CURRENT_USER\Software\BeebEm\UserDataFolder'. The -CustomData option tells BeebEm to use a new data directory without changing the default. 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. -StartPaused is useful if you are scripting the launch of BeebEm and you want to manipulate the window, its position or perform other tasks before the emulated machine boots. In this kind of script, launch BeebEm, then send an Alt+F5 keypress when you are ready to un-pause. E.g., if using AutoHotKey, including the following in your script will toggle the pause state:
If -StartPaused is used, the timer for -AutoBootDelay will start after unpausing, but will reset if paused again. The -KbdCmd option will also only apply when the emulator is unpaused for the first time. Startup Key SequenceThe -KbdCmd option allows a string of key presses to be passed to BeebEm. The string can include the following key sequences:
So, for example, run a tape image using commands such as:
|
Copyright © 2020 Mike Wyatt