applepy/README.md

ApplePy - an Apple ][ emulator in Python

by James Tauber / http://jtauber.com/

Originally written 2001, updated 2011

Apple ][ ROM available from http://www.easy68k.com/paulrsm/6502/index.html

Credits

Some 6502 code came from contributions from Christiaan Kelly in 2007.

Greg Hewgill provided significant fixes and improvements to the 2011 version (see the commit log for details).

The character generator bitmaps were entered by hand from visual inspection of http://www.sbprojects.com/projects/apple1/terminal.php

Status

With original Apple ][ ROM it boots to the monitor, most monitor commands work and you can go into Integer BASIC (with E000G or Ctrl-B RETURN) and write and run programs. With an Apple ][+ ROM it boots to Applesoft Basic and runs all the programs I've tried so far.

The only I/O supported is the keyboard and screen but 40-column text, LORES and HIRES graphics are all supported.

ApplePy currently requires Pygame (although there is a minimal applepy_curses.py that uses curses to display text mode only) and numpy (just for an array for speaker sounds)

Here's how I set up the dependencies (on Mac OS X 10.8):

pip install numpy
brew install sdl sdl_image sdl_mixer sdl_ttf portmidi hg
pip install hg+http://bitbucket.org/pygame/pygame

License

This code is made available under an MIT License. See LICENSE.