# Apple2

## A portable Apple //e emulator

This is the home of the Apple2 portable Apple //e emulator. It’s based on GCC and SDL2, and runs on Linux, Windows, and MacOS X. It’s powered by Virtual 65C02™, and sports an easy to use yet powerful interface. It also has WOZ support! The source is licensed under the GPL version 3.

Apple2 running “The Bard’s Tale”

This emulator came about because of ApplePC. It was a DOS only application with a horrible user interface (I wouldn't go so far as to call it user hostile, but it was close) that you had to tune by feeding it the correct numbers for your machine to get it to run at the correct speed. But it had absolutely the most accurate looking screen that I have even seen on an Apple emulator at that time or ever since—current emulators still to this day can’t match the fidelity of what that old DOS program could do.

So, to make a long story even longer, ApplePC disappeared off the face of the earth and I thought it was a shame that the screen rendering of that emulator should disappear with it. Also, there are, for some reason, absolutely no Apple II emulators for Linux! A deplorable situation![This was true at the time of this writing, but now there are at least two others (LinApple and microM8) out there. —Ed.]And so I resolved to fix that by figuring out how ApplePC did its video tricks and by writing an emulator for Linux. At the same time, since I write pretty much all my software cross-platform, Windows and MacOS X ports come along for free!

Currently, only a source code archive is available. More will be coming in the near future… You can get a copy of the source code with the following incantation:

`git clone http://shamusworld.gotdns.org/git/apple2`

### Features

Apple2 emulates an enhanced Apple //e with the following features:

- 128K RAM
- Two Disk II floppy disk drives in slot 6
- One Mockingboard A (also known as Sound II) in slot 4
- One Apple II High-Speed SCSI Card in slot 7
- 80-column card in slot 3
- Double Hi-res
- Double Lo-res
- Accurate color TV emulation
- Supports virtual disks types of DSK (read) and WOZ (read/write)—NIB is no longer supported

### How to Use It

Apple2’s Control Bar
Apple2’s Disk Selector
Scrolling in the Disk Selector

By mousing over the right side of the screen, the emulator control bar will appear; moving the mouse off of the bar will cause it to disappear. On the bar are seven icons, labeled (from top to bottom): power, disk one, disk two, swap disks, save state, load state, and configure. Here’s what they do:

- Power: turn the virtual Apple //e on and off
- Disk One: put a virtual disk into virtual disk drive #1 (or eject from same)
- Disk Two: put a virtual disk into virtual disk drive #2 (or eject from same)
- Swap Disks: take the virtual disk out of virtual drive #1 and put it into virtual drive #2 and take the virtual disk out of virtual drive #2 and put it into virtual drive #1 (it takes a lot of words to describe this simple action)
- Save State: save the state of the Apple2 emulator to a file for later recall
- Load State: load the state of the Apple2 emulator from a file
- Configure: configure various behaviors of the Apple2 emulator

In addition to the aforementioned control bar, Apple2 also supports the following function keys:

- F2: Toggle color TV emulation palette
- F3: Toggle between color TV, white monochrome, and green monochrome modes
- F5/F6: Turn the emulated speaker volume up or down
- F7/F8: Turn the emulated Mockingboard volume up or down
- F12: Toggle full screen on/off
- Pause: Pause/unpause the emulation
- Ctrl-Shift-Q: Quit Apple2
- Ctrl-Home: Ctrl-RESET
- Left Alt: Open apple key
- Right Alt: Closed apple key