<WRAP center round todo>
This article is still under construction.
</WRAP>
<WRAP group>
<WRAP round box twothirds column>
{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/logos/apple2.svg?nolink&360 }}

====== Apple ][ line ======
The Apple ][ is a family of 8-bit computers developed by Apple (primarily [[wp>Steve_Wozniak|Steve Wozniak]]) dating back to 1977. The most recent model is the Apple IIc Plus, which was discontinued on November 1993.

It was one of the first majorly successful consumer-oriented microcomputer products, and opened the way for software targeted at the consumer audience. Regarding the design of the computer itself, Steve Wozniak stated "To me, a personal computer should be small, reliable, convenient to use, and inexpensive."

The line includes:
  * **%%Apple ][%%** The first one. Features a 6502 CPU at 1.023 MHz and 4KB of RAM.
  * **%%Apple ][+%%** An incremental upgrade featuring four times the RAM (16KB).
  * **%%Apple //e%%** Even more RAM (64KB), a full ASCII keyboard and better display modes.
  * **Apple IIc** The first CPU upgrade, opting to use a 65C02 CPU at 1.023 MHz and 128KB of RAM.
  * **Apple IIGS** Has [[systems:apple2gs|its own page]] in this wiki.
  * **%%Apple //e Enhanced%%** The Apple %%//e%% but with the 65C02 CPU.
  * **%%Apple //e Platinum%%** The Apple %%//e%% Enhanced with extra RAM (128KB).
  * **Apple IIc Plus** Allowed the user to change the CPU clock between 1.023MHz and 4MHz and had an 8KB SRAM cache.

This system scrapes metadata for the "apple2" group and loads the ''apple2'' set from the currently selected theme, if available.
</WRAP>

<WRAP third column>
{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/apple2.png?nolink&350 |The Apple II.}}
{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/apple2e.png?nolink&350 |The Apple IIe.}}
</WRAP>
</WRAP>

==== Quick reference ====
  * **Accepted ROM formats:** ''.nib'', ''.do'', ''.po'', ''.dsk'', ''.mfi'', ''.dfi'', ''.rti'', ''.edd'', ''.woz'', ''.wav'', ''.zip'', ''.7z''
  * **Folder:** ''/userdata/roms/apple2''

^ Emulators ^ Accepted ROM formats ^
| [[#libretro:_mame|libretro: mame]] | ''.nib'', ''.do'', ''.po'', ''.dsk'', ''.mfi'', ''.dfi'', ''.rti'', ''.edd'', ''.woz'', ''.wav'', ''.zip'', ''.7z'' |
| [[#mame|MAME]] | ''.nib'', ''.do'', ''.po'', ''.dsk'', ''.mfi'', ''.dfi'', ''.rti'', ''.edd'', ''.woz'', ''.wav'', ''.zip'', ''.7z'' |
| [[#gsplus|GSplus]] | ''.nib'', ''.do'', ''.po'', ''.dsk'' |

===== BIOS =====
^ MD5 checksum ^ Share file path ^ Description ^
| ''4431aea380185e3f509285540d7cb418'' | ''bios/apple2e.zip'' | |
| ''e6d453d8738e6df4f73df8c8051df3e8'' | ''bios/apple2e.zip'' | |
| ''72924019cf1719765e4fde35e59c1c7d'' | ''bios/apple2e.zip'' | |
| ''0b150f4bfa090770a866cc5d214703f4'' | ''bios/apple2e.zip'' | |
| ''2020aa1413ff77fe29353f3ee72dc295'' | ''bios/a2diskiing.zip'' | |
| ''95b91e4a2fe7d6f13d353ba1827d37f9'' | ''bios/votrax.zip'' | |
| ''5f1be0c1cdff26f5956eef9643911886'' | ''bios/d2fdc.zip'' | |

===== ROMs =====
Place your Apple ][ ROMs in ''/userdata/roms/apple2''.

===== Emulators =====
==== RetroArch ====
RetroArch has [[emulators:retroarch|its own page]].

=== libretro: mame ===
== libretro: mame configuration ==
Standardized features for this core: ''apple2.autosave'', ''apple2.netplay''

^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^
^ Settings that apply to all systems this core supports ||
| **OVERCLOCK (UNSTABLE) ''global.mame_cpu_overclock''** | Enhancement. Reduces system slowdown. Causes issues in some games.\\ => default ''default'', 30 ''30'', 35 ''35'', 40 ''40'', 45 ''45'', 50 ''50'', 55 ''55'', 60 ''60'', 65 ''65'', 70 ''70'', 75 ''75'', 80 ''80'', 85 ''85'', 90 ''90'', 95 ''95'', 100 ''100'', 105 ''105'', 110 ''110'', 115 ''115'', 120 ''120'', 125 ''125'', 130 ''130'', 135 ''135'', 140 ''140'', 145 ''145'', 150 ''150''. |
| **RENDERING RESOLUTION ''global.mame_altres''** | Enhancement. Increase the rendering resolution. Makes 3D objects clearer.\\ => 640x480 ''640x480'', 800x600 ''800x600'', 960x720 ''960x720'', 1024x768 ''1024x768'', 1280x720 ''1280x720'', 1600x800 ''1600x800'', 1920x1080 ''1920x1080'', 2560x1440 ''2560x1440'', 3840x2160 ''3840x2160''. |
| **SPECIAL CONTROL LAYOUTS ''global.altlayout''** | Controls for 5/6 button games and other unique controls\\ => Default Only ''default'', SNES Style ''snes'', Genesis/Megadrive Style ''megadrive'', Modern Fightstick Style ''fightstick'', Neo Geo Mini Pad ''neomini'', Neo Geo CD Pad ''neocd'', Twin Stick with Triggers ''twinstick'', Rotated 4-Way Stick (Q*Bert) ''qbert''. |
| **HIGH SCORE PLUGIN ''global.hiscoreplugin''** | Emable or disable high score saving\\ => Enabled (Default) ''1'', Disabled ''0''. |
| **COIN SOUND PLUGIN ''global.coindropplugin''** | Play a coin drop sound effect when an insert coin button is pressed\\ => Enabled ''1'', Disabled (Default) ''0''. |
| **SHARE MAME ARTWORK ''global.sharemameart''** | Use the same art paths as standalone MAME - not recommended if using decorations or shaders.\\ => On (Default) ''1'', Off ''0''. |
| **CROP ARTWORK ''global.artworkcrop''** | Crop MAME artwork to maximize the game screen and only fill unused space.\\ => On (Default) ''1'', Off ''0''. |
| **CUSTOM MAME CONFIG ''global.customcfg''** | Set system-wide controls via MAME menu\\ => On ''1'', Off ''0''. |
| **OFF-SCREEN RELOAD BUTTON ''global.offscreenreload''** | Set gun button 2 to reload.\\ => On ''1'', Off (Default) ''0''. |
^ Settings specific to apple2 ||
| **SOFTWARE LIST ''apple2.softList''** | Use MAME software lists to identify ROM\\ => Don't Use (Default) ''none'', Apple II cleanly cracked disks ''apple2_flop_clcracked'', Apple II miscellaneous disks ''apple2_flop_misc'', Apple II original disks ''apple2_flop_orig''. |
| **MEDIA TYPE ''apple2.altromtype''** | Type of ROM file to load.\\ => Cassette ''cass'', Disk (Drive 1) ''flop1'', Disk (Drive 2) ''flop2''. |
| **UI KEYS ''apple2.enableui''** | Toggle with hotkey + D-pad up or Scroll Lock in-game.\\ => Off at Start ''0'', On at Start ''1''. |
| **CUSTOM GAME CONFIG ''apple2.pergamecfg''** | Enable per-game custom configuration via MAME menu.\\ => On ''1'', Off ''0''. |

==== MAME ====
[[https://www.mamedev.org/|MAME]], the Multiple Arcade Machine Emulator, is a multi-purpose emulation framework which facilitates the emulation of vintage hardware and software. Originally targeting vintage arcade machines, MAME has since absorbed the sister-project [[http://mess.redump.net/start|MESS]] (Multi Emulator Super System) to support a wide variety of vintage computers, video game consoles and calculators as well. MAME doesn't use an individual "core" for each system like RetroArch does, instead the ROM itself usually contains the necessary information to accurately emulate it, thus making it specific to the version of MAME it was made for. Overall it's a very complicated subject, we have a [[:arcade|guide specific to arcade]] just for it.

=== MAME configuration ===
MAME offers a **[[https://docs.mamedev.org/usingmame/ui.html|Menu]]** in-game (''[HOTKEY]'' + {{:wiki:south.png?nolink&20|South button (B SNES)}} or ''[Tab]'' on the keyboard). This can be used to manually adjust inputs or game settings. If you're having issues with a specific game, check the [[https://wiki.mamedev.org/index.php/FAQ:Games|MAMEdev FAQ for that game here.]] For MESS systems specifically, you might find more information on [[http://mess.redump.net/start|MESS's wiki]]. All options can also be edited by opening the ''mame.ini'' file.

Standardized features available to all versions of this emulator: ''apple2.videomode'', ''apple2.padtokeyboard'', ''apple2.videomode'', ''apple2.bezel'', ''apple2.bezel_stretch'', ''apple2.hud'', ''apple2.hud_corner'', ''apple2.bezel.tattoo'', ''apple2.bezel.tattoo_corner'', ''apple2.bezel.tattoo_file'', ''apple2.bezel.resize_tattoo''

^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^
^ Settings that apply to all versions of this emulator ||
| **VIDEO MODE ''apple2.video''** | BGFX for post-processing, accel/opengl for raw image.\\ => BGFX ''bgfx'', Accel ''accel'', OpenGL ''opengl''. |
| **VSYNC ''apple2.vsync''** | Fix screen tearing, but may drop frames.\\ => Off (Default) ''0'', On ''1''. |
| **BGFX GRAPHICS API ''apple2.bgfxbackend''** | Depends on video mode being set to BGFX. Vulkan is better, when supported.\\ => MAME Detect ''automatic'', OpenGL ''opengl'', OpenGL ES ''gles'', Vulkan ''vulkan''. |
| **BGFX VIDEO FILTER ''apple2.bgfxshaders''** | Apply a post-processing effect.\\ => Off ''None'', Bilinear ''default'', CRT Geom ''crt-geom'', CRT Geom Deluxe ''crt-geom-deluxe'', CRT Geom Deluxe (RGB) ''crt-geom-deluxe-rgb'', CRT Geom Deluxe (Composite) ''crt-geom-deluxe-composite'', Super Eagle ''eagle'', HLSL ''hlsl'', HQ2X ''hq2x'', HQ3X ''hq3x'', HQ4X ''hq4x''. |
| **CRT SWITCHRES ''apple2.switchres''** | Allows the use of switchres profiles if present.\\ => Off ''0'', On ''1''. |
| **VERTICAL ROTATION (TATE) ''apple2.rotation''** | Rotates screen by 90 degrees. Intended for rotating displays.\\ => Off ''None'', Rotate 90 ''autoror'', Rotate 270 ''autorol''. |
| **ARTWORK CROP ''apple2.artworkcrop''** | Crop artwork to only unused space, keeping the game as large as possible.\\ => Off (Default) ''0'', On ''1''. |
| **CUSTOM MAME CONFIG ''apple2.customcfg''** | Set system-wide controls via MAME menu\\ => On ''1'', Off ''0''. |
| **DATA PLUGIN ''apple2.dataplugin''** | Make game history, setup instructions, and special moves viewable in the menu\\ => Enabled ''1'', Disabled (Default) ''0''. |
| **OFF-SCREEN RELOAD BUTTON ''apple2.offscreenreload''** | Set gun button 2 to reload.\\ => On ''1'', Off (Default) ''0''. |
^ Settings specific to ''apple2'' ||
| **SOFTWARE LIST ''apple2.softList''** | Use MAME software lists to identify ROM\\ => Don't Use (Default) ''none'', Apple II cleanly cracked disks ''apple2_flop_clcracked'', Apple II miscellaneous disks ''apple2_flop_misc'', Apple II original disks ''apple2_flop_orig''. |
| **MEDIA TYPE ''apple2.altromtype''** | Type of ROM file to load.\\ => Cassette ''cass'', Disk (Drive 1) ''flop1'', Disk (Drive 2) ''flop2''. |
| **UI KEYS ''apple2.enableui''** | Toggle with hotkey + D-pad up or Scroll Lock in-game.\\ => Off at Start ''0'', On at Start ''1''. |
| **CUSTOM GAME CONFIG ''apple2.pergamecfg''** | Enable per-game custom configuration via MAME menu.\\ => On ''1'', Off ''0''. |

==== GSplus ====
[[https://apple2.gs/plus/|GSplus]] is an open source, cross-platform Apple ][/IIGS emulator, based on the KEGS and GSPort emulators.

>The goals of this project are to make an easier to install and easier to use emulator, and to modernize the overall codebase and emulation platform.
>
>While much work has been done, adding new drivers and features over the past year, it is still in alpha phase. Feel free to download the package for your platform and play around, but beware there are many bugs still.

=== GSplus configuration ===
Standardized features available to all cores of this emulator: ''apple2.videomode'', ''apple2.padtokeyboard'', ''apple2.decoration''

===== Controls =====
Here are the default Apple II's controls shown on a [[:configure_a_controller|Batocera RetroPad]]:

===== Troubleshooting =====
==== Further troubleshooting ====
For further troubleshooting, refer to the [[:support|generic support pages]].