README.md

mini x86

A x86 documentation, disassembler and emulator (in pure JS) optimized for running (MS-DOS) .COM files.

---

Documentation:

• TL;DR: https://github.com/xem/minix86/blob/gh-pages/TLDR.md (wip)

• Instructions table: https://github.com/xem/minix86/blob/gh-pages/instructions.md (wip)

• Intel documentation converted in HTML:

  • vol 1: http://xem.github.io/minix86/manual/intel-x86-and-64-manual-vol1/o_7281d5ea06a5b67a.html
  • vol 2: http://xem.github.io/minix86/manual/intel-x86-and-64-manual-vol2/o_b5573232dd8f1481.html
  • vol 3: http://xem.github.io/minix86/manual/intel-x86-and-64-manual-vol3/o_fe12b1e2a880e0ce.html

---

Apps:

• disassembler (WIP): http://xem.github.io/minix86/src/disassembler.html
• emulator: coming soon! (emulator.html)

Bonus:

• Tiny tool to convert a file into an array of bytes: http://xem.github.io/minix86/src/bytes.html

---

Demos included:

Tutos from http://www.sizecoding.org:

• hello world
• xor pattern
• xor pattern animated (supports Esc key)
• tunnel (with FPU instructions)

sub-256b demos from Pouët:

• 32b FIRE EFFECT by ribbon: http://www.pouet.net/prod.php?which=13729
• 32b FIRE EFFECT v2 by ribbon: http://www.pouet.net/prod.php?which=29411
• DRAGON FADE by HellMood: http://www.pouet.net/prod.php?which=63522
• M8TRIX by HellMood: http://www.pouet.net/prod.php?which=63126
• POINT16B by Desire: http://www.pouet.net/prod.php?which=63826
• FIREWAVE byDesire: http://www.pouet.net/prod.php?which=67949
• DIROJED by Řrřola: http://www.pouet.net/prod.php?which=28913
• FR01 by farbrausch: http://www.pouet.net/prod.php?which=8697

256b demos from pouet:

• FUTURA by red sector inc: http://www.pouet.net/prod.php?which=66806
• MEGAPOLE by red sector inc: http://www.pouet.net/prod.php?which=66372
• TUBE by 3SC: http://www.pouet.net/prod.php?which=3397
• 4IS256 by Řrřola: http://www.pouet.net/prod.php?which=29286
• ATRAKTOR by Řrřola: http://www.pouet.net/prod.php?which=68148
• PULS by Řrřola: http://www.pouet.net/prod.php?which=53816
• SYMETRIE by Řrřola: http://www.pouet.net/prod.php?which=32589
• QUATRO by Desire and sensenstahl: http://www.pouet.net/prod.php?which=68020

4kb:

• Motion sickness by Yobi/wAMMA: http://www.pouet.net/prod.php?which=6404

---

Assets

• VGA palette: http://xem.github.io/minix86/src/vga-palette.png

• CP437 charset: http://xem.github.io/minix86/src/cp437.png

• Logo: http://xem.github.io/minix86/logo.png

---

News

• 31/12: unofficial HN thread: https://news.ycombinator.com/item?id=13291052 (4.3k visits, 28 forks and 200 stars in 3 days!)