*CODEBREAKER!* is a [*Mastermind*](http://en.wikipedia.org/wiki/Mastermind_%28board_game%29) implementation for the [*Apple-1*](http://en.wikipedia.org/wiki/Apple_I) computer (pre-1.0 video demo: <http://youtu.be/Q_ex8GgDBjc>).
* *A true random number generator!* Using cycle counting while waiting for keystrokes generates a very random number. No need for seeds and no cheating possible (unless you hack the code :-).
* *A countdown timer!* Using the 960 KHz clock of the Apple-1, *CODEBREAKER!* can countdown the *Master* level with sub-second accuracy. If you really want to stress yourself out, play as a *Master*. ***You've got 60 seconds or you fail!***
* M.E.S.S. v0.145 (Mar 8 2012) - Multi Emulator Super System (<http://www.mess.org/>)
* Apple-1 Mimeo Clone 4+4 configuration (tested by Corey Cohen). *This is about as close to a real Apple-1 as you can get without a million US dollars.*
Download <https://github.com/datajerk/codebreaker/archive/master.zip> and extract.
### Upload and Run
If your Apple-1 has 8K of contiguous memory starting at location `$0000` then use `codebreaker.8k.mon` or `codebreaker.8k.wav`.
Load/run with `codebreaker.8k.mon`:
1. Hand type (brutal) or cut/paste `codebreaker.8k.mon` into the Apple-1 monitor and then type `280R`.
Load/run with `codebreaker.8k.wav`:
1. Load up `codebreaker.8k.wav` into your audio player.
2. Type:
```
C100R
280.1AFFR
```
3. Press *play*.
4. To run, type:
```
280R
```
<br>
If your Apple-1 has 8K of memory split into 4K banks at memory locations `$0000` and `$E000` (classic Apple-1 configuration) then use `codebreaker.4+4k.mon` or `codebreaker.4+4k.wav`.
> `$E000-$EFFF` *must be writable.*
Load/run with `codebreaker.4+4k.mon`:
1. Hand type (brutal) or cut/paste `codebreaker.4+4k.mon` into the Apple-1 monitor and then type `280R`.
Load/run with `codebreaker.4+4k.wav`:
1. Load up `codebreaker.4+4k.wav` into your audio player.
*CODEBREAKER!* was written in C with a bit of assembly (keyboard input, timer, and 32-bit random number seed generator). (*CODEBREAKER!* may be the *only* Apple-1 title written in C :-).