{"id":28318249,"url":"https://github.com/io12/bootmine","last_synced_at":"2026-03-06T09:02:25.899Z","repository":{"id":45101782,"uuid":"267526935","full_name":"io12/BootMine","owner":"io12","description":"Bootable minesweeper game in a 512-byte boot sector","archived":false,"fork":false,"pushed_at":"2021-01-21T04:53:31.000Z","size":238,"stargazers_count":177,"open_issues_count":0,"forks_count":10,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-20T04:56:35.794Z","etag":null,"topics":["16-bit","assembly","bios","boot-sector","bootloader","dos","game","golf","mbr","mines","minesweeper","x86"],"latest_commit_sha":null,"homepage":"","language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/io12.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-28T07:48:43.000Z","updated_at":"2025-07-17T13:02:45.000Z","dependencies_parsed_at":"2022-07-13T15:30:38.486Z","dependency_job_id":null,"html_url":"https://github.com/io12/BootMine","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/io12/BootMine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/io12%2FBootMine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/io12%2FBootMine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/io12%2FBootMine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/io12%2FBootMine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/io12","download_url":"https://codeload.github.com/io12/BootMine/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/io12%2FBootMine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30168608,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T07:56:45.623Z","status":"ssl_error","status_checked_at":"2026-03-06T07:55:55.621Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["16-bit","assembly","bios","boot-sector","bootloader","dos","game","golf","mbr","mines","minesweeper","x86"],"created_at":"2025-05-25T07:12:18.006Z","updated_at":"2026-03-06T09:02:25.832Z","avatar_url":"https://github.com/io12.png","language":"Assembly","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BootMine\n\n*Ever wanted to play minesweeper but didn't have an OS to run it in? No? Really no??*\n\nBootMine 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.\n\n![demo](demo.gif)\n\n## Controls\n\n| Key                                                 | Action                                                          |\n|-----------------------------------------------------|-----------------------------------------------------------------|\n| \u003ckbd\u003eSpace\u003c/kbd\u003e                                    | 🔲 Clear cell                                                  |\n| \u003ckbd\u003e↑\u003c/kbd\u003e \u003ckbd\u003e↓\u003c/kbd\u003e \u003ckbd\u003e←\u003c/kbd\u003e \u003ckbd\u003e→\u003c/kbd\u003e | 🕹 Move cursor                                                 |\n| \u003ckbd\u003eEnter\u003c/kbd\u003e                                    | 🚩 Place flag                                                  |\n| \u003ckbd\u003eR\u003c/kbd\u003e                                        | 💣 Restart game (only works on GAME WIN and GAME OVER screens) |\n\n## Building\n\nMake sure `nasm` and `make` are installed, then run:\n\n```sh\nmake\n```\n\nAlternatively, prebuilt versions can be downloaded from the\n[releases page](https://github.com/io12/BootMine/releases).\n\n## Installing\n\nThe 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.\n\n### Emulation\n\nMakefile targets are provided for emulating in QEMU and Bochs.\n\n```sh\nmake qemu\n```\n\n```sh\nmake bochs\n```\n\n**NOTE**: The way Bochs implements the `rdtsc` instruction appears to be bad as a source of entropy, so the bomb locations are predictable.\n\n## DOS\n\nBootMine 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.\n\n```sh\nmake dosbox\n```\n\n```sh\nmake dosemu\n```\n\n## Links\n\n* [Hacker News discussion](https://news.ycombinator.com/item?id=23360133)\n\n## Credits\n\n* [nanochess](https://github.com/nanochess), for his excellent collection of boot sector games\n* Curt Johnson and Robert Donner, for [*Microsoft Minesweeper*](https://en.wikipedia.org/wiki/Microsoft_Minesweeper), popularizing the game\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fio12%2Fbootmine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fio12%2Fbootmine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fio12%2Fbootmine/lists"}