Setting up emulators
To set up an emulator for use with BeebEF, select 'Edit|Emulators'
from the main screen, or press the 'Edit emulators' button on the tool
bar. In the window that appears next, press the 'New' button. A new
windows then appears.
The window contains the following tabbed pages.
Emulator

- Name. The name of the emulator.
- File name. The file name of the emulator. Press the 'browse'
button (the button with the three dots) to select the file name.
- Command line switches (optional). Some emulators support command line switches. If you enter any, don't forget to
include the - or / symbol.
- Environment variable (optional). This environment variable is
set to the specified value just before the emulator is run.
- Environment variable for ss disk images (optional). This
environment variable is set to the specified value only if the emulator
is run with a single sided disk image (*.ssd, *.img or *.bbc).
- Environment variable for ds disk images (optional). This
environment variable is set to the specified value only if the emulator
is run with a single sided disk image (*.dsd).
Disk/rom images

- Disk images working directory. This is the disk working
directory of the emulator, the directory where a disk image to be run
(or a file with BBC software in another format, e.g., a zipped standard
archive file) should be stored. Press the 'browse' button (the button
with the three dots) to select the directory.
- Disk image file name (optional). This field should be filled
out if the emulator expects a disk image (or archive file) of a
particular name. This field should then contain the name.
If this field is left blank, the disk image to be run is copied without
a name change to the emulator working directory. If this field is set,
the name of the disk image is overrided to the set name after copying.
Setting this field does not override the file extension of the disk
image (.ssd, .dsd, .img, .bbc, .adf, .uef, or .zip).
- Remove disk image.... This deletes from the
emulator working directory, after quitting an
emulator, the disk image (or archive file) that was run. This is useful to prevent cluttering of the
working directory.
- Rom images working directory. This is the rom working
directory of the emulator, the directory where a rom image to be used
should be stored. Press the 'browse' button (the button with the three
dots) to select the directory.
- Rom image file name (optional). These fields should be filled
out if the emulator expects a rom image of a particular name. These
fields should then contain the name.
If these fields are left blank, the rom image to be run is copied
without a name change to the emulator working directory. If these fields
are set, the name of the rom image is overrided to the set name after
copying.
Setting the first field overrides the base name of the rom image
(i.e., its file name without extension). Setting the second field
overrides the file extension of the rom image.
- Remove rom image.... This deletes, after quitting an
emulator, the rom image that was run from the emulator working
directory. This is useful to prevent cluttering of the working directory
and to prevent automatic re-loading of the rom if the emulator is
run again.
DFS Roms

Note: this page is disabled if you
configured BeebEF to not handle emulator DFS's.
- Default DFS rom image file name. This is the file name
(without path, but with extension) of the default DFS rom image used by
the emulator.
In other words: BeebEF copies its default DFS rom (in
the directory 'DFSRoms') to a file with this name if you run a program
that requires a normal DFS.
- E00 DFS rom image file name. This is the file name of the E00
DFS rom image used by the emulator.
In other words: BeebEF copies
its E00 DFS rom (in the directory 'DFSRoms') to a file with this name if
you run a program that requires an E00 DFS.
Note that in order to
make the E00 DFS work, you need to allow write
operations to the sideways rom/ram slot which it was loaded.
Click here for tips on configuring BeebEF
for various emulators.