Setting up programs
All BBC programs to be used by an emulator should be stored as disk
images (or archives) or rom images.
Disk images should have the extension '.ssd', '.img' (single sided),
'.dsd' (double sided) or '.adf' (ADFS format). BeebEF also supports the
standard archive format (*.zip, containing *.inf files) and the
universal emulator format (*.uef), although these are formally not disk
images. See the emulator tips page for
information about the use of the standard archive format.
Rom images should have the extension '.rom'.
To set up a new program for use with BeebEF, select 'Programs|New'
from the main screen, or press the 'New program' button on the tool bar. Program setups can be edited by selecting
'Programs|Edit' or the 'Edit program' button. They can be deleted by selecting 'Programs|Delete' or the 'Delete
program' button.
Program setups are added and edited in the following window, which contains
two tabbed pages.
General
This page contains the following sections.
Identification
- Name. The name of the program.
- File name. The file name of the program. Press the 'browse'
button (the button with the three dots) to select the file name.
- Publisher. The publisher of the program. Select one from the
drop-down list.
Other
- Type. The type of program. Select one from the drop-down
list.
- Favourite. Select this box if the program is a favourite.
This field can be used in filters, for example, to show only favourite
programs.
- E00 DFS. Select this box if the program requires a DFS that
keeps PAGE at &E00 rather than &1900.
Note: this box is disabled if
you configured BeebEF not to handle
emulator DFS's.
Information

This page contains the following sections.
- General information. Use this field to store free-text information.
This information is shown in the main program window on the third tab page ('Information') when the program is selected.
- Emulator compatibility warnings. Use these fields to enter a warning
if a program does not work well in a particular emulator. One warning can be
given for every emulator. Again, this warning is shown shown in the main program
window on the third tab page. In addition, BeebEF can be configured to issue a warning
when the program is run with the emulator (see the Options form).
- Links. Use this field to store one or more hyperlinks to
related files. Again, these hyperlinks are shown in the main program window on the
third tab page when the program is selected. There they can be clicked to show the associated files.
Use the 'New', 'Edit' and 'Delete' buttons to modify hyperlinks.
When the 'New' or 'Edit' button is selected, a new window pops up in
which the name of the hyperlink and the associated file can be entered.
Make sure that the selected file type is registered in Windows and
linked to a program that allows the file contents to be displayed.
Use the 'Up' and 'Down' buttons to change the order of the hyperlinks
and the 'Sort' button to have them ordered alphabetically.
If a program is selected in the main BeebEF window, a picture of the
program can be shown on the first tab page ('Picture'). The name of the picture file is not
selected in the programs window, discussed here. Instead, the
picture file should have the same path and file name as the program, with the
extension replaced by '.jpg'. (Only JPEG files are accepted.)
So, for example, if a disk image name is
'C:\BBC\Software\Acornsoft\Snapper.ssd', the associated picture file name should be
'C:\BBC\Software\Acornsoft\Snapper.jpg'.
Similarly, a box cover image can be shown on the second tab
page ('Box cover').
This image is a file with the string '-box.jpg' added to the program file name
without the extension.
So, for example, if a disk image name is
'C:\BBC\Software\Acornsoft\Snapper.ssd', the associated box cover image file name should be
'C:\BBC\Software\Acornsoft\Snapper-box.jpg'.