Apple-1-Tools/apple1js
1
0
Fork 0
mirror of https://github.com/whscullin/apple1js.git synced 2024-12-04 06:50:08 +00:00
Code Issues Projects Releases Wiki Activity
An Apple 1 Emulator in Javascript
121 Commits 1 Branch 0 Tags 6.2 MiB
JavaScript 99.1%
HTML 0.5%
CSS 0.4%
b18f41ff1c
Go to file
Will Scullin b18f41ff1c
Merge pull request #44 from gabrielsroka/patch-1 
Update apple1.ts
2023-12-14 10:16:51 -08:00
.github/workflows Update github action 2023-11-22 14:25:20 -08:00
asm automaton 2020-10-08 19:23:01 -07:00
css Fix padding. 2019-09-05 21:24:06 -07:00
js Update apple1.ts 2023-12-08 23:00:57 -08:00
submodules Update submodule 2023-11-22 14:16:19 -08:00
tapes automaton 2020-10-08 19:23:01 -07:00
.editorconfig JS stays a 4 2023-08-06 07:44:12 -07:00
.eslintrc.json Prettier 2023-08-19 15:07:00 -07:00
.gitignore Ignore .DS_Store 2023-08-05 18:32:40 -07:00
.gitmodules Use submodule for cpu6502 2023-11-22 14:10:26 -08:00
apple1js.html automaton 2020-10-08 19:23:01 -07:00
babel.config.js Add Typescript 2023-08-05 18:27:00 -07:00
jest.config.js Convert tests to Typescript 2023-08-06 06:20:11 -07:00
LICENSE
package-lock.json Use submodule for cpu6502 2023-11-22 14:10:26 -08:00
package.json Use submodule for cpu6502 2023-11-22 14:10:26 -08:00
README.md Update README.md 2023-12-08 23:03:42 -08:00
tsconfig.json Enable strict 2023-08-06 12:47:43 -07:00
webpack.config.js Lint, other build fixes 2023-08-06 07:34:07 -07:00

README.md

apple1js

What is this?

An Apple 1 emulator written in JavaScript and HTML5. Press F1 (or maybe Shift+F1) to Reset, F2 to enter fullscreen mode.

Things are still a little rough around the edges right now, hopefully I will have more time to clean things up.

First

git submodule init
git submodule update
npm install

To run a development server

npm run dev

Then open http://localhost:8080/apple1js.html

To build a static distribution into dist

npm run build

Requirements

A Browser with HTML5 Support

The most recent versions of Google Chrome, Safari, Firefox, and Opera all seem to work reasonably well these days, although variations in HTML5 support pop up, and occasionally a major release will move things around out from under me. IEs prior to 9 lacks canvas tag support and are unsupported. IE 9+ renders nicely on a modern machine.

Basic Knowledge of the Apple 1

If you don't know how to use an Apple 1, this won't be much fun for you. A good place to start is the Apple I Owners Club.

Known Limitations

Limited Accuracy

Unlike the Apple ][ I wrote an emulator for, I don't own an Apple 1. My emulation is based on all the reference materials I was able to dig up, and by comparison to the behavior of other emulators.

Acknowlegements

I heavily referenced:

And special thanks to:

  • Mike for an eclectic collection of useful information. Someday I will work up the nerve to try building a replica.
  • And of course Woz, for launching my 30+ years of both silly and practical computer projects.

Updates

2013-06-25

  • ACI Emulation

    Programs are now loaded via ACI emulation off of virtual tapes. This is slower than just slamming them into memory, faster than emulated typing. Actually loading programs from audio files is on my radar, but quite a bit more work.

2013-06-05

  • More Accurater

    I've scraped the Internet for more information. For instance Cameron's Closet had some nice info on character display.

  • Krusader off by default

    Krusader seems to cause some output weirdness outside of the Krusader shell, so I'm not using it by default anymore. Use #krusader to turn it back on.

2013-05-28

  • Less Limited Input

    Pasting into the load window is now the same as typing. For now it is not any faster, though.

2013-05-27

  • Krusader

    I've decided to use Krusader as the default ROM for now. I'm just starting to find my way around it, but other Apple 1 people might find it useful.