{"id":13829787,"url":"https://github.com/io12/BootMine","last_synced_at":"2025-07-09T10:31:43.178Z","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":165,"open_issues_count":0,"forks_count":10,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-05T10:09:21.031Z","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":"2024-07-18T06:04:24.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,"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","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225533022,"owners_count":17484180,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-08-04T10:00:45.624Z","updated_at":"2024-11-20T10:31:15.194Z","avatar_url":"https://github.com/io12.png","language":"Assembly","funding_links":[],"categories":["Assembly"],"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"}