Apple II

Overview

The Apple II application is an emulator for the Apple IIe personal computer.

BIOS Files

In addition to Apple II disk images, BIOS files must be specified globally within the feed (See the Feed Properties Dialog and Apple II Feed Properties sections).

File	Hash (MD5)
`a2diskiing.zip`	e07ffce4500ffeac9750c427d8309d9b
`apple2e.zip`	d96a5b4370d665300802970c35cf1b7f
`d2fdc.zip`	2b50e7c8a9f2b55ddd2ace9fecdd6a60
`votrsc01.zip`	c835eab06842e3c1d6e2e7dc19289828
`votrsc01a.zip`	b784c07140810457f6244d267cbbbb72

Default Controls

The default keyboard and gamepad mappings are listed in the tables below. It is important to note that these are merely the default settings and can be modified on a game-by-game basis.

Keyboard

The Apple II emulator passes keyboard input directly to the emulated computer. Most standard keys work as expected.

It is important to note that keyboard-based gamepad input should be disabled to allow access to all keys (otherwise, some keys will be utilized for joystick input).

The following table contains the default keyboard joystick mappings.

Name	Keys	Comments
Move
Button 0		Default mapping.
Button 1		Default mapping.

Gamepad

The default gamepad mappings are listed in the table below.

Name	Gamepad	Comments
Joystick	or
Button 0		Default mapping.
Button 1		Default mapping.
Show Virtual Keyboard		Not available for Xbox and not recommended for iOS (see alternate) Press the View (Back) Button.
Show Virtual Keyboard (Alternate)	and	Hold down the Right Trigger and click (press down) on the Left Thumbstick.
Show Virtual Keyboard (Alternate)	and	Hold down the Left Trigger and click (press down) on the Right Thumbstick.
Show Pause Screen	and	Hold down the Left Trigger and click (press down) on the Left Thumbstick.
Show Pause Screen (Alternate)	and	Hold down the Left Trigger and click (press down) on the Right Thumbstick.

On-screen Controls

The Apple II application includes a set of on-screen controls which are detailed below.

Button

Description

Virtual Keyboard

Displays the Virtual Keyboard.

Toggle Gamepad Keyboard Mode

Toggles whether or not the keyboard should be used for joystick input. When disabled, the full keyboard is used to map to the Apple II keyboard. When enabled, a subset of the keyboard keys are used for joystick input.

NOTE: This button is only visible if a physical keyboard key has been pressed.

Pause (Show Pause Screen)

Displays the webЯcade pause screen.

Virtual Keyboard

The Apple II application includes a virtual keyboard that can be utilized on devices that don't have a physical keyboard readily available (mobile, Xbox, etc.).

Display of the virtual keyboard can be toggled via the "Virtual Keyboard" button within the On-screen Controls, or by pressing the View (Back) Button on a gamepad.

Special Keys

The virtual keyboard includes the following "special" keys.

Key		Description
Switch to Letters Mode		Pressing this key will switch to the Letters Mode of the keyboard.
Switch to Numbers Mode		Pressing this key will switch to the Numbers Mode of the keyboard.
Change Keyboard Position		Toggles the keyboard between center and bottom positions on the screen.

Letters Mode

This mode contains letters, special Apple II keys (Open Apple, Closed Apple, Reset), and navigation keys.

Numbers Mode

This mode contains numbers, symbols, and shifted symbol variants.

Pause Screen

The Apple II application's pause screen provides access to application settings.

Apple II Settings (Session Only)

This tab is only available when a game has multiple disks and allows switching the active disk mid-session without modifying the saved feed.

Field	Description
Current Disk	Switches to another disk in a multi-disk game.

Display Settings Tab

Field	Description
Screen size	The screen size to use when playing a game. Options include: `Native` : The application's native resolution `16:9` : Widescreen resolution `Fill` : Fill the entire contents of the screen
Bilinear filter	The type of bilinear filter to apply to the output display. Options include: `Sharp` : Applies a sharp bilinear filter `Soft` : Applies a soft bilinear filter `Off` : Disables bilinear filtering
On-screen controls	Toggle whether the on-screen controls should always be displayed, or only when keyboard, mouse, or touch is detected.

Virtual Keyboard Settings

The Apple II application's "Virtual Keyboard Settings" tab is detailed below.

Field

Description

Transparency

Toggles the degree of transparency the virtual keyboard should have.

A higher degree of transparency allows more of the game to be visible through the keyboard (which may make the keyboard itself less visible).

Saving Changes to Media

This application supports persisting changes to a game's media (disk writes) into the browser's local storage or optionally to cloud-based storage.

Note

The ability to define blank disk images as part of an item's definition (similar to the Commodore 64 saveDisks feature) is not yet available for the Apple II application. This capability is planned for a future release.

Feed

This section details how Apple II application instances can be added to feeds.

Type

The type name for the Apple II application is retro-mame-apple2.

Type	Cheats	Shaders	Retro Achievements	Low CPU
`retro-mame-apple2` ⭐	x	✅	✅	x

Note

The alias apple2 also currently maps to this application. In the future, the apple2 alias may be mapped to another Apple II application (different emulator implementation) if it is determined to be a more appropriate default.

Feed Properties

The table below contains global Apple II feed properties. These properties must be specified in the props object of the feed's Feed Object.

Property	Type	Required	Details
apple2_bios	Array of URLs	Yes	Array of URLs to Apple II BIOS files or zip files containing them (see BIOS Files).

Item Properties

The table below contains the properties that are specific to the Apple II application. These properties are specified in the props object of a feed item.

Property Type Required Details

media Array of URLs Yes Array of URLs to Apple II disk image files (.dsk, .woz, .po, .do).

mappings

Map of Strings (key-value pairs)

No

Game-specific mappings of Apple II keys and joystick controls to the gamepad.

The simplest way to determine these mappings is by creating an Apple II item in the Feed Editor and exporting it.

The following is a simple example of a set of mappings. The key is the gamepad controller button and the value is the Apple II key or joystick control that it is mapped to.

{
    "a": "button0",
    "b": "button1",
    "x": "openapple",
    "y": "closedapple",
    "lb": "return",
    "rb": "space"
}

zoomLevel Numeric No A numeric value indicating how much the display image should be zoomed in (0-40).

Example

The following is an example of a complete feed that consists of a single Apple II application instance (type value of apple2).

{
  "title": "Apple II",
  "props": {
    "apple2_bios": [
      "https://<host>/a2diskiing.zip",
      "https://<host>/apple2e.zip",
      "https://<host>/d2fdc.zip",
      "https://<host>/votrsc01.zip",
      "https://<host>/votrsc01a.zip"
    ]
  },
  "categories": [
    {
      "title": "Apple II Games",
      "items": [
        {
          "title": "My Game",
          "type": "apple2",
          "props": {
            "media": ["https://<host>/mygame.dsk"]
          }
        }
      ]
    }
  ]
}

References

Apple II Application GitHub Repository