Apple-1-Tools/apple1js
1
0
Fork 0
mirror of https://github.com/whscullin/apple1js.git synced 2024-12-31 13:31:12 +00:00
Code Issues Projects Releases Wiki Activity
An Apple 1 Emulator in Javascript
133 Commits 1 Branch 0 Tags 6.2 MiB
JavaScript 99.1%
HTML 0.5%
CSS 0.4%
175bd2cd79
Go to file
Will Scullin 175bd2cd79
Merge pull request #51 from whscullin/dependabot/npm_and_yarn/multi-9f37c16f8f 
Bump cookie and express
2024-10-19 19:56:13 -07:00
.github/workflows Update node 2024-09-16 21:26:40 -07:00
asm automaton 2020-10-08 19:23:01 -07:00
css Fix padding. 2019-09-05 21:24:06 -07:00
js Ignore unprintable characters 2023-12-18 14:13:06 -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
.prettierrc Fiddle with prettier 2023-12-18 12:04:20 -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 First commit to github. 2019-09-04 20:03:11 -07:00
package-lock.json Bump cookie and express 2024-10-19 23:24:40 +00:00
package.json Merge pull request #50 from whscullin/whscullin/update-node 2024-09-16 21:31:44 -07: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 Update webpack 2024-09-16 21:11:58 -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.