BootMine
Bootable minesweeper game in a 512-byte boot sector
Install / Use
/learn @io12/BootMineREADME
BootMine
Ever wanted to play minesweeper but didn't have an OS to run it in? No? Really no??
BootMine is an entire minesweeper game crammed into 512 bytes, the size of a BIOS boot sector. It can boot on any PC that supports BIOS booting, without running inside an OS. In a sense, BootMine is its own OS that can do nothing but run minesweeper.

Controls
| Key | Action | |-----------------------------------------------------|-----------------------------------------------------------------| | <kbd>Space</kbd> | 🔲 Clear cell | | <kbd>↑</kbd> <kbd>↓</kbd> <kbd>←</kbd> <kbd>→</kbd> | 🕹 Move cursor | | <kbd>Enter</kbd> | 🚩 Place flag | | <kbd>R</kbd> | 💣 Restart game (only works on GAME WIN and GAME OVER screens) |
Building
Make sure nasm and make are installed, then run:
make
Alternatively, prebuilt versions can be downloaded from the releases page.
Installing
The 512-byte file bootmine.img can be written to the first sector of a floppy disk (or USB drive), with a command like dd if=bootmine.img of=/dev/sdb. Keep in mind that this will effectively destroy all data on the drive.
Emulation
Makefile targets are provided for emulating in QEMU and Bochs.
make qemu
make bochs
NOTE: The way Bochs implements the rdtsc instruction appears to be bad as a source of entropy, so the bomb locations are predictable.
DOS
BootMine has DOS support too! Running make also produces bootmine.com that can be run in DOS. There are Makefile targets for easily running in DOSBox and DOSEMU.
make dosbox
make dosemu
Links
Credits
- nanochess, for his excellent collection of boot sector games
- Curt Johnson and Robert Donner, for Microsoft Minesweeper, popularizing the game
Related Skills
node-connect
340.5kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
84.2kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
340.5kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
commit-push-pr
84.2kCommit, push, and open a PR
