https://github.com/stid/apple1js

Apple1 Replica in Javascript (Node & Browser) - https://stid.me
https://github.com/stid/apple1js

6502 apple apple1 emulator javascript nodejs react typescript vintage webworkers woz

Last synced: about 1 month ago
JSON representation

Apple1 Replica in Javascript (Node & Browser) - https://stid.me

• Host: GitHub
• URL: https://github.com/stid/apple1js
• Owner: stid
• License: gpl-3.0
• Created: 2017-11-26T06:41:50.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2024-07-28T17:37:48.000Z (5 months ago)
• Last Synced: 2024-07-29T01:27:35.340Z (5 months ago)
• Topics: 6502, apple, apple1, emulator, javascript, nodejs, react, typescript, vintage, webworkers, woz
• Language: TypeScript
• Homepage:
• Size: 3.96 MB
• Stars: 9
• Watchers: 2
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# Apple 1 JS Emulator

[![Netlify Status](https://api.netlify.com/api/v1/badges/8dda601a-c4c2-4cde-80c4-bc08ffd6d18e/deploy-status)](https://app.netlify.com/sites/stidme/deploys)

[![CodeQL](https://github.com/stid/Apple1JS/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/stid/Apple1JS/actions/workflows/github-code-scanning/codeql)

The Apple 1 JS Emulator is a project written in TypeScript/JavaScript that emulates the Apple 1 computer. It is based on the [Hybrid HW](https://github.com/stid/APPLE-1-ReplicaDue) and Torlus' [6502.js](https://github.com/Torlus/6502.js) project.

## Demo

You can try out the emulator in your browser with the [Interactive Demo](https://stid.me).

## Local Setup

To run the emulator locally on your computer, you'll need to install the required packages with the following command in the repo folder:

``` ssh

yarn install

```

Then, start the emulator in developer mode with:

``` ssh

yarn start

```

You can access the emulator in your browser at `localhost:1234`.

## Test Programs

Once you have the emulator running, you can try out some test programs. To reset the emulator, press `Tab` in your browser. Then, you can enter a list of commands to execute the program.

### Monitor Test

This program should print a continuous stream of ASCII characters:

```basic

0:A9 0 AA 20 EF FF E8 8A 4C 2 0

0

R

```

### Anniversary

This program should print an image of WOZ:

```basic

280

R

```

### Hello World

This program should continuously print "HELLO! FROM APPLE 1 JS":

```basic

E000

R

10 PRINT "HELLO! FROM APPLE 1 JS"

20 GOTO 10

RUN

```

Enjoy!