summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Jones <admin@danieljon.es>2020-08-26 07:55:11 +0930
committerDaniel Jones <admin@danieljon.es>2020-08-26 07:55:11 +0930
commit72a80b66f979cce2318e0b4c1df1fae7175b4d2c (patch)
tree0f72fa5156edc5b1daed676839ef528d586dff48
parentf23b667da411baa8de95032bde97025fc427ad94 (diff)
downloadchip8-72a80b66f979cce2318e0b4c1df1fae7175b4d2c.tar.gz
chip8-72a80b66f979cce2318e0b4c1df1fae7175b4d2c.zip
added roms and changed readme
-rw-r--r--README14
-rw-r--r--main.c4
-rw-r--r--roms/CHANGELOG61
-rw-r--r--roms/README50
-rw-r--r--roms/demos/Maze (alt) [David Winter, 199x].ch8bin0 -> 38 bytes
-rw-r--r--roms/demos/Maze (alt) [David Winter, 199x].txt12
-rw-r--r--roms/demos/Maze [David Winter, 199x].ch8bin0 -> 34 bytes
-rw-r--r--roms/demos/Maze [David Winter, 199x].txt12
-rw-r--r--roms/demos/Particle Demo [zeroZshadow, 2008].ch8bin0 -> 353 bytes
-rw-r--r--roms/demos/Particle Demo [zeroZshadow, 2008].txt6
-rw-r--r--roms/demos/Sierpinski [Sergey Naydenov, 2010].ch8bin0 -> 521 bytes
-rw-r--r--roms/demos/Sirpinski [Sergey Naydenov, 2010].ch8bin0 -> 521 bytes
-rw-r--r--roms/demos/Stars [Sergey Naydenov, 2010].ch8bin0 -> 968 bytes
-rw-r--r--roms/demos/Trip8 Demo (2008) [Revival Studios].ch8bin0 -> 3203 bytes
-rw-r--r--roms/demos/Trip8 Demo (2008) [Revival Studios].txt49
-rw-r--r--roms/demos/Zero Demo [zeroZshadow, 2007].ch811
-rw-r--r--roms/demos/Zero Demo [zeroZshadow, 2007].txt3
-rw-r--r--roms/games/15 Puzzle [Roger Ivie] (alt).ch8bin0 -> 264 bytes
-rw-r--r--roms/games/15 Puzzle [Roger Ivie].ch8bin0 -> 384 bytes
-rw-r--r--roms/games/15 Puzzle [Roger Ivie].txt1
-rw-r--r--roms/games/Addition Problems [Paul C. Moews].ch8bin0 -> 168 bytes
-rw-r--r--roms/games/Airplane.ch8bin0 -> 356 bytes
-rw-r--r--roms/games/Animal Race [Brian Astle].ch8bin0 -> 1194 bytes
-rw-r--r--roms/games/Animal Race [Brian Astle].txt32
-rw-r--r--roms/games/Astro Dodge [Revival Studios, 2008].ch8bin0 -> 1113 bytes
-rw-r--r--roms/games/Astro Dodge [Revival Studios, 2008].txt52
-rw-r--r--roms/games/Biorhythm [Jef Winsor].ch8bin0 -> 910 bytes
-rw-r--r--roms/games/Biorhythm [Jef Winsor].txt58
-rw-r--r--roms/games/Blinky [Hans Christian Egeberg, 1991].ch8bin0 -> 2356 bytes
-rw-r--r--roms/games/Blinky [Hans Christian Egeberg] (alt).ch8bin0 -> 2078 bytes
-rw-r--r--roms/games/Blitz [David Winter].ch8bin0 -> 391 bytes
-rw-r--r--roms/games/Blitz [David Winter].txt4
-rw-r--r--roms/games/Bowling [Gooitzen van der Wal].ch8bin0 -> 1194 bytes
-rw-r--r--roms/games/Bowling [Gooitzen van der Wal].txt53
-rw-r--r--roms/games/Breakout (Brix hack) [David Winter, 1997].ch8bin0 -> 280 bytes
-rw-r--r--roms/games/Breakout (Brix hack) [David Winter, 1997].txt6
-rw-r--r--roms/games/Breakout [Carmelo Cortez, 1979].ch8bin0 -> 232 bytes
-rw-r--r--roms/games/Breakout [Carmelo Cortez, 1979].txt4
-rw-r--r--roms/games/Brick (Brix hack, 1990).ch8bin0 -> 286 bytes
-rw-r--r--roms/games/Brick (Brix hack, 1990).txt3
-rw-r--r--roms/games/Brix [Andreas Gustafsson, 1990].ch8bin0 -> 280 bytes
-rw-r--r--roms/games/Cave.ch8bin0 -> 882 bytes
-rw-r--r--roms/games/Coin Flipping [Carmelo Cortez, 1978].ch8bin0 -> 108 bytes
-rw-r--r--roms/games/Coin Flipping [Carmelo Cortez, 1978].txt5
-rw-r--r--roms/games/Connect 4 [David Winter].ch8bin0 -> 194 bytes
-rw-r--r--roms/games/Connect 4 [David Winter].txt10
-rw-r--r--roms/games/Craps [Camerlo Cortez, 1978].ch8bin0 -> 192 bytes
-rw-r--r--roms/games/Craps [Camerlo Cortez, 1978].txt4
-rw-r--r--roms/games/Deflection [John Fort].ch8bin0 -> 1024 bytes
-rw-r--r--roms/games/Deflection [John Fort].txt54
-rw-r--r--roms/games/Figures.ch8bin0 -> 290 bytes
-rw-r--r--roms/games/Filter.ch8bin0 -> 198 bytes
-rw-r--r--roms/games/Guess [David Winter] (alt).ch8bin0 -> 148 bytes
-rw-r--r--roms/games/Guess [David Winter] (alt).txt1
-rw-r--r--roms/games/Guess [David Winter].ch8bin0 -> 150 bytes
-rw-r--r--roms/games/Guess [David Winter].txt1
-rw-r--r--roms/games/Hi-Lo [Jef Winsor, 1978].ch8bin0 -> 170 bytes
-rw-r--r--roms/games/Hi-Lo [Jef Winsor, 1978].txt3
-rw-r--r--roms/games/Hidden [David Winter, 1996].ch8bin0 -> 850 bytes
-rw-r--r--roms/games/Hidden [David Winter, 1996].txt28
-rw-r--r--roms/games/Kaleidoscope [Joseph Weisbecker, 1978].ch8bin0 -> 122 bytes
-rw-r--r--roms/games/Kaleidoscope [Joseph Weisbecker, 1978].txt7
-rw-r--r--roms/games/Landing.ch8bin0 -> 276 bytes
-rw-r--r--roms/games/Lunar Lander (Udo Pernisz, 1979).ch8bin0 -> 1792 bytes
-rw-r--r--roms/games/Lunar Lander [Udo Pernisz, 1979].txt105
-rw-r--r--roms/games/Mastermind FourRow (Robert Lindley, 1978).ch8bin0 -> 292 bytes
-rw-r--r--roms/games/Mastermind FourRow (Robert Lindley, 1978).txt13
-rw-r--r--roms/games/Merlin [David Winter].ch8bin0 -> 345 bytes
-rw-r--r--roms/games/Merlin [David Winter].txt4
-rw-r--r--roms/games/Missile [David Winter].ch8bin0 -> 180 bytes
-rw-r--r--roms/games/Most Dangerous Game [Peter Maruhnic].ch8bin0 -> 1010 bytes
-rw-r--r--roms/games/Most Dangerous Game [Peter Maruhnic].txt48
-rw-r--r--roms/games/Nim [Carmelo Cortez, 1978].ch8bin0 -> 182 bytes
-rw-r--r--roms/games/Nim [Carmelo Cortez, 1978].txt4
-rw-r--r--roms/games/Paddles.ch8bin0 -> 560 bytes
-rw-r--r--roms/games/Pong (1 player).ch8bin0 -> 246 bytes
-rw-r--r--roms/games/Pong (alt).ch8bin0 -> 264 bytes
-rw-r--r--roms/games/Pong 2 (Pong hack) [David Winter, 1997].ch8bin0 -> 294 bytes
-rw-r--r--roms/games/Pong [Paul Vervalin, 1990].ch8bin0 -> 246 bytes
-rw-r--r--roms/games/Pong [Paul Vervalin, 1990].txt9
-rw-r--r--roms/games/Programmable Spacefighters [Jef Winsor].ch8bin0 -> 1020 bytes
-rw-r--r--roms/games/Programmable Spacefighters [Jef Winsor].txt135
-rw-r--r--roms/games/Puzzle.ch8bin0 -> 184 bytes
-rw-r--r--roms/games/Reversi [Philip Baltzer].ch8bin0 -> 578 bytes
-rw-r--r--roms/games/Reversi [Philip Baltzer].txt37
-rw-r--r--roms/games/Rocket Launch [Jonas Lindstedt].ch8bin0 -> 494 bytes
-rw-r--r--roms/games/Rocket Launcher.ch8bin0 -> 112 bytes
-rw-r--r--roms/games/Rocket [Joseph Weisbecker, 1978].ch8bin0 -> 130 bytes
-rw-r--r--roms/games/Rush Hour [Hap, 2006] (alt).ch8bin0 -> 3582 bytes
-rw-r--r--roms/games/Rush Hour [Hap, 2006].ch8bin0 -> 3582 bytes
-rw-r--r--roms/games/Rush Hour [Hap, 2006].txt28
-rw-r--r--roms/games/Russian Roulette [Carmelo Cortez, 1978].ch8bin0 -> 156 bytes
-rw-r--r--roms/games/Russian Roulette [Carmelo Cortez, 1978].txt4
-rw-r--r--roms/games/Sequence Shoot [Joyce Weisbecker].ch8bin0 -> 324 bytes
-rw-r--r--roms/games/Sequence Shoot [Joyce Weisbecker].txt25
-rw-r--r--roms/games/Shooting Stars [Philip Baltzer, 1978].ch8bin0 -> 204 bytes
-rw-r--r--roms/games/Shooting Stars [Philip Baltzer, 1978].txt2
-rw-r--r--roms/games/Slide [Joyce Weisbecker].ch8bin0 -> 388 bytes
-rw-r--r--roms/games/Slide [Joyce Weisbecker].txt24
-rw-r--r--roms/games/Soccer.ch8bin0 -> 334 bytes
-rw-r--r--roms/games/Space Flight.ch8bin0 -> 716 bytes
-rw-r--r--roms/games/Space Intercept [Joseph Weisbecker, 1978].ch8bin0 -> 192 bytes
-rw-r--r--roms/games/Space Intercept [Joseph Weisbecker, 1978].txt4
-rw-r--r--roms/games/Space Invaders [David Winter] (alt).ch8bin0 -> 1283 bytes
-rw-r--r--roms/games/Space Invaders [David Winter] (alt).txt5
-rw-r--r--roms/games/Space Invaders [David Winter].ch8bin0 -> 1301 bytes
-rw-r--r--roms/games/Space Invaders [David Winter].txt5
-rw-r--r--roms/games/Spooky Spot [Joseph Weisbecker, 1978].ch8bin0 -> 154 bytes
-rw-r--r--roms/games/Spooky Spot [Joseph Weisbecker, 1978].txt4
-rw-r--r--roms/games/Squash [David Winter].ch8bin0 -> 211 bytes
-rw-r--r--roms/games/Submarine [Carmelo Cortez, 1978].ch8bin0 -> 288 bytes
-rw-r--r--roms/games/Submarine [Carmelo Cortez, 1978].txt4
-rw-r--r--roms/games/Sum Fun [Joyce Weisbecker].ch8bin0 -> 176 bytes
-rw-r--r--roms/games/Sum Fun [Joyce Weisbecker].txt27
-rw-r--r--roms/games/Syzygy [Roy Trevino, 1990].ch8bin0 -> 946 bytes
-rw-r--r--roms/games/Syzygy [Roy Trevino, 1990].txt62
-rw-r--r--roms/games/Tank.ch8bin0 -> 560 bytes
-rw-r--r--roms/games/Tank.txt1
-rw-r--r--roms/games/Tapeworm [JDR, 1999].ch8bin0 -> 284 bytes
-rw-r--r--roms/games/Tetris [Fran Dachille, 1991].ch8bin0 -> 494 bytes
-rw-r--r--roms/games/Tetris [Fran Dachille, 1991].txt31
-rw-r--r--roms/games/Tic-Tac-Toe [David Winter].ch8bin0 -> 486 bytes
-rw-r--r--roms/games/Timebomb.ch8bin0 -> 144 bytes
-rw-r--r--roms/games/Tron.ch8bin0 -> 382 bytes
-rw-r--r--roms/games/UFO [Lutz V, 1992].ch8bin0 -> 224 bytes
-rw-r--r--roms/games/UFO [Lutz V, 1992].txt24
-rw-r--r--roms/games/Vers [JMN, 1991].ch8bin0 -> 230 bytes
-rw-r--r--roms/games/Vertical Brix [Paul Robson, 1996].ch8bin0 -> 507 bytes
-rw-r--r--roms/games/Wall [David Winter].ch8bin0 -> 229 bytes
-rw-r--r--roms/games/Wipe Off [Joseph Weisbecker].ch8bin0 -> 206 bytes
-rw-r--r--roms/games/Worm V4 [RB-Revival Studios, 2007].ch8bin0 -> 677 bytes
-rw-r--r--roms/games/Worm V4 [RB-Revival Studios, 2007].txt52
-rw-r--r--roms/games/X-Mirror.ch8bin0 -> 106 bytes
-rw-r--r--roms/games/ZeroPong [zeroZshadow, 2007].ch8bin0 -> 184 bytes
-rw-r--r--roms/programs/BMP Viewer - Hello (C8 example) [Hap, 2005].ch8bin0 -> 304 bytes
-rw-r--r--roms/programs/BMP Viewer - Hello (C8 example) [Hap, 2005].txt3
-rw-r--r--roms/programs/Chip8 Picture.ch8bin0 -> 164 bytes
-rw-r--r--roms/programs/Chip8 emulator Logo [Garstyciuks].ch8bin0 -> 288 bytes
-rw-r--r--roms/programs/Clock Program [Bill Fisher, 1981].ch8bin0 -> 280 bytes
-rw-r--r--roms/programs/Clock Program [Bill Fisher, 1981].txt8
-rw-r--r--roms/programs/Delay Timer Test [Matthew Mikolay, 2010].ch8bin0 -> 58 bytes
-rw-r--r--roms/programs/Delay Timer Test [Matthew Mikolay, 2010].txt9
-rw-r--r--roms/programs/Division Test [Sergey Naydenov, 2010].ch8bin0 -> 371 bytes
-rw-r--r--roms/programs/Fishie [Hap, 2005].ch8bin0 -> 160 bytes
-rw-r--r--roms/programs/Fishie [Hap, 2005].txt2
-rw-r--r--roms/programs/Framed MK1 [GV Samways, 1980].ch8bin0 -> 176 bytes
-rw-r--r--roms/programs/Framed MK1 [GV Samways, 1980].txt4
-rw-r--r--roms/programs/Framed MK2 [GV Samways, 1980].ch8bin0 -> 176 bytes
-rw-r--r--roms/programs/Framed MK2 [GV Samways, 1980].txt4
-rw-r--r--roms/programs/IBM Logo.ch8bin0 -> 132 bytes
-rw-r--r--roms/programs/Jumping X and O [Harry Kleinberg, 1977].ch8bin0 -> 82 bytes
-rw-r--r--roms/programs/Jumping X and O [Harry Kleinberg, 1977].txt3
-rw-r--r--roms/programs/Keypad Test [Hap, 2006].ch8bin0 -> 114 bytes
-rw-r--r--roms/programs/Keypad Test [Hap, 2006].txt12
-rw-r--r--roms/programs/Life [GV Samways, 1980].ch8bin0 -> 256 bytes
-rw-r--r--roms/programs/Life [GV Samways, 1980].txt11
-rw-r--r--roms/programs/Minimal game [Revival Studios, 2007].ch8bin0 -> 85 bytes
-rw-r--r--roms/programs/Random Number Test [Matthew Mikolay, 2010].ch8bin0 -> 34 bytes
-rw-r--r--roms/programs/Random Number Test [Matthew Mikolay, 2010].txt17
-rw-r--r--roms/programs/SQRT Test [Sergey Naydenov, 2010].ch8bin0 -> 386 bytes
160 files changed, 1276 insertions, 2 deletions
diff --git a/README b/README
index d4e8368..33b0471 100644
--- a/README
+++ b/README
@@ -1 +1,15 @@
CHIP-8 interpreter in C using SDL2 for graphics and sound.
+
+# build
+```
+cmake CmakeLists.txt
+make
+```
+The binary is in bin/
+# running
+```
+usage: bin/chip8 [scale] [speed] [romfile]
+scale - pixel scaling (~5 recommended)
+speed - how many cycles per second should be run (60-1000 or so, depends on the game)
+```
+A number of example ROM files are provided in the roms/ directory.
diff --git a/main.c b/main.c
index 0d5e381..0b7eb83 100644
--- a/main.c
+++ b/main.c
@@ -63,7 +63,7 @@ extern uint16_t stack[STACK_SIZE];
void
usage(char *program)
{
- printf("usage: %s [speed] [scale] [romfile]\nspeed - how many cycles per second should be run (60-1000 or so, depends on the game)\nscale - pixel scaling (~5 recommended)", program);
+ printf("usage: %s [scale] [speed] [romfile]\nscale - pixel scaling (~5 recommended)\nspeed - how many cycles per second should be run (60-1000 or so, depends on the game)\n", program);
}
void
@@ -224,7 +224,7 @@ int main(int argc, char *argv[])
init_video();
const int fps = atoi(argv[2]);
- const int frame_delay = 1000/fps;
+ const uint32_t frame_delay = 1000/fps;
uint32_t frame_start;
uint32_t frame_time;
diff --git a/roms/CHANGELOG b/roms/CHANGELOG
new file mode 100644
index 0000000..69f161c
--- /dev/null
+++ b/roms/CHANGELOG
@@ -0,0 +1,61 @@
+[16/4/2011]:
+- HIRES CHIP-8: Added Hires AstroDodge [Revival Studios, 2008]
+- HIRES CHIP-8: Added Hires Worm V4 [Revival Studios/RB, 2007]
+- HIRES CHIP-8: Added Trip8 Hires demo [Revival Studios, 2008]
+- HIRES CHIP-8: Added Hires Particle Demo [ZeroZshadow, 2008]
+- HIRES CHIP-8: Added Hires Stars [Sergey Naydenov, 2010]
+- HIRES CHIP-8: Added Hires Sierpinski [Sergey Naydenov, 2010]
+- HIRES CHIP-8: Added Hires Maze [David Winter, 19xx]
+- HIRES CHIP-8: Added Hires test [-, 1978]
+- CHIP-8 Programs: Life [GV Samways, 1980]
+- CHIP-8 Programs: Framed MK1 [GV Samways, 1980]
+- CHIP-8 Programs: Framed MK2 [GV Samways, 1980]
+- CHIP-8 Programs: Clock Program [Bill Fisher, 1981]
+- CHIP-8 Games: Russian Roulette [David Ruth, 1982]
+- CHIP-8 Games: FlipAround [unknown, 1980]
+
+[2/1/2011]:
+- CHIP-8 DEMOS: Added Particle Demo [ZeroZshadow, 2008]
+- SUPERCHIP-8 DEMOS: Added Super Particle Demo [ZeroZshadow, 2008]
+- MEGACHIP-8 DEMOS: Added Mega Particle Demo [ZeroZshadow, 2008]
+
+[19/9/2010]:
+- CHIP-8 DEMOS: Added Trip-8 Demo [Revival Studios,2008]
+- SUPERCHIP-8 DEMOS: Added SuperTrip-8 Demo [Revival Studios,2008]
+- CHIP-8 DEMOS: Added Stars [Sergey Naydenov, 2010]
+- CHIP-8 DEMOS: Added Sierpinski [Sergey Naydenov, 2010]
+- SUPERCHIP-8 DEMOS: Added SCStars [Sergey Naydenov, 2010]
+- SUPERCHIP-8 DEMOS: Added SCSierpinksi [Sergey Naydenov, 2010]
+- MEGACHIP-8 DEMOS: Added MegaSierpinski [Sergey Naydenov, 2010]
+- CHIP-8 TESTS: Added Division Test [Sergey Naydenov, 2010]
+- CHIP-8 TESTS: Added SQRT Test [Sergey Naydenov, 2010]
+- CHIP8x and HYBRIDS: Added various ETI660 Hybrids.
+
+[12/9/2010]:
+- CHIP-8 GAMES: Added Worm V4 [RB-Revival Studios, 2007]
+- CHIP-8 GAMES: Added ZeroPong [ZeroZshadow, 2007]
+- CHIP-8 GAMES: Added Rush Hour [Hap, 2006] (alt)
+- CHIP-8 GAMES: Added Pong (alt)
+
+[11/9/2010]:
+- CHIP-8 GAMES: Added a few converted roms from old Viper magazines & manuals.
+- Many new roms/programs added.
+
+[20/8/2010]:
+- CHIP-8 GAMES: Added AstroDodge [Revival Studios, 2008]
+- SUPERCHIP-8 GAMES: Added Super AstroDodge [Revival Studios, 2008]
+- SUPERCHIP-8 DEMOS: Added Climax Slideshow [Revival Studios, 2008]
+- Added Author and release-year information for each rom.
+- Added Text file by original author for each rom.
+
+[4/6/2008]:
+- Added Zero Demo [ZeroZshadow, 2007]
+- Added a number of other new roms.
+
+[2/10/2007]:
+- Initial release of the rom pack
+
+[Still Wanted]:
+- Snafu (Chip-8 Game)
+- Life (Chip-8 Demo)
+
diff --git a/roms/README b/roms/README
new file mode 100644
index 0000000..429e880
--- /dev/null
+++ b/roms/README
@@ -0,0 +1,50 @@
+-----------------------------------------------------------------------------
+ /////////////////
+ //////////////////
+ //// ////
+ //// ///////////
+ //// ///////////
+ //// ////
+ //// ///////////
+ //// //////////
+
+ www.chip8.com
+-----------------------------------------------------------------------------
+Title : Chip-8 Program Pack
+Author : Revival Studios
+Genre : Compilation
+System : Chip-8/SuperChip/MegaChip8
+Last updated : 16/04/2011
+Product ID : RS-C8000
+-----------------------------------------------------------------------------
+
+This is a collection of all CHIP-8 / SuperChip / MegaChip8 programs i found scattered around the web. I've researched and added information about the original author and year of release for most roms.
+The roms are divided in the following categories:
+
+- CHIP-8 Games
+- CHIP-8 Demo's
+- CHIP-8 Test programs
+- CHIP-8 Hires (hardware compatible 64x64 hires mode)
+- CHIP-8X/Hybrid games
+- SuperChip Games
+- SuperChip Demo's
+- SuperChip Test programs
+- MegaChip Games
+- MegaChip Demo's
+
+I've also converted various listings from paper to binary form and added them to this package.
+
+Running the roms:
+-----------------
+These roms will run in most CHIP-8 emulators and/or the original machines (CHIP8).
+
+Distribution:
+-------------
+This package can be freely distributed in its original form.
+If you have any additions for this pack, let me know.
+
+Watch out for more releases soon!
+
+
+ Revival Studios
+
diff --git a/roms/demos/Maze (alt) [David Winter, 199x].ch8 b/roms/demos/Maze (alt) [David Winter, 199x].ch8
new file mode 100644
index 0000000..0dca981
--- /dev/null
+++ b/roms/demos/Maze (alt) [David Winter, 199x].ch8
Binary files differ
diff --git a/roms/demos/Maze (alt) [David Winter, 199x].txt b/roms/demos/Maze (alt) [David Winter, 199x].txt
new file mode 100644
index 0000000..2cdef41
--- /dev/null
+++ b/roms/demos/Maze (alt) [David Winter, 199x].txt
@@ -0,0 +1,12 @@
+Maze, by David Winter
+
+Drawing a random maze like this one consists in drawing random diagonal
+lines. There are two possibilities: right-to-left line, and left-to-right
+line. Each line is composed of a 4*4 bitmap. As the lines must form non-
+circular angles, the two bitmaps won't be '/' and '\'. The first one
+(right line) will be a little bit modified. See at the end of this source.
+
+The maze is composed of 16 lines (as the bitmaps are 4 pixels high), each
+line consists of 32 bitmaps.
+Bitmaps are drawn in random mode. We choose a random value (0 or 1).
+If it is 1, we draw a left line bitmap. If it is 0, we draw a right one.
diff --git a/roms/demos/Maze [David Winter, 199x].ch8 b/roms/demos/Maze [David Winter, 199x].ch8
new file mode 100644
index 0000000..152ae7d
--- /dev/null
+++ b/roms/demos/Maze [David Winter, 199x].ch8
Binary files differ
diff --git a/roms/demos/Maze [David Winter, 199x].txt b/roms/demos/Maze [David Winter, 199x].txt
new file mode 100644
index 0000000..2cdef41
--- /dev/null
+++ b/roms/demos/Maze [David Winter, 199x].txt
@@ -0,0 +1,12 @@
+Maze, by David Winter
+
+Drawing a random maze like this one consists in drawing random diagonal
+lines. There are two possibilities: right-to-left line, and left-to-right
+line. Each line is composed of a 4*4 bitmap. As the lines must form non-
+circular angles, the two bitmaps won't be '/' and '\'. The first one
+(right line) will be a little bit modified. See at the end of this source.
+
+The maze is composed of 16 lines (as the bitmaps are 4 pixels high), each
+line consists of 32 bitmaps.
+Bitmaps are drawn in random mode. We choose a random value (0 or 1).
+If it is 1, we draw a left line bitmap. If it is 0, we draw a right one.
diff --git a/roms/demos/Particle Demo [zeroZshadow, 2008].ch8 b/roms/demos/Particle Demo [zeroZshadow, 2008].ch8
new file mode 100644
index 0000000..2df9765
--- /dev/null
+++ b/roms/demos/Particle Demo [zeroZshadow, 2008].ch8
Binary files differ
diff --git a/roms/demos/Particle Demo [zeroZshadow, 2008].txt b/roms/demos/Particle Demo [zeroZshadow, 2008].txt
new file mode 100644
index 0000000..25f05fa
--- /dev/null
+++ b/roms/demos/Particle Demo [zeroZshadow, 2008].txt
@@ -0,0 +1,6 @@
+This is my particledemo for the Chip-8, SuperChip and MegaChip8.
+Works on real hardware as well as emulators
+
+Enjoy!
+
+ zeroZshadow \ No newline at end of file
diff --git a/roms/demos/Sierpinski [Sergey Naydenov, 2010].ch8 b/roms/demos/Sierpinski [Sergey Naydenov, 2010].ch8
new file mode 100644
index 0000000..e02d458
--- /dev/null
+++ b/roms/demos/Sierpinski [Sergey Naydenov, 2010].ch8
Binary files differ
diff --git a/roms/demos/Sirpinski [Sergey Naydenov, 2010].ch8 b/roms/demos/Sirpinski [Sergey Naydenov, 2010].ch8
new file mode 100644
index 0000000..e02d458
--- /dev/null
+++ b/roms/demos/Sirpinski [Sergey Naydenov, 2010].ch8
Binary files differ
diff --git a/roms/demos/Stars [Sergey Naydenov, 2010].ch8 b/roms/demos/Stars [Sergey Naydenov, 2010].ch8
new file mode 100644
index 0000000..712e83c
--- /dev/null
+++ b/roms/demos/Stars [Sergey Naydenov, 2010].ch8
Binary files differ
diff --git a/roms/demos/Trip8 Demo (2008) [Revival Studios].ch8 b/roms/demos/Trip8 Demo (2008) [Revival Studios].ch8
new file mode 100644
index 0000000..d88d28f
--- /dev/null
+++ b/roms/demos/Trip8 Demo (2008) [Revival Studios].ch8
Binary files differ
diff --git a/roms/demos/Trip8 Demo (2008) [Revival Studios].txt b/roms/demos/Trip8 Demo (2008) [Revival Studios].txt
new file mode 100644
index 0000000..398142f
--- /dev/null
+++ b/roms/demos/Trip8 Demo (2008) [Revival Studios].txt
@@ -0,0 +1,49 @@
+-----------------------------------------------------------------------------
+ /////////////////
+ //////////////////
+ //// ////
+ //// ///////////
+ //// ///////////
+ //// ////
+ //// ///////////
+ //// //////////
+
+ www.revival-studios.com
+-----------------------------------------------------------------------------
+Title : Trip8 / SuperTrip8 demo
+Author : Martijn Wenting / Revival Studios
+Genre : Demo
+System : Chip-8 / SuperChip8
+Date : 14/10/2008
+Product ID : RS-C8004
+-----------------------------------------------------------------------------
+
+All the contents of this package are (c)Copyright 2008 Revival Studios.
+
+The contents of the package may only be spread in its original form, and may not be
+published or distributed otherwise without the written permission of the authors.
+
+Description:
+------------
+The Trip8/SuperTrip8 demo are demo's for the Chip-8 and SuperChip8 systems. The demo consists of an intro, 3D vectorballs, and 4 randomized dot-effects.
+
+Writing a demo for the original Chip-8 interpreter was a real pain, since your framerate basically drops in half for every sprite you need to draw. So even clearing and redrawing a few dots will cause the framerate to drop to near zero :) Originally the demo was going to be bigger and there were much more graphical effects programmed/prototyped, but a lot of these effects turned out to be too much for the original unoptimized Chip-8 interpreters to handle.
+
+Running the Demo:
+-----------------
+Use the Megachip emulator or any other Chip-8/SuperChip compatible emulator to run the slideshow.
+
+Credits:
+--------
+Programming/Graphics/Design by: Martijn Wenting
+
+Distribution:
+-------------
+This package can be freely distributed in its original form.
+If you would like to include this slideshow in your rom package, please let me know.
+
+Watch out for more releases soon!
+
+
+ Martijn Wenting / Revival Studios
+
diff --git a/roms/demos/Zero Demo [zeroZshadow, 2007].ch8 b/roms/demos/Zero Demo [zeroZshadow, 2007].ch8
new file mode 100644
index 0000000..8dbe615
--- /dev/null
+++ b/roms/demos/Zero Demo [zeroZshadow, 2007].ch8
@@ -0,0 +1,11 @@
+`
+ef
+ghabcd`
+¢xÐVp
+¢~Ðfp
+¢„Ðvp
+¢ŠÐ†jú`
+¢xÐVEaÿEa…ÐVp
+¢~ÐfFbÿFb†$Ðfp
+¢„ÐvGcÿGc‡4Ðvp
+¢ŠÐ†HdÿHdˆDІ*ÿ 0ÀÿÿÀÀüÀÿðÌÌðÌÃ<ÃÃÃÃ< \ No newline at end of file
diff --git a/roms/demos/Zero Demo [zeroZshadow, 2007].txt b/roms/demos/Zero Demo [zeroZshadow, 2007].txt
new file mode 100644
index 0000000..4baeb81
--- /dev/null
+++ b/roms/demos/Zero Demo [zeroZshadow, 2007].txt
@@ -0,0 +1,3 @@
+This is my first program for the CHIP-8, a simple demo with 4 bouncing sprites.
+
+Enjoy! \ No newline at end of file
diff --git a/roms/games/15 Puzzle [Roger Ivie] (alt).ch8 b/roms/games/15 Puzzle [Roger Ivie] (alt).ch8
new file mode 100644
index 0000000..3dea177
--- /dev/null
+++ b/roms/games/15 Puzzle [Roger Ivie] (alt).ch8
Binary files differ
diff --git a/roms/games/15 Puzzle [Roger Ivie].ch8 b/roms/games/15 Puzzle [Roger Ivie].ch8
new file mode 100644
index 0000000..3ef0bc8
--- /dev/null
+++ b/roms/games/15 Puzzle [Roger Ivie].ch8
Binary files differ
diff --git a/roms/games/15 Puzzle [Roger Ivie].txt b/roms/games/15 Puzzle [Roger Ivie].txt
new file mode 100644
index 0000000..8abe295
--- /dev/null
+++ b/roms/games/15 Puzzle [Roger Ivie].txt
@@ -0,0 +1 @@
+Same than PUZZLE2. Wait for randomization... Instead of moving the item by pressing his associated key, move it UP DOWN LEFT RIGHT with respectively 2 8 4 6. Up and Down are inverted as the game uses the original CHIP8 keyboard. \ No newline at end of file
diff --git a/roms/games/Addition Problems [Paul C. Moews].ch8 b/roms/games/Addition Problems [Paul C. Moews].ch8
new file mode 100644
index 0000000..dedf7cb
--- /dev/null
+++ b/roms/games/Addition Problems [Paul C. Moews].ch8
Binary files differ
diff --git a/roms/games/Airplane.ch8 b/roms/games/Airplane.ch8
new file mode 100644
index 0000000..cac8804
--- /dev/null
+++ b/roms/games/Airplane.ch8
Binary files differ
diff --git a/roms/games/Animal Race [Brian Astle].ch8 b/roms/games/Animal Race [Brian Astle].ch8
new file mode 100644
index 0000000..56718da
--- /dev/null
+++ b/roms/games/Animal Race [Brian Astle].ch8
Binary files differ
diff --git a/roms/games/Animal Race [Brian Astle].txt b/roms/games/Animal Race [Brian Astle].txt
new file mode 100644
index 0000000..96cd592
--- /dev/null
+++ b/roms/games/Animal Race [Brian Astle].txt
@@ -0,0 +1,32 @@
+9. VIP Animal Race
+
+Animal Race is a fun game for one person, with an element of luck - sure to
+put a smile on your face. Five different animals race against one another
+and you have the chance to test your expertise at picking the winner.
+
+
+How To Play Animal Race
+
+1. Load the CHIP-8 interpretor at 0000-01FF
+ and the game starting at 0200.
+
+2. Turn RUN switch on.
+
+3. Wait until the animals are lined up and read to start, then select an animal
+ by pressing a letter A through E. A mark will appear to the left of the
+ animal to remind you of the one you have selected.
+
+4. Decide how much you want to bet (up to a limit of $9), then press that key.
+
+5. After the race is over, press zero (or any key) to start the next race.
+ Your winnings or losses will be computed and the new total displayed at
+ the begining of the next race.
+
+Hints for expert players
+All animals move at approximately the same speed, but they start from different
+positions. The odds for each animal are related to the starting position but
+include a random element. Some races favor the player and you should bet up to
+the limit on these. Some races are unfavorable and you should bet carefully
+on these.
+
+You can win the game by accumulating $256 or more.
diff --git a/roms/games/Astro Dodge [Revival Studios, 2008].ch8 b/roms/games/Astro Dodge [Revival Studios, 2008].ch8
new file mode 100644
index 0000000..e41bf2c
--- /dev/null
+++ b/roms/games/Astro Dodge [Revival Studios, 2008].ch8
Binary files differ
diff --git a/roms/games/Astro Dodge [Revival Studios, 2008].txt b/roms/games/Astro Dodge [Revival Studios, 2008].txt
new file mode 100644
index 0000000..c1984b8
--- /dev/null
+++ b/roms/games/Astro Dodge [Revival Studios, 2008].txt
@@ -0,0 +1,52 @@
+-----------------------------------------------------------------------------
+ /////////////////
+ //////////////////
+ //// ////
+ //// ///////////
+ //// ///////////
+ //// ////
+ //// ///////////
+ //// //////////
+
+ www.revival-studios.com
+-----------------------------------------------------------------------------
+Title : Astro Dodge
+Author : Martijn Wenting / Revival Studios
+Genre : Game
+System : Chip8 / SuperChip8
+Date : 18/12/2008
+Product ID : RS-C8003
+-----------------------------------------------------------------------------
+
+All the contents of this package are (c)Copyright 2008 Revival Studios.
+
+The contents of the package may only be spread in its original form, and may not be
+published or distributed otherwise without the written permission of the authors.
+
+Description:
+------------
+Astro Dodge is an arcade game for the Chip8 and SuperChip8 systems.
+Both versions of the game are included in this package.
+
+Your goal is to make your way through the asteroids field and dodge the asteroids, scoring points for each asteroid you are able to dodge.
+Button 2,4,6,8 will move your ship, button 5 will start the game.
+
+Running the game(s):
+--------------------
+The CHIP8 version of the game has been programmed to be compatible with original hardware like the Cosmac VIP and Telmac 1800.
+Use the Megachip emulator or any other Chip8/SuperChip compatible emulator to run the game(s).
+
+Credits:
+--------
+Programming and Graphics by: Martijn Wenting
+
+Distribution:
+-------------
+This package can be freely distributed in its original form.
+If you would like to include this game in your rom package, please let me know.
+
+Watch out for more releases soon!
+
+
+ Martijn Wenting / Revival Studios
+
diff --git a/roms/games/Biorhythm [Jef Winsor].ch8 b/roms/games/Biorhythm [Jef Winsor].ch8
new file mode 100644
index 0000000..1701460
--- /dev/null
+++ b/roms/games/Biorhythm [Jef Winsor].ch8
Binary files differ
diff --git a/roms/games/Biorhythm [Jef Winsor].txt b/roms/games/Biorhythm [Jef Winsor].txt
new file mode 100644
index 0000000..53a99aa
--- /dev/null
+++ b/roms/games/Biorhythm [Jef Winsor].txt
@@ -0,0 +1,58 @@
+13. VIP Biorhythm
+
+The theory of Biorhythm states that there are thre predominant cycles that can influence
+human behavior. These include a 23-day physical cycle, a 28-day emotional cycle and a
+33-day intellectual cycle. All three cycles start at birth and continue throughout life.
+
+Each cycle consists of a positive and a negative period. Physical, Emotional and
+Intellectual aspects are enhanced during positive periods. Poor performance is
+indicated by the negative period of a cycle.
+
+A critical day occurs on the crossover from the positive to the negative period or
+vice versa. A critical day indicates instability in a particular aspect.
+
+
+How to Use VIP Biorhythm
+
+1. Load the CHIP-8 interpreter at 0000-01FF and
+ the game starting at 0200.
+
+2. Turn RUN switch on.
+
+3. Enter birthdate using 2-digit month, 2-digit day, and 4-digit year.
+
+4. Enter start date using 2-digit month, 2-digit day, and 4-digit year. The start date
+ indicates the first day of the 32-day Biorhythm chart the program will generate.
+
+5. After a period of calculation proportional to the span of time involved, the three
+ cycle curves will be shown for a 32-day period. Each horizontal bit position
+ represents one day in the cycle. The start day, on the left, and every seventh
+ day are indicated by week markers. The first day of a positive or negative period
+ is a critical day.
+
+6. To advance the start date, hold key F down until the desired date is reached.
+ To decrement the start date, hold key B down. These functions allow changing the
+ start date slightly without reentering all the dates and waiting for the calculations
+ to be preformed.
+
+7. Press Key 0 to clear the screen and enter a new set of dates.
+
+
+
+ See VIPG1-13.jpg
+
+
+INTERPRETATION
+
+
+ Physical Emotional Intellectual
+
+Positive Period Strong, Good moods, Good Judgement
+(Up) Vigorous Cooperative Sharp Mentally
+
+Negative Period Tire easily, Low Enthusiasm, Low attentiveness
+(Down) Less Stamina Feelings Subdued and concentration
+
+Critical Days Susceptible to injury emotionally unstable, Poor memory,
+(Crossover) or Illness, Upset easily Prone to mistakes
+ Low endurance
diff --git a/roms/games/Blinky [Hans Christian Egeberg, 1991].ch8 b/roms/games/Blinky [Hans Christian Egeberg, 1991].ch8
new file mode 100644
index 0000000..235cf98
--- /dev/null
+++ b/roms/games/Blinky [Hans Christian Egeberg, 1991].ch8
Binary files differ
diff --git a/roms/games/Blinky [Hans Christian Egeberg] (alt).ch8 b/roms/games/Blinky [Hans Christian Egeberg] (alt).ch8
new file mode 100644
index 0000000..9ac79fc
--- /dev/null
+++ b/roms/games/Blinky [Hans Christian Egeberg] (alt).ch8
Binary files differ
diff --git a/roms/games/Blitz [David Winter].ch8 b/roms/games/Blitz [David Winter].ch8
new file mode 100644
index 0000000..0d2effa
--- /dev/null
+++ b/roms/games/Blitz [David Winter].ch8
Binary files differ
diff --git a/roms/games/Blitz [David Winter].txt b/roms/games/Blitz [David Winter].txt
new file mode 100644
index 0000000..ceb9444
--- /dev/null
+++ b/roms/games/Blitz [David Winter].txt
@@ -0,0 +1,4 @@
+Blitz, by: David Winter
+
+This game is a BOMBER clone. You are in a plane, and you must destroy the towers of a town. Your plane is flying left to right, and goes down. Use 5 to drop a bomb. The game ends when you crash yourself on a tower...
+
diff --git a/roms/games/Bowling [Gooitzen van der Wal].ch8 b/roms/games/Bowling [Gooitzen van der Wal].ch8
new file mode 100644
index 0000000..609d976
--- /dev/null
+++ b/roms/games/Bowling [Gooitzen van der Wal].ch8
Binary files differ
diff --git a/roms/games/Bowling [Gooitzen van der Wal].txt b/roms/games/Bowling [Gooitzen van der Wal].txt
new file mode 100644
index 0000000..3faf169
--- /dev/null
+++ b/roms/games/Bowling [Gooitzen van der Wal].txt
@@ -0,0 +1,53 @@
+7. VIP Bowling
+
+Bowling is a great game for recreation and competion requiring skill and a little
+bit of luck. This program simulates bowling closely with regular scoring and the
+option of using three different spins on the ball.
+
+How to play VIP Bowling
+
+1. Load the CHIP-8 interpretor at 0000-01FF
+ and the game starting at 0200.
+
+2. Turn RUN switch on.
+
+3. Up to 6 persons can compete. Make the choice by pressing Key 1,2,3,4,5 or 6.
+ The players will be referred to as A,B,C,D,E and F.
+
+4. It is possible to play up to 10 frames in one game. Make your choice of the
+ number of frames by pressing Key 1,2,3,4,5,6,7,8,9 or 0 (for 10 frames).
+
+5. It is possible to choose 3 ball speeds (Key 1,2 or 3). The speed option only
+ affects the ball after it is released.
+
+6. At the start of a player's turn, the video will display whose turn it is and
+ whether he is working on a spare, strike, 2 strikes or nothing.
+ Release the ball by pressing on of the following keys: Key 1,2,3,5,7,8 or 9.
+ -Key 5 will cause a straight ball.
+ -Key 1,2 and 3 will cause the ball to spin up.
+ -Key 1 before the first pin
+ -Key 2 after the first pin
+ -Key 3 after the second pin
+ -Key 7,8 and 9 will cause the ball to spin up.
+ -Key 7 before the first pin
+ -Key 8 after the first pin
+ -Key 9 after the second pin
+
+7. After the player's turn ends, the video will display whose turn it was, the
+ frame, and the score. The next players follows the instructions at 6 above.
+
+8. After all players have had their turn in a frame, the video will display the
+ total of each player and whether he is working on a spare, 1 strike, 2 strikes
+ or nothing. It will display the frame number and the total number of frames
+ to go (unless the last frame was played).
+ After pressing Any key, player A can start in the next frame. Continue with
+ instruction 6 above.
+
+9. If all frames in the game have been finished, press any key again. The player's
+ who are still working on a spare will recieve 1 more ball, and those working
+ on 1 or 2 strikes will receive 2 balls.
+
+10. After all players have finished the game, the final score will be displayed.
+
+
+ \ No newline at end of file
diff --git a/roms/games/Breakout (Brix hack) [David Winter, 1997].ch8 b/roms/games/Breakout (Brix hack) [David Winter, 1997].ch8
new file mode 100644
index 0000000..622fc4e
--- /dev/null
+++ b/roms/games/Breakout (Brix hack) [David Winter, 1997].ch8
Binary files differ
diff --git a/roms/games/Breakout (Brix hack) [David Winter, 1997].txt b/roms/games/Breakout (Brix hack) [David Winter, 1997].txt
new file mode 100644
index 0000000..e09efd6
--- /dev/null
+++ b/roms/games/Breakout (Brix hack) [David Winter, 1997].txt
@@ -0,0 +1,6 @@
+Breakout (Brix hack), by: David Winter
+
+This game is an "arkanoid" precursor. You have 5 lives, and your goal is the destruction of all the brixs. Use 4 and 6 to move your paddle. The game ends when all the brixs are destroyed.
+
+This game is the same than BRIX, but has graphics looking like the game on the Atari 2600 console.
+
diff --git a/roms/games/Breakout [Carmelo Cortez, 1979].ch8 b/roms/games/Breakout [Carmelo Cortez, 1979].ch8
new file mode 100644
index 0000000..70b50db
--- /dev/null
+++ b/roms/games/Breakout [Carmelo Cortez, 1979].ch8
Binary files differ
diff --git a/roms/games/Breakout [Carmelo Cortez, 1979].txt b/roms/games/Breakout [Carmelo Cortez, 1979].txt
new file mode 100644
index 0000000..74970f9
--- /dev/null
+++ b/roms/games/Breakout [Carmelo Cortez, 1979].txt
@@ -0,0 +1,4 @@
+Breakout, by: Carmelo Cortez
+
+The game, Breakout, is a variation of the Wipe-Off game.
+You have six walls and 20 balls to start. To win you must get through all walls to the top of the screen. At the end of the game the program will show the number of times you hit the walls and will show "FREE!" if you get through. \ No newline at end of file
diff --git a/roms/games/Brick (Brix hack, 1990).ch8 b/roms/games/Brick (Brix hack, 1990).ch8
new file mode 100644
index 0000000..72a366e
--- /dev/null
+++ b/roms/games/Brick (Brix hack, 1990).ch8
Binary files differ
diff --git a/roms/games/Brick (Brix hack, 1990).txt b/roms/games/Brick (Brix hack, 1990).txt
new file mode 100644
index 0000000..6c36db5
--- /dev/null
+++ b/roms/games/Brick (Brix hack, 1990).txt
@@ -0,0 +1,3 @@
+BRICK: a modified version of BRIX, a CHIP-8 game.
+Original BRIX by Andreas Gustafsson.
+This one is a solid wall; no air between bricks! \ No newline at end of file
diff --git a/roms/games/Brix [Andreas Gustafsson, 1990].ch8 b/roms/games/Brix [Andreas Gustafsson, 1990].ch8
new file mode 100644
index 0000000..ad639d9
--- /dev/null
+++ b/roms/games/Brix [Andreas Gustafsson, 1990].ch8
Binary files differ
diff --git a/roms/games/Cave.ch8 b/roms/games/Cave.ch8
new file mode 100644
index 0000000..d5a865f
--- /dev/null
+++ b/roms/games/Cave.ch8
Binary files differ
diff --git a/roms/games/Coin Flipping [Carmelo Cortez, 1978].ch8 b/roms/games/Coin Flipping [Carmelo Cortez, 1978].ch8
new file mode 100644
index 0000000..518e1d5
--- /dev/null
+++ b/roms/games/Coin Flipping [Carmelo Cortez, 1978].ch8
Binary files differ
diff --git a/roms/games/Coin Flipping [Carmelo Cortez, 1978].txt b/roms/games/Coin Flipping [Carmelo Cortez, 1978].txt
new file mode 100644
index 0000000..225d0e6
--- /dev/null
+++ b/roms/games/Coin Flipping [Carmelo Cortez, 1978].txt
@@ -0,0 +1,5 @@
+Coin Flipping, by: Carmelo Cortez
+
+The game is a Coin FlLpping program. Flip run up and the
+computer starts to flip a coin, and at the same tine shosing heads
+and tails on the screen, stopping at the value set in VC.
diff --git a/roms/games/Connect 4 [David Winter].ch8 b/roms/games/Connect 4 [David Winter].ch8
new file mode 100644
index 0000000..200a67a
--- /dev/null
+++ b/roms/games/Connect 4 [David Winter].ch8
Binary files differ
diff --git a/roms/games/Connect 4 [David Winter].txt b/roms/games/Connect 4 [David Winter].txt
new file mode 100644
index 0000000..9bd2752
--- /dev/null
+++ b/roms/games/Connect 4 [David Winter].txt
@@ -0,0 +1,10 @@
+Connect 4, by: David Winter
+
+This game is for two players. The goal is to align 4 coins in the
+game area. Each player's coins are colored. When you drop a coin,
+it is paced on the latest dropped coin in the same column, or at
+the bottom if the column is empty. Once the column is full, you
+cannot place any more coins in it. To select a column, use 4 and 6.
+
+To drop a coin, use 5. There is no winner detection yet. This will
+be soon avalaible (Hey! I don't spend my life on CHIP8 !).
diff --git a/roms/games/Craps [Camerlo Cortez, 1978].ch8 b/roms/games/Craps [Camerlo Cortez, 1978].ch8
new file mode 100644
index 0000000..1717024
--- /dev/null
+++ b/roms/games/Craps [Camerlo Cortez, 1978].ch8
Binary files differ
diff --git a/roms/games/Craps [Camerlo Cortez, 1978].txt b/roms/games/Craps [Camerlo Cortez, 1978].txt
new file mode 100644
index 0000000..1ea42a4
--- /dev/null
+++ b/roms/games/Craps [Camerlo Cortez, 1978].txt
@@ -0,0 +1,4 @@
+Craps, by: Camerlo Cortez
+
+To use the Craps program, press any key to roll dice.
+7 or 11 wins, 12, 2 or 3 loses on first roll. The second roll must match the first to win, but if you roll a seven you lose. This program could be expanded to include on-the-screen scoring of bets.
diff --git a/roms/games/Deflection [John Fort].ch8 b/roms/games/Deflection [John Fort].ch8
new file mode 100644
index 0000000..f218966
--- /dev/null
+++ b/roms/games/Deflection [John Fort].ch8
Binary files differ
diff --git a/roms/games/Deflection [John Fort].txt b/roms/games/Deflection [John Fort].txt
new file mode 100644
index 0000000..df2ddce
--- /dev/null
+++ b/roms/games/Deflection [John Fort].txt
@@ -0,0 +1,54 @@
+8. VIP DEFLECTION
+
+In the VIP Deflection game you position mirrors anywhere on the display screen.
+The object of the game is to deflect a ball of the mirrors a maximum number of
+times before hitting the target.
+
+The number of deflections times the target number gives you deflection points.
+These are added to your previous point total. If you fail to hit the target you
+get no points. The winner of the game is the player who accumulates 257 or
+more deflected points.
+
+How to Play VIP Deflection
+
+1. Load the CHIP-8 interpretor at 0000-01FF
+ and the game starting at 0200.
+
+2. Turn RUN switch on.
+
+3. After the scores appear a letter, the target with a number and a ball. The
+ letter signifies the player who will program the mirrors. This sequence will
+ be repeated until there is a winner.
+
+4. To program the mirrors, select the proper mirror type by using Table 1 (VIP1-8.jpg)
+ as a guide. Key 1 will place a horizontal mirror on the board. Key 2 selects a
+ vertical mirror, Key 3 a slant-left mirror, Key 4 a slant-right mirror.
+
+5. After a mirror has been selected, you may position the mirror by using keys 1
+ through 4 and 6 through 9 (see Table 2 for movement of a mirror). Once a
+ mirror has been selected and positioned, it may be fixed into position by pressing
+ Key 5.
+
+ Table 2 - Mirror Positioning and Ball Direction
+ Key Selection | Positioning and Direction
+ ------------------+---------------------------
+ 1 | up and to the left
+ 2 | up
+ 3 | up and to the right
+ 4 | left
+ 5 | right
+ 7 | down and to the left
+ 8 | down
+ 9 | down and to the right
+
+6. You may position up to 10 mirrors on the game board. After you have the maximum
+ amount on the board you must press Key 0 to progress to the fire mode. If you
+ wish to progress to the fire mode with less than 10 mirrors programmed, you may
+ do so by pressing Key 0. You fire the ball in the direction you want by using
+ Keys 1 through 4 and Keys 6 through 9 (see Table 2).
+
+7. After the ball has reached the target or leaves the game board, the player's
+ score is computed and displayed and a new ball and target appear.
+
+
+
diff --git a/roms/games/Figures.ch8 b/roms/games/Figures.ch8
new file mode 100644
index 0000000..6563bad
--- /dev/null
+++ b/roms/games/Figures.ch8
Binary files differ
diff --git a/roms/games/Filter.ch8 b/roms/games/Filter.ch8
new file mode 100644
index 0000000..15ab24c
--- /dev/null
+++ b/roms/games/Filter.ch8
Binary files differ
diff --git a/roms/games/Guess [David Winter] (alt).ch8 b/roms/games/Guess [David Winter] (alt).ch8
new file mode 100644
index 0000000..36f783d
--- /dev/null
+++ b/roms/games/Guess [David Winter] (alt).ch8
Binary files differ
diff --git a/roms/games/Guess [David Winter] (alt).txt b/roms/games/Guess [David Winter] (alt).txt
new file mode 100644
index 0000000..c50f343
--- /dev/null
+++ b/roms/games/Guess [David Winter] (alt).txt
@@ -0,0 +1 @@
+Think to a number between 1 and 63. CHIP8 shows you several boards and you have to tell if you see your number in them. Press 5 if so, or another key if not. CHIP8 gives you the number...
diff --git a/roms/games/Guess [David Winter].ch8 b/roms/games/Guess [David Winter].ch8
new file mode 100644
index 0000000..8f151f1
--- /dev/null
+++ b/roms/games/Guess [David Winter].ch8
Binary files differ
diff --git a/roms/games/Guess [David Winter].txt b/roms/games/Guess [David Winter].txt
new file mode 100644
index 0000000..c50f343
--- /dev/null
+++ b/roms/games/Guess [David Winter].txt
@@ -0,0 +1 @@
+Think to a number between 1 and 63. CHIP8 shows you several boards and you have to tell if you see your number in them. Press 5 if so, or another key if not. CHIP8 gives you the number...
diff --git a/roms/games/Hi-Lo [Jef Winsor, 1978].ch8 b/roms/games/Hi-Lo [Jef Winsor, 1978].ch8
new file mode 100644
index 0000000..90a872a
--- /dev/null
+++ b/roms/games/Hi-Lo [Jef Winsor, 1978].ch8
Binary files differ
diff --git a/roms/games/Hi-Lo [Jef Winsor, 1978].txt b/roms/games/Hi-Lo [Jef Winsor, 1978].txt
new file mode 100644
index 0000000..3fbd65f
--- /dev/null
+++ b/roms/games/Hi-Lo [Jef Winsor, 1978].txt
@@ -0,0 +1,3 @@
+Hi-Lo, by: Jef Winsor
+
+You have 10 chances to guess the value of a random number between 00 and 99 selected by the program. The number at the right of the screen shows the number of the guess you are using. Enter a two digit number and the computer tells you if you are high or low. Press any key to erase this number and then, try again. If you have failed after ten guesses, press any key and the number will be shown. If you are good you will never need more than seven guesses.
diff --git a/roms/games/Hidden [David Winter, 1996].ch8 b/roms/games/Hidden [David Winter, 1996].ch8
new file mode 100644
index 0000000..bd6b18d
--- /dev/null
+++ b/roms/games/Hidden [David Winter, 1996].ch8
Binary files differ
diff --git a/roms/games/Hidden [David Winter, 1996].txt b/roms/games/Hidden [David Winter, 1996].txt
new file mode 100644
index 0000000..4b68fd7
--- /dev/null
+++ b/roms/games/Hidden [David Winter, 1996].txt
@@ -0,0 +1,28 @@
+ ----------------------------------------
+ HIDDEN!
+ Copyright (1996) by David WINTER
+ ----------------------------------------
+
+
+HIDDEN is a "memory" game. It is very simple to play.
+
+The rules are as follow: your goal is to find all the identical cards
+in a minimum time.
+
+You are playing in a 4*4 card grid. You can see only two cards at the
+same time. Once this time passed, these two cards will remain shown
+if they are identical, otherwise they will be hidden again.
+
+When the game is finished, two scores are shown:
+ SC is your score, corresponding to the number of tries
+ HI is the best score (smallest number of tries made to finish)
+
+The keys are:
+
+ [2] : More DOWN
+ [4] : Move LEFT
+ [5] : Show card
+ [6] : Move RIGHT
+ [8] : Move UP
+
+Enjoy !!!
diff --git a/roms/games/Kaleidoscope [Joseph Weisbecker, 1978].ch8 b/roms/games/Kaleidoscope [Joseph Weisbecker, 1978].ch8
new file mode 100644
index 0000000..b1c8888
--- /dev/null
+++ b/roms/games/Kaleidoscope [Joseph Weisbecker, 1978].ch8
Binary files differ
diff --git a/roms/games/Kaleidoscope [Joseph Weisbecker, 1978].txt b/roms/games/Kaleidoscope [Joseph Weisbecker, 1978].txt
new file mode 100644
index 0000000..3b9ff46
--- /dev/null
+++ b/roms/games/Kaleidoscope [Joseph Weisbecker, 1978].txt
@@ -0,0 +1,7 @@
+VIP Kaleidoscope, by: Joseph Weisbecker
+
+Four spots appear in a group at the center of the screen. Press keys 2, 4, 6, or 8 to create a pattern. Keep your pattern smaller than 138 key depressions.
+
+Push key 0 to terminate pattern entry. Pushing key 0 causes your pattern to be continuously repeated forming a fascinating, changing kaleidoscope display on the screen. A "44444442220" key sequence provides a very nice effect Experiment to
+find other nice patterns.
+
diff --git a/roms/games/Landing.ch8 b/roms/games/Landing.ch8
new file mode 100644
index 0000000..622e81f
--- /dev/null
+++ b/roms/games/Landing.ch8
Binary files differ
diff --git a/roms/games/Lunar Lander (Udo Pernisz, 1979).ch8 b/roms/games/Lunar Lander (Udo Pernisz, 1979).ch8
new file mode 100644
index 0000000..e7972b5
--- /dev/null
+++ b/roms/games/Lunar Lander (Udo Pernisz, 1979).ch8
Binary files differ
diff --git a/roms/games/Lunar Lander [Udo Pernisz, 1979].txt b/roms/games/Lunar Lander [Udo Pernisz, 1979].txt
new file mode 100644
index 0000000..176e1ae
--- /dev/null
+++ b/roms/games/Lunar Lander [Udo Pernisz, 1979].txt
@@ -0,0 +1,105 @@
+15. Lunar Lander
+
+You are descending to the floor of a 250-foot crater. The right side of the TV display
+shows amount of fuel, feet from bottom and fall rate per cycle. Lenght of fall rate
+cycle changes from about 1/4 second to one second. The fall rate increases by one
+foot per second/per cycle. The computer will update the display only at the end of
+each cycle.
+
+The left side of the display shows the Lunar Lander descending from 250 feet. The
+Lander will first appear at one of sixteen locations. It will then slowly drop down
+the crater. The crater walls have rock formations protruding from them which must
+be avoided. If either rocket motor should touch any part of the crater, the Lander
+will explode in a cloud of smoke and disintegrate. (Remember, these are atomic
+thrusters and react like miniature atomic bombs upon impact).
+
+When you reach 32 feet, the display will change, and you will see the crater floor.
+You must now ladn between the rock formations on the floo and maintain a minimum fall
+rate. As you drop your fall rate to zero, you soon discover that the Lander becomes
+more and more unstable just as any hovering object would. And now with perfect skill
+you guide the ship in for a perfect touch down, or?
+
+How to Play VIP Lunar Lander
+
+1. Load the CHIP-8 interpreter at 0000-01FF and teh game starting at 0200.
+
+2. Key 2 controls the thrust of the Lunar Lander. One tone beep equals one pound
+ of fuel and one foot of thrust.
+
+3. Key 4 controlls the horizontal stabilizing engine, and moves the Lander one
+ foot to the left per one pound of fuel.
+
+4. Key 6 controls the stabilization to the right.
+
+5. Stabilization controls only react after: (a) a complete fall cycle, or (b) after
+ the Key 2 thrust control is pressed. You must be aware of this at all times or
+ you will crash even though either key 4 or 6 is pressed.
+
+6. At the end of each cycle, the Lunar Lander will move randomly at the rate of one
+ foot either right or left. Therefore, as the fall rate approaches zero, the Lander
+ becomes more uncontrollable, and your horizontal stabilizers react more quickly.
+ (Just like the real thing).
+
+7. If you land too fast, the Lander will bounce and flip over.
+
+8. If you run out of fuel, the Lander will crash.
+
+9. You will not be allowed to go above 250 feet. If you try to do so, you will just
+ waste precious fuel.
+
+10. Once you reach 32 feet and move into the landing display, you will not be allowed
+ to rise above 26 feet. Trying to do so will waste more precious fuel.
+
+11. Game options
+
+ You may select one of three options at the begining of the game.
+
+ Option 1: You start at 250 feet. You are given 150 pounds of fuel. You must land
+ at 5 feet per second or less. The initial descent display is easy to
+ maneuver through.
+
+ Option 2: You start at 250 feet. You have 200 pounds of fuel. You must land at 3 feet
+ per second or less. The initial descent display is hard to maneuver through.
+
+ Option 3: You start at 32 feet. You have 100 pounds of fuel. You must land at 3 feet
+ per second or less. This display allows you to practice landing.
+
+ You should consider Option 2 as the complete game when trying for Astronaut Ratings.
+
+12. Astronaut Ratings
+
+ The computer will award you with ratings depending on how good a lander you are.
+
+ You will obtain the rating of Astronaut by landing without regard to fall rate or
+ fuel. You must not exceed fall rate, or zero fuel.
+
+ You will obtain the rating of Astronaut Pilot, by ladning with regard to fuel. 80
+ pounds or more if you land between the two rock formations on the floor, and 50
+ pounds or more if you land between the crater wall and a rock formation.
+
+ You will obtain the rating of Astronaut Captain by landing the ship with regard to
+ fuel as per above and if the fall rate is two feet per second or less. (Not an
+ easy task, as you will soon discover).
+
+13. About Graphics
+
+ This game has some interesting graphic displays when you run out of fuel, crash,
+ land too fast, when you land successfully. I will leave them to your discovery,
+ as they are fun to watch.
+
+14. Landing Sites
+
+ The final landing display will appear somewhat like the illustration below
+ (VIPG1-15.jpg). You may land in any of the three locations pointed to. To land
+ between the crater walls and rock formations, you will have to first bring the
+ Lander to a zero fall rate while hovering in the center landing area. Then bring
+ the ship up and just over the rock formation, and let it drop down to the landing
+ site. At the last moment, a few taps on the thruster button will slow the lander
+ to the required fall rate. It will take you many tries to land here, but don't
+ give up, it can be done!!
+
+NOTE: VIP Lunar Lander requires at least 3K of RAM. RAM memories are available to
+ increase your VIP from 2K to 3K at your local computer store or by contacting:
+ RCA VIP Marketing
+ New Holland Avenue
+ Lancaster, PA 17604
diff --git a/roms/games/Mastermind FourRow (Robert Lindley, 1978).ch8 b/roms/games/Mastermind FourRow (Robert Lindley, 1978).ch8
new file mode 100644
index 0000000..f403d71
--- /dev/null
+++ b/roms/games/Mastermind FourRow (Robert Lindley, 1978).ch8
Binary files differ
diff --git a/roms/games/Mastermind FourRow (Robert Lindley, 1978).txt b/roms/games/Mastermind FourRow (Robert Lindley, 1978).txt
new file mode 100644
index 0000000..e1a4d4f
--- /dev/null
+++ b/roms/games/Mastermind FourRow (Robert Lindley, 1978).txt
@@ -0,0 +1,13 @@
+ MASTERMIND
+ by
+ Robert Lindley
+
+I have progranmed two versLons of the game Mastermind. This game is distributed by Invicta Plastics, Suite 940, 200 - 5th Ave., New York, NY 10010, and is available most pLaces where toys and games are sold.
+For complete details of the game, please refer to their instructions. The information given here refers to this particular VIP iurplementation.
+The two versions are essentially the same except that the first has a four number code and the second has a five nr:mber hidden code selected at random.. In the four number version, the digits one through six are used and in the five number version the diglts zero through seven are used.
+While the game is running, the other hex keys, except key F, have no effect. Key F is used when you change your mind and want to change your input. This key erases the current partial entry.
+The game starts by displaying a series of dashes arranged in rows. As the game progresses, the player attempts to deduce the hidden code by replacing the dashes with digits entered via the hex keyboard. Each tlme a hex key is used, the selected digit replaces a dash in one vertical column. This vertical column is one guess of the ten allowed to deduce
+the hidden number. When the bottom dash in any column is replaced by a digit, that try is imidiately scored. This score appears below the current column. If any digit in the column exactly matches the hidden number digit in the same row, a broken bar will appear. then four or five (one for each row in the game) appear, the hidden number has been deduced
+and it will be revealed at the right end of the screen. If any digit in the column matches a hidden digit, but in an incorrect erorr, a white bar will appear. Note that the scoring is across all rows. For example, if there are two fives in a column and one of then is in the correct row and there is only one five in the hidden numbers, one broken bar will appear.
+When all allowed ten tries have been used, the hidden number will be revealed.
+
diff --git a/roms/games/Merlin [David Winter].ch8 b/roms/games/Merlin [David Winter].ch8
new file mode 100644
index 0000000..747843a
--- /dev/null
+++ b/roms/games/Merlin [David Winter].ch8
Binary files differ
diff --git a/roms/games/Merlin [David Winter].txt b/roms/games/Merlin [David Winter].txt
new file mode 100644
index 0000000..c953c78
--- /dev/null
+++ b/roms/games/Merlin [David Winter].txt
@@ -0,0 +1,4 @@
+Merlin, by: David Winter
+
+This is the SIMON game. The goal is to remember in which order the squares are lighted. The game begins by lighting 4 random squares, and then asks you to light the squares in the correct order.
+You win a level when you give the exact order, and each increasing level shows a additionnal square. The game ends when you light an incorrect square. Keys are 4 and 5 for the two upper squares, then 1 and 2 for the two other ones.
diff --git a/roms/games/Missile [David Winter].ch8 b/roms/games/Missile [David Winter].ch8
new file mode 100644
index 0000000..310e2de
--- /dev/null
+++ b/roms/games/Missile [David Winter].ch8
Binary files differ
diff --git a/roms/games/Most Dangerous Game [Peter Maruhnic].ch8 b/roms/games/Most Dangerous Game [Peter Maruhnic].ch8
new file mode 100644
index 0000000..8407c4f
--- /dev/null
+++ b/roms/games/Most Dangerous Game [Peter Maruhnic].ch8
Binary files differ
diff --git a/roms/games/Most Dangerous Game [Peter Maruhnic].txt b/roms/games/Most Dangerous Game [Peter Maruhnic].txt
new file mode 100644
index 0000000..db7ac9c
--- /dev/null
+++ b/roms/games/Most Dangerous Game [Peter Maruhnic].txt
@@ -0,0 +1,48 @@
+10. VIP Most Dangerous Game
+
+VIP Most Dangerous Game pits a hunter against a hunted in a maze. The hunter must
+shoot the hunted before either time runs out or the hunted escapes the maze.
+However, neither the hunted nor the hunter can see a wall in the maze until he runs
+into it. There is always at least one path through the maze.
+
+How To Play VIP Most Dangerous Game
+
+1. Load the CHIP-8 interpretor at 0000-01FF
+ and the game starting at 0200.
+
+2. Turn RUN switch on.
+
+3. Hunted's turn:
+ When the arrow appears in the lower left, it is the hunted's turn. Keys 2-4-6-8
+ control direction (up-left-right-down, respectively). The hunted continues to
+ move until a) he makes 5 moves, b) he hits a wall or c) key 0 is pressed.
+
+4. Hunter's turn
+ When the arrow appears in the lower right, it is the hunter's turn. The hunter's
+ turn consists of two modes, the move and the shoot. Keys 2-4-6-8 and 0 control both
+ modes. Like the hunted, the hunter continues to move until a) he makes 3 moves,
+ b) he hits a wall or c) key 0 is pressed. If he hits the wall, case b), he cannot
+ fire a bullet. The hunter may fire one of his bullets using the direction keys
+ 2-4-6-8. The bullet will travel four squares in the corresponding direction, unless
+ a wall is encountered. If the hunter prefers not to use a bullet, he must press key 0.
+
+5. Repeat steps 3 and 4 until:
+ a) The number of turns (upper left on the display) expire. The hunted wins.
+ b) The hunter lands on or shoots the hunted. The hunter wins.
+ c) The hunted lands on hunter, thereby giving up. The hunter wins.
+ d) The hunted reaches the lower right corner of the maze with at least 1 move
+ remaining in his turn. The hunted wins, by escaping the maze.
+
+6. Variations of VIP Most Dangerous Game may be played by changing certain bytes in
+ the program.
+
+Location Default Meaning
+0215 0F Number of turns in the game.
+0217 06 Number of bullets hunter has at start.
+0219 03 Number of moves per turn for the hunter.
+0221 01 Number of squares per move (hunted and hunter).
+022B 05 Number of moves per turn for the hunted.
+024B 01 If zero, walls are invisible.
+0355 04 Number of squares a bullet will go.
+04E3 70 Probability (out of 100Hex) of a wall appearing.
+04EB FE If FF, a wall may appear at previously tested boundaries.
diff --git a/roms/games/Nim [Carmelo Cortez, 1978].ch8 b/roms/games/Nim [Carmelo Cortez, 1978].ch8
new file mode 100644
index 0000000..680c96a
--- /dev/null
+++ b/roms/games/Nim [Carmelo Cortez, 1978].ch8
Binary files differ
diff --git a/roms/games/Nim [Carmelo Cortez, 1978].txt b/roms/games/Nim [Carmelo Cortez, 1978].txt
new file mode 100644
index 0000000..a747c81
--- /dev/null
+++ b/roms/games/Nim [Carmelo Cortez, 1978].txt
@@ -0,0 +1,4 @@
+Nim, by: Carmelo Cortez
+
+The Nim Game is a little less graphic than most games. The player may go first by pressing. "F" key, any other let the computer go first.
+You subtract 1, 2 or 3 fron the score. The one who ends up with the last number loses! \ No newline at end of file
diff --git a/roms/games/Paddles.ch8 b/roms/games/Paddles.ch8
new file mode 100644
index 0000000..26af3d2
--- /dev/null
+++ b/roms/games/Paddles.ch8
Binary files differ
diff --git a/roms/games/Pong (1 player).ch8 b/roms/games/Pong (1 player).ch8
new file mode 100644
index 0000000..65d6310
--- /dev/null
+++ b/roms/games/Pong (1 player).ch8
Binary files differ
diff --git a/roms/games/Pong (alt).ch8 b/roms/games/Pong (alt).ch8
new file mode 100644
index 0000000..295ce91
--- /dev/null
+++ b/roms/games/Pong (alt).ch8
Binary files differ
diff --git a/roms/games/Pong 2 (Pong hack) [David Winter, 1997].ch8 b/roms/games/Pong 2 (Pong hack) [David Winter, 1997].ch8
new file mode 100644
index 0000000..6af8d1e
--- /dev/null
+++ b/roms/games/Pong 2 (Pong hack) [David Winter, 1997].ch8
Binary files differ
diff --git a/roms/games/Pong [Paul Vervalin, 1990].ch8 b/roms/games/Pong [Paul Vervalin, 1990].ch8
new file mode 100644
index 0000000..e371e91
--- /dev/null
+++ b/roms/games/Pong [Paul Vervalin, 1990].ch8
Binary files differ
diff --git a/roms/games/Pong [Paul Vervalin, 1990].txt b/roms/games/Pong [Paul Vervalin, 1990].txt
new file mode 100644
index 0000000..c75bdf7
--- /dev/null
+++ b/roms/games/Pong [Paul Vervalin, 1990].txt
@@ -0,0 +1,9 @@
+OK. here is PONG version 1.1. The ball is a little faster in this
+version making play a little more realistic. I know PONG 1.0 was
+just posted yesterday, but I think this version is significantly
+better, so here it is.
+
+Use keys 7 and 4 move left player and / and * move right player.
+
+Enjoy!!
+
diff --git a/roms/games/Programmable Spacefighters [Jef Winsor].ch8 b/roms/games/Programmable Spacefighters [Jef Winsor].ch8
new file mode 100644
index 0000000..a605320
--- /dev/null
+++ b/roms/games/Programmable Spacefighters [Jef Winsor].ch8
Binary files differ
diff --git a/roms/games/Programmable Spacefighters [Jef Winsor].txt b/roms/games/Programmable Spacefighters [Jef Winsor].txt
new file mode 100644
index 0000000..8b7994d
--- /dev/null
+++ b/roms/games/Programmable Spacefighters [Jef Winsor].txt
@@ -0,0 +1,135 @@
+14. VIP Programmable Spacefighters
+
+Programmable Spacefighters is a combat game involving 2 to 8 spaceships competing
+for the domination of a contained field in space. The field of play is a
+two-dimensional representation of an oblong spheroid.
+
+The movement and fire of each spacefighter is controlled by programming a series of
+commands into each fighter's instruction storage table. Once all the spacefighters
+are programmed, they carry out their commands by sequentially executing a single step
+at a time. The play of the game ins divided into rounds. Each spacefighter may
+execute between 1 and 15 commands per round.
+
+The fighters all have the same appearance and capabilities. Players distinguish
+between fighters by examining the defense strength and position of their fighters
+at the begining of every round.
+
+Each fighter may face in any of 8 directions. All firing and forward movement
+occurs in the direction the fighter is currently facing. As a spacefighter crosses
+outside the two-dimensional field of play, it wraps around and re-enters on the
+opposite side of the field. Laser bursts terminate when they travel outside the
+field or hit a target.
+
+Each round consists of a selected number of steps. Each step is executed in 2 parts.
+During the first part, every spacefighter wishing to fire may execute a fire operation.
+The defense strength of any fighter which is hit by a laser burst is reduced by 1
+and a small flash appears.
+
+After all fighters have had an opportunity to execute fire instructions, the movement
+part of the step begins. Any fighter which has had its defense strength reduced to 0
+is destroyed and a longer flash appears. The defense strength is changed to a special
+code so that the fighter will no longer be programmable or take part in the execution
+phase. The destroyed fighter will still be open to examination during the Defense/
+Position Check phase. Fighers having a defense strength greater than 0 may execute
+a movement command if there is one. Breaking each step into 2 such parts removes any
+strategic advantage to moving first.
+
+The nature of the game, in that there are variable parameters and no fixed victory
+conditions, allows the players a lot of freedom. Two to eight players can command
+single fighters. Four or less players can each command multiple fighters. Two
+fleets could complete to destroy their opponents' flagship first. Handicaps can
+be implemented through an imbalance of fighters in different fleets. An odd number
+of players can play in a free for all or team game. In a non-combat approach, a full
+complement of space fighters could be programmed to preform in kaleidoscope or other
+type formations.
+
+
+How to Play VIP Programmable Spacefighters
+
+1. Load the CHIP-8 interpreter at 0000-01FF and
+ the game starting at 0200.
+
+2. Turn RUN switch on.
+
+3. Initalization of Game.
+ Various parameters are entered at the start of the game to determine the number
+ of spacefighters and other aspects of play.
+
+ S: Enter number of spacefighters. 1 to 8 spacefighters may be used. The program
+ will adjust invalid enteries to the nearest valid number.
+
+ D: Enter defense strength. A spacefighter may be hit from 1 to F times by laser
+ before being destroyed.
+
+ E: Enter number of command entries. A spacefighter may be programmed with 1 to F
+ commands during the programming phase of each round.
+
+ C: Enter clock duration/no clock. A timer clock 1 to F phorseks in duration may
+ be selected. Each phorsek equals 4 seconds. The clock is not enabled if a 0
+ is entered. The clock time is the time allowed for each fighter to be set up.
+
+ F: Enter fire power available. A spacefighter may be allowed to fire 1 to F
+ laser bursts per round.
+
+ A: Enter accumulation/no accumulation. A spacefighter may be allowed to accumulate
+ all unused laser bursts by entering 1 to F. Accumulation is not allowed if a
+ 0 is entered.
+
+4. Presentation of Field and Spacefighters.
+ The two-dimensional representation of the palying fields consists of 10 vertical
+ by 15 horizontal positons indicated by grid markings around the perimeter. The
+ spacefighters will be in their initial positions.
+
+5. Defense/Position Check.
+ Enter number of spacefighter to be examined.
+ S: Current spacefighter being examined.
+ D: Defense strength of current spacefighter.
+ Enter 0 to end defense/position check phase.
+
+6. Program Spacefighters.
+ Surviving spacefighters are programmed in ascending order. Enter 0 to begin
+ programming first spacefighter. Defense strength and position are shown during
+ programming.
+ E: indicates number of enteries left after current command.
+ C: indicates time remaining to program current fighter if clock was entered.
+
+ COMMAND FUNCTION
+ 1 Rotate 45 ccw, Move fwd
+ 2 Move fwd
+ 3 Rotate 45 cw, Move fwd
+ 4 Rotate 45 ccw
+ 5 Fire
+ 6 Rotate 45 cw
+ B Erase all commands and reprogram current spacefighter
+ E End programming of current spacefighter
+ 7-A,C,D,F Rest, No operation
+ 0 Rest, Begin programming next spacefighter
+
+ Enter 0 to begin programming each successive spacefighter.
+
+7. Execute Commands.
+ Enter 0 after all spacefighters are programmed to start execution of commands.
+
+8. The recommended starting point when tryint the game out is with 1 or 2 spacefighters,
+ any defense, F (15) entries per round, no clock, F (15) fire power and any accumulation
+ S: 1 or 2
+ D: 1
+ E: F
+ C: 0
+ F: F
+ A: 0
+
+ Use the above to try out the movement and fire execution of the fighters. Try
+ performing loops, figure 8's, tight turns, maximum fire coverage techniques, etc.
+ Start out simple when first playing the game against an opponent.
+ Eight spacefighters can get very complicated.
+
+9. Changing different parameters creates very different effects on the play of the game.
+ The main effect of a large number of fighters is a more complicated game. A large
+ number of enteries per round results in a more lively game involving farsighted
+ planning. Fewer enteries involves more thinking and reacting to immediate developments
+ but is not without strategy when there are multiple fighters opposing each other.
+ The clock provides pressure which can be greatly increased by the moves-to-time ratio.
+ More fire power increases the importance of movement and positioning. Accumulation
+ of fire power can have long range effects if there is low fire power and a large
+ number of moves per round.
diff --git a/roms/games/Puzzle.ch8 b/roms/games/Puzzle.ch8
new file mode 100644
index 0000000..bec7af0
--- /dev/null
+++ b/roms/games/Puzzle.ch8
Binary files differ
diff --git a/roms/games/Reversi [Philip Baltzer].ch8 b/roms/games/Reversi [Philip Baltzer].ch8
new file mode 100644
index 0000000..8a600f0
--- /dev/null
+++ b/roms/games/Reversi [Philip Baltzer].ch8
Binary files differ
diff --git a/roms/games/Reversi [Philip Baltzer].txt b/roms/games/Reversi [Philip Baltzer].txt
new file mode 100644
index 0000000..0396169
--- /dev/null
+++ b/roms/games/Reversi [Philip Baltzer].txt
@@ -0,0 +1,37 @@
+6. VIP REVERSI
+Reversi is a game over 100 years old, which has become popular recently under the
+name Othello. The game is played on a 8x8 square, using two kinds of markers.
+In VIP Reversi one player has the open markers and the other player the solid
+markers. The score for either player at any time is the total number of his markers
+on the square.
+
+How to play VIP Reversi
+
+1. Load the CHIP-8 interpretor at 0000-01FF
+ and the game starting at 0200.
+
+2. Turn RUN switch on.
+
+3. The 8x8 square will be formed and the starting marker configuration shown, having
+ two of each kind of marker in the center four locations of the square. The starting
+ score for each player is shown as 02 above a line of his markers.
+
+4. Your VIP indicates the player's turn by blinking that player's score and also blinking
+ a cursor dot in the 8x8 square. A player moves the blinking cursor dot in the 8x8
+ square by pressing the direction keys 1-4 and 6-9 as shown. (VIPG1-6.JPG)
+
+5. When the cursor-dot is properly located, the player presses key 5 to place his marker
+ on the square. You will find that your VIP will not allow you to make a non-valid
+ play. The only placements allowed are onces for which at least one of the other
+ player's markers is surrounded between an existing marker of your own and your new
+ marker being placed. All these markers must be in consecutive positions on the
+ square and can be in any horizontal, vertical or diagonal direction. Once a new
+ marker has been placed, your VIP will change all such surrounded markers of the
+ other player to your kind and change the scores.
+
+6. Sometimes it may not be possible for a player to make a valid move. If this happens
+ he must forfeit his move by pressing the "F" key! The game ends when neither player
+ can play or when the 8x8 square is completely filled with markers. The goal is to
+ end the game with the highest score. Do not be discouraged if during the game you
+ seem to be losing because this is a game with dramatic reversals! Develop a winning
+ strategem and become a champion!!
diff --git a/roms/games/Rocket Launch [Jonas Lindstedt].ch8 b/roms/games/Rocket Launch [Jonas Lindstedt].ch8
new file mode 100644
index 0000000..32bc252
--- /dev/null
+++ b/roms/games/Rocket Launch [Jonas Lindstedt].ch8
Binary files differ
diff --git a/roms/games/Rocket Launcher.ch8 b/roms/games/Rocket Launcher.ch8
new file mode 100644
index 0000000..d0825d7
--- /dev/null
+++ b/roms/games/Rocket Launcher.ch8
Binary files differ
diff --git a/roms/games/Rocket [Joseph Weisbecker, 1978].ch8 b/roms/games/Rocket [Joseph Weisbecker, 1978].ch8
new file mode 100644
index 0000000..c5db30e
--- /dev/null
+++ b/roms/games/Rocket [Joseph Weisbecker, 1978].ch8
Binary files differ
diff --git a/roms/games/Rush Hour [Hap, 2006] (alt).ch8 b/roms/games/Rush Hour [Hap, 2006] (alt).ch8
new file mode 100644
index 0000000..f2d4886
--- /dev/null
+++ b/roms/games/Rush Hour [Hap, 2006] (alt).ch8
Binary files differ
diff --git a/roms/games/Rush Hour [Hap, 2006].ch8 b/roms/games/Rush Hour [Hap, 2006].ch8
new file mode 100644
index 0000000..e4253e3
--- /dev/null
+++ b/roms/games/Rush Hour [Hap, 2006].ch8
Binary files differ
diff --git a/roms/games/Rush Hour [Hap, 2006].txt b/roms/games/Rush Hour [Hap, 2006].txt
new file mode 100644
index 0000000..9714e4a
--- /dev/null
+++ b/roms/games/Rush Hour [Hap, 2006].txt
@@ -0,0 +1,28 @@
+Rush Hour (v1.1) for CHIP-8 by hap 08-02-08, http://hap.samor.nl/
+Originally released on 17-12-06. Version 1.1 improves a few things.
+Based on a boardgame by Nobuyuki Yoshigahara "Nob" and ThinkFun,
+http://www.thinkfun.com/
+
+This game contains 170 puzzles. Most were taken from the original cardsets,
+some were made by me, and some were generated with Michel's PyTraffic,
+http://alpha.uhasselt.be/Research/Algebra/Members/pytraffic . Refer to
+the source code for detailed information on this.
+
+HOW TO PLAY
+===========
+
+The goal of the game is to slide the arrow block(s) out of the 6*6 grid.
+Completing 10 boards will be awarded with the inclusion of the next boardset(s)
+as seen from the connections on the boardset select screen, a password will be
+given so you don't have to complete the game in a single session.
+
+ HEX key PC key* Use
+---------------------------
+ 5 W up
+ 8 S down
+ 7 A left
+ 9 D right
+ A Z ok/hold to slide
+ 1 1 option(in-game)/back
+
+* = for interpreters that have the 4*4 keypad at 1234/QWER/ASDF/ZXCV.
diff --git a/roms/games/Russian Roulette [Carmelo Cortez, 1978].ch8 b/roms/games/Russian Roulette [Carmelo Cortez, 1978].ch8
new file mode 100644
index 0000000..bb90dca
--- /dev/null
+++ b/roms/games/Russian Roulette [Carmelo Cortez, 1978].ch8
Binary files differ
diff --git a/roms/games/Russian Roulette [Carmelo Cortez, 1978].txt b/roms/games/Russian Roulette [Carmelo Cortez, 1978].txt
new file mode 100644
index 0000000..ef5cc3d
--- /dev/null
+++ b/roms/games/Russian Roulette [Carmelo Cortez, 1978].txt
@@ -0,0 +1,4 @@
+Russian Roulette , by: Carmelo Cortez
+
+This game is called Russian RouLette. Press any key to Spin and pull the Trigger.
+A "Click" or "Bang" will show, get ten "clicks" in a row and you win. \ No newline at end of file
diff --git a/roms/games/Sequence Shoot [Joyce Weisbecker].ch8 b/roms/games/Sequence Shoot [Joyce Weisbecker].ch8
new file mode 100644
index 0000000..8715b80
--- /dev/null
+++ b/roms/games/Sequence Shoot [Joyce Weisbecker].ch8
Binary files differ
diff --git a/roms/games/Sequence Shoot [Joyce Weisbecker].txt b/roms/games/Sequence Shoot [Joyce Weisbecker].txt
new file mode 100644
index 0000000..d15d61d
--- /dev/null
+++ b/roms/games/Sequence Shoot [Joyce Weisbecker].txt
@@ -0,0 +1,25 @@
+12. VIP Sequence Shoot
+
+You score points by having the sharp-shooter hit the targets in the proper sequence.
+
+How to Play VIP Sequence Shoot
+
+1. Load the CHIP-8 interpreter at 0000-01FF and
+ the game starting at 0200.
+
+2. Turn RUN switch on.
+
+3. Pressing the Key C causes the little man to shoot the top target, Key D shoots the
+ one below it, Key E the next lower and Key F the bottom target.
+
+4. One of the four targets flashes and the computer waits for you to shoot it. When
+ you press teh correct key, you get one point. Then two flash, on after the other.
+ Shoot the one that flashed first, then shoot the other. This gives you two more
+ points. Three targets (when hit in the same order as they flashed) add three
+ points to your score.
+
+5. Each time you shoot such a series of targets in proper sequence, your score
+ increases by the number of targets you hit. An the next series you see is longer
+ by one target. The maximum length of sequence is 22 targets, that is a score of 254.
+
+6. Improper sequencing of shots in any series ends the game. \ No newline at end of file
diff --git a/roms/games/Shooting Stars [Philip Baltzer, 1978].ch8 b/roms/games/Shooting Stars [Philip Baltzer, 1978].ch8
new file mode 100644
index 0000000..9cc078f
--- /dev/null
+++ b/roms/games/Shooting Stars [Philip Baltzer, 1978].ch8
Binary files differ
diff --git a/roms/games/Shooting Stars [Philip Baltzer, 1978].txt b/roms/games/Shooting Stars [Philip Baltzer, 1978].txt
new file mode 100644
index 0000000..db2b329
--- /dev/null
+++ b/roms/games/Shooting Stars [Philip Baltzer, 1978].txt
@@ -0,0 +1,2 @@
+Shooting Stars, by: Philip Baltzer
+
diff --git a/roms/games/Slide [Joyce Weisbecker].ch8 b/roms/games/Slide [Joyce Weisbecker].ch8
new file mode 100644
index 0000000..7a487ed
--- /dev/null
+++ b/roms/games/Slide [Joyce Weisbecker].ch8
Binary files differ
diff --git a/roms/games/Slide [Joyce Weisbecker].txt b/roms/games/Slide [Joyce Weisbecker].txt
new file mode 100644
index 0000000..3e50b14
--- /dev/null
+++ b/roms/games/Slide [Joyce Weisbecker].txt
@@ -0,0 +1,24 @@
+5. VIP SLIDE
+
+Slide is a two-person game. Each player tries to slide a "puck" over the high-scoring
+"spots" without hitting the back wall.
+
+How To Play VIP Slide
+
+1. Load the CHIP-8 interpretor at 0000-01FF
+ and the game starting at 0200.
+
+2. Turn RUN switch on.
+
+3. The puck moves up and down randomly. Press "0" key to stop the puck. The puck
+ will move towards the spots after you release the key. The longer you hold the
+ key down, the further the puck travels (maximum time approximately 2.5 seconds).
+
+4. You get 2 points for hitting the first spot, 4 points for either of the next two
+ spots and 8 points for either of the last two. The highest score possible is 216
+ (two spots can be hit on one slide).
+
+5. If you hit the back wall, though, you get zero points for that slide, even though
+ you've hit a spot.
+
+6. Each player gets 3 pucks per turn and 6 turns in a game.
diff --git a/roms/games/Soccer.ch8 b/roms/games/Soccer.ch8
new file mode 100644
index 0000000..603ce9b
--- /dev/null
+++ b/roms/games/Soccer.ch8
Binary files differ
diff --git a/roms/games/Space Flight.ch8 b/roms/games/Space Flight.ch8
new file mode 100644
index 0000000..60bc934
--- /dev/null
+++ b/roms/games/Space Flight.ch8
Binary files differ
diff --git a/roms/games/Space Intercept [Joseph Weisbecker, 1978].ch8 b/roms/games/Space Intercept [Joseph Weisbecker, 1978].ch8
new file mode 100644
index 0000000..014fe6b
--- /dev/null
+++ b/roms/games/Space Intercept [Joseph Weisbecker, 1978].ch8
Binary files differ
diff --git a/roms/games/Space Intercept [Joseph Weisbecker, 1978].txt b/roms/games/Space Intercept [Joseph Weisbecker, 1978].txt
new file mode 100644
index 0000000..572d5e7
--- /dev/null
+++ b/roms/games/Space Intercept [Joseph Weisbecker, 1978].txt
@@ -0,0 +1,4 @@
+Space Intercept, by Joseph Weisbecker
+
+At startup, Press 1 to select the large UFO whichh counts 5 points when hit or 2 to select the small UFO which counts 15 points when hit.
+Launch your rocket by pressing key 4,5 or 6. You get 15 rockets as shown in the lower right corner of the screen. Your score is shown in the lower left corner of the screen.
diff --git a/roms/games/Space Invaders [David Winter] (alt).ch8 b/roms/games/Space Invaders [David Winter] (alt).ch8
new file mode 100644
index 0000000..f7db5f5
--- /dev/null
+++ b/roms/games/Space Invaders [David Winter] (alt).ch8
Binary files differ
diff --git a/roms/games/Space Invaders [David Winter] (alt).txt b/roms/games/Space Invaders [David Winter] (alt).txt
new file mode 100644
index 0000000..8ae1617
--- /dev/null
+++ b/roms/games/Space Invaders [David Winter] (alt).txt
@@ -0,0 +1,5 @@
+Space Invaders, by: David Winter
+
+The well known game. Destroy the invaders with your ship. Shoot
+with 5, move with 4 and 6. Press 5 to begin a game.
+
diff --git a/roms/games/Space Invaders [David Winter].ch8 b/roms/games/Space Invaders [David Winter].ch8
new file mode 100644
index 0000000..3ada8df
--- /dev/null
+++ b/roms/games/Space Invaders [David Winter].ch8
Binary files differ
diff --git a/roms/games/Space Invaders [David Winter].txt b/roms/games/Space Invaders [David Winter].txt
new file mode 100644
index 0000000..8ae1617
--- /dev/null
+++ b/roms/games/Space Invaders [David Winter].txt
@@ -0,0 +1,5 @@
+Space Invaders, by: David Winter
+
+The well known game. Destroy the invaders with your ship. Shoot
+with 5, move with 4 and 6. Press 5 to begin a game.
+
diff --git a/roms/games/Spooky Spot [Joseph Weisbecker, 1978].ch8 b/roms/games/Spooky Spot [Joseph Weisbecker, 1978].ch8
new file mode 100644
index 0000000..ab2dae8
--- /dev/null
+++ b/roms/games/Spooky Spot [Joseph Weisbecker, 1978].ch8
Binary files differ
diff --git a/roms/games/Spooky Spot [Joseph Weisbecker, 1978].txt b/roms/games/Spooky Spot [Joseph Weisbecker, 1978].txt
new file mode 100644
index 0000000..5669310
--- /dev/null
+++ b/roms/games/Spooky Spot [Joseph Weisbecker, 1978].txt
@@ -0,0 +1,4 @@
+Spooky Spot, by: Joseph Weisbecker
+
+Now you can let the computer make your big decisions or predict the future just like governmentt or industry leaders do.
+You will see the words YES and NO at the right of the screen. Ask the computer any question that can be answered with YES or NO. Press KEY 0 and the spooky spot will show you the computer's answer. This program replaces your old fashioned mechanical OUIJA board.
diff --git a/roms/games/Squash [David Winter].ch8 b/roms/games/Squash [David Winter].ch8
new file mode 100644
index 0000000..8ab9cfa
--- /dev/null
+++ b/roms/games/Squash [David Winter].ch8
Binary files differ
diff --git a/roms/games/Submarine [Carmelo Cortez, 1978].ch8 b/roms/games/Submarine [Carmelo Cortez, 1978].ch8
new file mode 100644
index 0000000..224b108
--- /dev/null
+++ b/roms/games/Submarine [Carmelo Cortez, 1978].ch8
Binary files differ
diff --git a/roms/games/Submarine [Carmelo Cortez, 1978].txt b/roms/games/Submarine [Carmelo Cortez, 1978].txt
new file mode 100644
index 0000000..b17f56f
--- /dev/null
+++ b/roms/games/Submarine [Carmelo Cortez, 1978].txt
@@ -0,0 +1,4 @@
+Submarine, by: Carmelo Cortez
+
+The Sub Game is my favorlte. Press "5" key to fire depth charges at the subs below.
+You score 15 points for a small sub and 5 points for the larger. You get 25 depth charges to start. \ No newline at end of file
diff --git a/roms/games/Sum Fun [Joyce Weisbecker].ch8 b/roms/games/Sum Fun [Joyce Weisbecker].ch8
new file mode 100644
index 0000000..3c88450
--- /dev/null
+++ b/roms/games/Sum Fun [Joyce Weisbecker].ch8
Binary files differ
diff --git a/roms/games/Sum Fun [Joyce Weisbecker].txt b/roms/games/Sum Fun [Joyce Weisbecker].txt
new file mode 100644
index 0000000..f57d352
--- /dev/null
+++ b/roms/games/Sum Fun [Joyce Weisbecker].txt
@@ -0,0 +1,27 @@
+11. VIP Sum Fun
+
+The object of this game is to add up the three digits
+which appear in the middle of the screen and then hit
+the key representing the total as fast as you can.
+
+How to Play VIP Sum FUn
+
+1. Load the CHIP-8 interpreter at 0000-01FF and
+ the game starting at 0200.
+
+2. Turn RUN switch on.
+
+3. You get twenty sets of three digits per game and
+ between zero and ten points per set. The faster you
+ enter the correct total, the more points you win.
+
+4. If you wait more that 3 seconds, you get zero points.
+ The correct sum is shown above the three digits after
+ you enter it, and there is a pause before the next
+ set appears.
+
+5. The score is shown in the upper right-hand corner of
+ the screen. The maximum number of points you can score
+ is 200. Between 120 and 159 points is above average.
+ A score of 160 or higher is outstanding.
+
diff --git a/roms/games/Syzygy [Roy Trevino, 1990].ch8 b/roms/games/Syzygy [Roy Trevino, 1990].ch8
new file mode 100644
index 0000000..b0653ef
--- /dev/null
+++ b/roms/games/Syzygy [Roy Trevino, 1990].ch8
Binary files differ
diff --git a/roms/games/Syzygy [Roy Trevino, 1990].txt b/roms/games/Syzygy [Roy Trevino, 1990].txt
new file mode 100644
index 0000000..4e03eee
--- /dev/null
+++ b/roms/games/Syzygy [Roy Trevino, 1990].txt
@@ -0,0 +1,62 @@
+SYZYGY v0.1
+
+One of the first games I remember playing on a computer was
+called "syzygy" on a now ancient TRS-80 Model 1. It has since
+appeared on other computers under various names. Why it was
+called syzygy, I have no idea (consult Websters). However, since
+the HP48SX has approximately the same memory, graphics and cpu
+power as my TRS-80 did (something like 16kB, 128x64, and a 1.2Mhz Z80),
+I thought it would be amusing to play it again. Now, approximately
+to my recollection, and with many apologies to the original author,
+here is a CHIP48 version of SYZYGY. Enough drivel.
+
+The object of the game is to seek out "targets". You do this with
+your syzygy. Initially small, the syzygy will grow by some amount
+each time a target is hit. Eventually, your syzygy will
+be so long as to make tougher and tougher to get any points (and easier
+and easier to get killed). Confused? Just try it.
+
+Anyways, the syzygy is not allowed to run into anything except targets.
+It cannot run into the screen border (if present), or itself (this
+includes backing into itself). Fast and immediate death will result.
+Don't worry if you die quickly a few times. The keys take a few
+minutes to get used to.
+
+To start: + start/restart game with border
+ - start/restart borderless game
+
+To play: 9 up
+ 6 down
+ 1 left
+ 2 right
+
+[Hint for frustrated beginners: hold left hand on 1 & 2, and right hand on
+ 6 & 9 keys. Alternate between left hand, right hand, left hand... -jkh-]
+
+
+Fine print (borrowed from Andreas Gustafsson, author of CHIP-48):
+
+ SYZYGY is (c) copyright 1990 by Roy Trevino (RTT)
+
+ Noncommercial distribution allowed, provided that this
+ copyright message is preserved, and any modified versions
+ are clearly marked as such.
+
+ SYZYGY, via CHIP-48, makes use of undocumented low-level features
+ of the HP48SX calculator, and may or may not cause loss of data,
+ excessive battery drainage, and/or damage to the calcultor
+ hardware. The Author takes no responsibility whatsoever for
+ any damage caused by the use of this program.
+
+ THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+ IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ PURPOSE.
+
+Roy
+
+ --------------------------------------------------------------
+ Roy Trevino Intel Corp.
+ E-mail: rtrevino@sedona.intel.com Tel: (602) 554 2816
+ UUCP: decwrl!apple!oliveb!orc!inews!rtrevino@sedona.intel.com
+ \ No newline at end of file
diff --git a/roms/games/Tank.ch8 b/roms/games/Tank.ch8
new file mode 100644
index 0000000..ca4bbab
--- /dev/null
+++ b/roms/games/Tank.ch8
Binary files differ
diff --git a/roms/games/Tank.txt b/roms/games/Tank.txt
new file mode 100644
index 0000000..2fb4540
--- /dev/null
+++ b/roms/games/Tank.txt
@@ -0,0 +1 @@
+You are in a tank which has 25 bombs. Your goal is to hit 25 times a mobile target. The game ends when all your bombs are shot. If your tank hits the target, you lose 5 bombs. Use 2 4 6 and 8 to move. This game uses the original CHIP8 keyboard, so directions 2 and 8 are swapped.
diff --git a/roms/games/Tapeworm [JDR, 1999].ch8 b/roms/games/Tapeworm [JDR, 1999].ch8
new file mode 100644
index 0000000..de279d9
--- /dev/null
+++ b/roms/games/Tapeworm [JDR, 1999].ch8
Binary files differ
diff --git a/roms/games/Tetris [Fran Dachille, 1991].ch8 b/roms/games/Tetris [Fran Dachille, 1991].ch8
new file mode 100644
index 0000000..9f5e087
--- /dev/null
+++ b/roms/games/Tetris [Fran Dachille, 1991].ch8
Binary files differ
diff --git a/roms/games/Tetris [Fran Dachille, 1991].txt b/roms/games/Tetris [Fran Dachille, 1991].txt
new file mode 100644
index 0000000..748a241
--- /dev/null
+++ b/roms/games/Tetris [Fran Dachille, 1991].txt
@@ -0,0 +1,31 @@
+ TETRIS
+ by Fran Dachille
+
+This is my first release of the famous Tetris game on the HP48S. I was
+inspired by the lack enjoyable games for our favorite handheld. [Not since the
+Goodies Disks have been available! -jkh-] This game, though it lacks some of
+the whistles and bangs of fancy versions, performs on par with quality arcade
+versions (nota bene -> SPEED). At my college, every person who picks up my
+calculator is immediately hooked for hours.
+
+This version is written for the CHIP48 game interpreter (c)
+copyright 1990 Andreas Gustafsson.
+
+The 4 key is left rotate, 5 - left move, 6 - right move, 1
+- drop, ENTER - restart, DROP - end. After every 5 lines, the speed
+increases slightly and peaks at 45 lines.
+
+There is room for improvement in this version. Notably, background
+pictures, a pause key (for now, hold ON), two rotate keys, various
+starting skill levels, a B version which starts with randomn blocks,
+finishing graphics, and high scores, just to name a few.
+
+In order for improvements, I need to know if there is reasonable
+demand. If this game is worth playing for hours upon hours, please let
+me know. If you wish to support the improvements, want future versions,
+and want to see other games ported to the HP48S, send $5.00 to:
+
+ FRAN DACHILLE
+ WEBB INSTITUTE
+ GLEN COVE, NY 11542
+
diff --git a/roms/games/Tic-Tac-Toe [David Winter].ch8 b/roms/games/Tic-Tac-Toe [David Winter].ch8
new file mode 100644
index 0000000..4d4bc99
--- /dev/null
+++ b/roms/games/Tic-Tac-Toe [David Winter].ch8
Binary files differ
diff --git a/roms/games/Timebomb.ch8 b/roms/games/Timebomb.ch8
new file mode 100644
index 0000000..76828c8
--- /dev/null
+++ b/roms/games/Timebomb.ch8
Binary files differ
diff --git a/roms/games/Tron.ch8 b/roms/games/Tron.ch8
new file mode 100644
index 0000000..74f7f51
--- /dev/null
+++ b/roms/games/Tron.ch8
Binary files differ
diff --git a/roms/games/UFO [Lutz V, 1992].ch8 b/roms/games/UFO [Lutz V, 1992].ch8
new file mode 100644
index 0000000..7fa5a15
--- /dev/null
+++ b/roms/games/UFO [Lutz V, 1992].ch8
Binary files differ
diff --git a/roms/games/UFO [Lutz V, 1992].txt b/roms/games/UFO [Lutz V, 1992].txt
new file mode 100644
index 0000000..2781395
--- /dev/null
+++ b/roms/games/UFO [Lutz V, 1992].txt
@@ -0,0 +1,24 @@
+Here's how to play UFO:
+
+You have a stationary missle launcher at the bottom of the screen. You
+can shoot in three directions; left diagonal, straight up, and right
+diagonal.. using the keys 4, 5, and 6 respectively.. You try to hit
+one of two objects flying by.. at apparently varying speeds.. Your
+score is displayed on your left, the number of missles you have left
+is displayed on your right. (You get 15)..
+
+This game ("UFO") is not new. I have a copy of it from 1977 (!). It
+was one of the original CHIP-8 games on the audio cassette that was
+included when I bought my first computer, the Finnish-made Telmac
+1800.
+
+It was also the first real program to run under CHIP-48 (it was used
+as a test case during the development of the CHIP-48 interpreter). The
+reason I have not posted it to the net myself is that I have no idea
+about its copyright status. I don't even know where it originated
+(RCA, perhaps?).
+
+The cassette that was bundled with the Telmac 1800 contains more than
+a dozen CHIP-8 programs. If someone could convince me that these
+programs are indeed freely redistributable, the other programs could
+also be posted. Otherwise, perhaps this one shouldn't have been.
diff --git a/roms/games/Vers [JMN, 1991].ch8 b/roms/games/Vers [JMN, 1991].ch8
new file mode 100644
index 0000000..b0fe240
--- /dev/null
+++ b/roms/games/Vers [JMN, 1991].ch8
Binary files differ
diff --git a/roms/games/Vertical Brix [Paul Robson, 1996].ch8 b/roms/games/Vertical Brix [Paul Robson, 1996].ch8
new file mode 100644
index 0000000..07f4006
--- /dev/null
+++ b/roms/games/Vertical Brix [Paul Robson, 1996].ch8
Binary files differ
diff --git a/roms/games/Wall [David Winter].ch8 b/roms/games/Wall [David Winter].ch8
new file mode 100644
index 0000000..efd029f
--- /dev/null
+++ b/roms/games/Wall [David Winter].ch8
Binary files differ
diff --git a/roms/games/Wipe Off [Joseph Weisbecker].ch8 b/roms/games/Wipe Off [Joseph Weisbecker].ch8
new file mode 100644
index 0000000..2d5e513
--- /dev/null
+++ b/roms/games/Wipe Off [Joseph Weisbecker].ch8
Binary files differ
diff --git a/roms/games/Worm V4 [RB-Revival Studios, 2007].ch8 b/roms/games/Worm V4 [RB-Revival Studios, 2007].ch8
new file mode 100644
index 0000000..03bc7b8
--- /dev/null
+++ b/roms/games/Worm V4 [RB-Revival Studios, 2007].ch8
Binary files differ
diff --git a/roms/games/Worm V4 [RB-Revival Studios, 2007].txt b/roms/games/Worm V4 [RB-Revival Studios, 2007].txt
new file mode 100644
index 0000000..edbeda0
--- /dev/null
+++ b/roms/games/Worm V4 [RB-Revival Studios, 2007].txt
@@ -0,0 +1,52 @@
+-----------------------------------------------------------------------------
+ /////////////////
+ //////////////////
+ //// ////
+ //// ///////////
+ //// ///////////
+ //// ////
+ //// ///////////
+ //// //////////
+
+ www.revival-studios.com
+-----------------------------------------------------------------------------
+Title : SuperWorm V4
+Author : RB (Original game)
+ Updates and fixes by: Martijn Wenting / Revival Studios
+Genre : Game
+System : Chip-8 / SuperChip8
+Date : 10/08/2007
+Product ID : RS-C8001
+-----------------------------------------------------------------------------
+
+All the contents of this package are (c)Copyright 2007 Revival Studios.
+Original game: SuperWorm is (c)Copyright 1992 RB
+
+The contents of the package may only be spread in its original form, and may not be
+published or distributed otherwise without the written permission of the authors.
+
+Description:
+------------
+SuperWorm V4 is an update of the SuperChip8 game: Worm3 by RB.
+The original game was only for SuperChip, so i've created a Chip-8 port.
+It also includes several speed fixes and a new control system.
+
+Running the game:
+-----------------
+Use the Megachip emulator or any other Chip-8/SuperChip compatible emulator to run the game.
+
+Credits:
+--------
+Chip-8 version, Updates and fixes by: Martijn Wenting
+Original game by: RB
+
+Distribution:
+-------------
+This package can be freely distributed in its original form.
+If you would like to include this game in your rom package, please let me know.
+
+Watch out for more releases soon!
+
+
+ Martijn Wenting / Revival Studios
+
diff --git a/roms/games/X-Mirror.ch8 b/roms/games/X-Mirror.ch8
new file mode 100644
index 0000000..3525307
--- /dev/null
+++ b/roms/games/X-Mirror.ch8
Binary files differ
diff --git a/roms/games/ZeroPong [zeroZshadow, 2007].ch8 b/roms/games/ZeroPong [zeroZshadow, 2007].ch8
new file mode 100644
index 0000000..3715699
--- /dev/null
+++ b/roms/games/ZeroPong [zeroZshadow, 2007].ch8
Binary files differ
diff --git a/roms/programs/BMP Viewer - Hello (C8 example) [Hap, 2005].ch8 b/roms/programs/BMP Viewer - Hello (C8 example) [Hap, 2005].ch8
new file mode 100644
index 0000000..a6355a9
--- /dev/null
+++ b/roms/programs/BMP Viewer - Hello (C8 example) [Hap, 2005].ch8
Binary files differ
diff --git a/roms/programs/BMP Viewer - Hello (C8 example) [Hap, 2005].txt b/roms/programs/BMP Viewer - Hello (C8 example) [Hap, 2005].txt
new file mode 100644
index 0000000..885f511
--- /dev/null
+++ b/roms/programs/BMP Viewer - Hello (C8 example) [Hap, 2005].txt
@@ -0,0 +1,3 @@
+BMP Viewer, 02-06-05, by hap
+works with monochrome BMPs only, of course. put the BMP data (headerless) at
+offset $30. change offset $0 (200) $00ff to $1202 for Chip-8. \ No newline at end of file
diff --git a/roms/programs/Chip8 Picture.ch8 b/roms/programs/Chip8 Picture.ch8
new file mode 100644
index 0000000..74ab4bf
--- /dev/null
+++ b/roms/programs/Chip8 Picture.ch8
Binary files differ
diff --git a/roms/programs/Chip8 emulator Logo [Garstyciuks].ch8 b/roms/programs/Chip8 emulator Logo [Garstyciuks].ch8
new file mode 100644
index 0000000..c0e5923
--- /dev/null
+++ b/roms/programs/Chip8 emulator Logo [Garstyciuks].ch8
Binary files differ
diff --git a/roms/programs/Clock Program [Bill Fisher, 1981].ch8 b/roms/programs/Clock Program [Bill Fisher, 1981].ch8
new file mode 100644
index 0000000..ec137bd
--- /dev/null
+++ b/roms/programs/Clock Program [Bill Fisher, 1981].ch8
Binary files differ
diff --git a/roms/programs/Clock Program [Bill Fisher, 1981].txt b/roms/programs/Clock Program [Bill Fisher, 1981].txt
new file mode 100644
index 0000000..b830f2b
--- /dev/null
+++ b/roms/programs/Clock Program [Bill Fisher, 1981].txt
@@ -0,0 +1,8 @@
+This neat little clock program is the perfect program to run when someone asks:
+"That's nice, but what can your computer DO?"
+The program features "reverse" video numerals on the screen, which is a nice change from the
+usual white numbers on a black background.
+
+Instructions:
+- Type six digits on the hex keypad for the desired clock starting time, using 23 hour format (ex.173055)
+- Hit any hex key to start clock running at the above time setting.
diff --git a/roms/programs/Delay Timer Test [Matthew Mikolay, 2010].ch8 b/roms/programs/Delay Timer Test [Matthew Mikolay, 2010].ch8
new file mode 100644
index 0000000..aa9ae28
--- /dev/null
+++ b/roms/programs/Delay Timer Test [Matthew Mikolay, 2010].ch8
Binary files differ
diff --git a/roms/programs/Delay Timer Test [Matthew Mikolay, 2010].txt b/roms/programs/Delay Timer Test [Matthew Mikolay, 2010].txt
new file mode 100644
index 0000000..80f2c09
--- /dev/null
+++ b/roms/programs/Delay Timer Test [Matthew Mikolay, 2010].txt
@@ -0,0 +1,9 @@
+Hey guys!
+
+Here's another little program I wrote to test out a feature in my game. This
+program allows the user to change the value of the V3 register using the 2 and 8
+keys. When the 5 key is pressed, the delay timer starts counting down from the
+value the user placed into the V3 register, and the screen is updated as the
+value changes.
+
+-Matt \ No newline at end of file
diff --git a/roms/programs/Division Test [Sergey Naydenov, 2010].ch8 b/roms/programs/Division Test [Sergey Naydenov, 2010].ch8
new file mode 100644
index 0000000..85fa850
--- /dev/null
+++ b/roms/programs/Division Test [Sergey Naydenov, 2010].ch8
Binary files differ
diff --git a/roms/programs/Fishie [Hap, 2005].ch8 b/roms/programs/Fishie [Hap, 2005].ch8
new file mode 100644
index 0000000..ca1eaf3
--- /dev/null
+++ b/roms/programs/Fishie [Hap, 2005].ch8
Binary files differ
diff --git a/roms/programs/Fishie [Hap, 2005].txt b/roms/programs/Fishie [Hap, 2005].txt
new file mode 100644
index 0000000..6985858
--- /dev/null
+++ b/roms/programs/Fishie [Hap, 2005].txt
@@ -0,0 +1,2 @@
+Fishie, used as internal rom for fish n chips
+by hap, 10-07-05
diff --git a/roms/programs/Framed MK1 [GV Samways, 1980].ch8 b/roms/programs/Framed MK1 [GV Samways, 1980].ch8
new file mode 100644
index 0000000..6b9e47d
--- /dev/null
+++ b/roms/programs/Framed MK1 [GV Samways, 1980].ch8
Binary files differ
diff --git a/roms/programs/Framed MK1 [GV Samways, 1980].txt b/roms/programs/Framed MK1 [GV Samways, 1980].txt
new file mode 100644
index 0000000..d20da96
--- /dev/null
+++ b/roms/programs/Framed MK1 [GV Samways, 1980].txt
@@ -0,0 +1,4 @@
+Framed MK1, By: G.V. Samways, 1980
+
+This program displays a random movement of dots. You will notice a repetition in the pattern
+after a time.
diff --git a/roms/programs/Framed MK2 [GV Samways, 1980].ch8 b/roms/programs/Framed MK2 [GV Samways, 1980].ch8
new file mode 100644
index 0000000..c7d093d
--- /dev/null
+++ b/roms/programs/Framed MK2 [GV Samways, 1980].ch8
Binary files differ
diff --git a/roms/programs/Framed MK2 [GV Samways, 1980].txt b/roms/programs/Framed MK2 [GV Samways, 1980].txt
new file mode 100644
index 0000000..e0a14dc
--- /dev/null
+++ b/roms/programs/Framed MK2 [GV Samways, 1980].txt
@@ -0,0 +1,4 @@
+Framed MK2, By: G.V. Samways, 1980
+
+This program displays a random movement of lines. You will notice a repetition in the pattern
+after a time.
diff --git a/roms/programs/IBM Logo.ch8 b/roms/programs/IBM Logo.ch8
new file mode 100644
index 0000000..113338e
--- /dev/null
+++ b/roms/programs/IBM Logo.ch8
Binary files differ
diff --git a/roms/programs/Jumping X and O [Harry Kleinberg, 1977].ch8 b/roms/programs/Jumping X and O [Harry Kleinberg, 1977].ch8
new file mode 100644
index 0000000..d028e54
--- /dev/null
+++ b/roms/programs/Jumping X and O [Harry Kleinberg, 1977].ch8
Binary files differ
diff --git a/roms/programs/Jumping X and O [Harry Kleinberg, 1977].txt b/roms/programs/Jumping X and O [Harry Kleinberg, 1977].txt
new file mode 100644
index 0000000..4d2bf50
--- /dev/null
+++ b/roms/programs/Jumping X and O [Harry Kleinberg, 1977].txt
@@ -0,0 +1,3 @@
+Jumping X and O, by: Harry Kleinberg
+
+Here is what the program is written to do. First, a solid 6×6spot block appears in the upper right quadrant of the tv display. A 5×5 "X" pattern appears in the center and jumps randomly to a new location every 1/5 second. When the X overlaps the 6×6 block, the X disappears, an "0" pattern appears in the center of the screen, and repeats the process, being replaced by the X when an overlap with the block occurs. The program continues until the machine IS stopped \ No newline at end of file
diff --git a/roms/programs/Keypad Test [Hap, 2006].ch8 b/roms/programs/Keypad Test [Hap, 2006].ch8
new file mode 100644
index 0000000..c60558e
--- /dev/null
+++ b/roms/programs/Keypad Test [Hap, 2006].ch8
Binary files differ
diff --git a/roms/programs/Keypad Test [Hap, 2006].txt b/roms/programs/Keypad Test [Hap, 2006].txt
new file mode 100644
index 0000000..64f19af
--- /dev/null
+++ b/roms/programs/Keypad Test [Hap, 2006].txt
@@ -0,0 +1,12 @@
+Keypad Test, by hap, 15-02-06
+
+press a chip8 key and the pressed char will light up
+if you want to do something funny, soft-reset the chip8/emulator over and over,
+and the sprite layout will become messed up ;p
+
+chip8 keypad:
+1 2 3 c
+4 5 6 d
+7 8 9 e
+a 0 b f
+
diff --git a/roms/programs/Life [GV Samways, 1980].ch8 b/roms/programs/Life [GV Samways, 1980].ch8
new file mode 100644
index 0000000..d35039a
--- /dev/null
+++ b/roms/programs/Life [GV Samways, 1980].ch8
Binary files differ
diff --git a/roms/programs/Life [GV Samways, 1980].txt b/roms/programs/Life [GV Samways, 1980].txt
new file mode 100644
index 0000000..8f40ce1
--- /dev/null
+++ b/roms/programs/Life [GV Samways, 1980].txt
@@ -0,0 +1,11 @@
+Life, by: G.V. Samways
+
+This is a display of cell growth, in accordance with the following rules:
+ 1. A cell is born if 3 cells are adjecent to an empty space.
+ 2. A cell lives if 2 or 3 cells are adjacent, and dies otherwise.
+ 3. All events take place simultaneously.
+
+To start the game, you make a pattern by entering the cell coordinates, first
+the "Y"from 0-7 downwards, then the "X" from 0-F across.
+F initialises the program, and the number of scans is entered plus one, so that 1 gives 0 scans
+to F giving 14, and 0 giving 255. The sit back and watch the colony live, or die.
diff --git a/roms/programs/Minimal game [Revival Studios, 2007].ch8 b/roms/programs/Minimal game [Revival Studios, 2007].ch8
new file mode 100644
index 0000000..b759e91
--- /dev/null
+++ b/roms/programs/Minimal game [Revival Studios, 2007].ch8
Binary files differ
diff --git a/roms/programs/Random Number Test [Matthew Mikolay, 2010].ch8 b/roms/programs/Random Number Test [Matthew Mikolay, 2010].ch8
new file mode 100644
index 0000000..c9f79e4
--- /dev/null
+++ b/roms/programs/Random Number Test [Matthew Mikolay, 2010].ch8
Binary files differ
diff --git a/roms/programs/Random Number Test [Matthew Mikolay, 2010].txt b/roms/programs/Random Number Test [Matthew Mikolay, 2010].txt
new file mode 100644
index 0000000..7a18661
--- /dev/null
+++ b/roms/programs/Random Number Test [Matthew Mikolay, 2010].txt
@@ -0,0 +1,17 @@
+Hey guys!
+
+I don't know if any of you will be interested in this, but I wrote this small
+program while coding my game to test out the random number generator. I wanted
+to see if there is a chance that zero will show up as the random number, and it
+turns out it can.
+
+Anyway, when you run the program, it brings a random number up on the screen.
+When you press any of the keys, it brings another random number up on the
+screen. This goes on until you quit the program.
+
+Address 0x202 holds the C0FF instruction, which commands the CHIP-8 interpreter
+to set V0 to a random number with the mask 0xFF. This yields 256 different
+possible numbers (0-255). If C0FF is changed to something like C00A, then the
+mask will change. This would yield 11 different possible numbers (0-10).
+
+-Matt \ No newline at end of file
diff --git a/roms/programs/SQRT Test [Sergey Naydenov, 2010].ch8 b/roms/programs/SQRT Test [Sergey Naydenov, 2010].ch8
new file mode 100644
index 0000000..5648551
--- /dev/null
+++ b/roms/programs/SQRT Test [Sergey Naydenov, 2010].ch8
Binary files differ