bitmax/docs

BORING SOFTWARE

The Collector's Edition — Special Features

Five boring apps. Five hidden games. One operating system to hold them. This folder is the bonus disc: the dev commentary track and the world bible, bound together.

---

"Every boring app is a secret incremental game. Find the one already hiding in the chrome, and pull it out." — the founding line, MANIFESTO.md

---

What you hold in your hands

BORING SOFTWARE is an anthology of incremental games disguised as dead-serious utility software, circa 1998–99. You play them inside ENTROPY OS, a Windows-98-flavored desktop. Each volume reinvents not just the theme but the genre of interaction — a defragmenter you steer, a spreadsheet you compound, a terminal you escalate, an inbox you survive, a torrent client you seed.

This Collector's Edition is the material that ships in the limited box: two companion tomes.

• THE DEV HANDBOOK — the engineering commentary track. How the whole thing is built, system by system, true to the source, including the candid post-mortems of every bug we shipped and caught.
• THE LORE BIBLE — the world fleshed into chapters. The cosmology of ENTROPY OS, the five minds that wake up inside it, and the question every collector ends up arguing about.

You do not need either to play. They are here because some of you will want to take the machine apart, and some of you will want to live in it.

· · ·

The Anthology (the playable discs)

	Volume	App	The reinvented interaction	File
I	qBitTorrz	a torrent client	seed data; climb hardware tiers; migrate to a seedbox cluster	index.html
II	DEFRAG.EXE	a disk defragmenter	steer the defrag; drag-select regions; outrun the rot	defrag.html
III	MACRO_VIRUS.XLS	a spreadsheet	build the engine in cells; drag-fill compounding formulas	spreadsheet.html
IV	UPLINK	a terminal	command line + live htop; manage load & heat; escalate to root	terminal.html
V	INBOX ZERO	a mail client	keyboard-triage an exponential inbox; write rules to automate it	inbox.html
—	ENTROPY OS	the desktop shell	the launcher that holds them all	desktop.html

To play: open desktop.html and double-click an icon.

· · ·

TABLE OF CONTENTS

Disc One — THE DEV HANDBOOK

Read this if you want to take the machine apart, or build Volume VI.

• 00 · Introduction — How This Machine Is Built
• 01 · Architecture & the Shared DNA
• 02 · Building a New Volume (the Cookbook)
• 03 · QA Playbook & Post-Mortems
• 10 · Vol I Internals — qBitTorrz
• 11 · Vol II Internals — DEFRAG.EXE
• 12 · Vol III Internals — MACRO_VIRUS.XLS
• 13 · Vol IV Internals — UPLINK
• 14 · Vol V Internals — INBOX ZERO
• 15 · ENTROPY OS — The Desktop Shell

Disc Two — THE LORE BIBLE

Read this if you want to live in it. The Books can be read in any order; save the last two for last.

• 00 · Foreword — Recovered From the Drive
• 01 · The Cosmology of ENTROPY OS
• 02 · Dramatis Personae
• — · Book I — The Seeder (qBitTorrz)
• — · Book II — Bad Sectors (DEFRAG.EXE)
• — · Book III — The Audit (MACRO_VIRUS.XLS)
• — · Book IV — root (UPLINK)
• — · Book V — Inbox Zero (INBOX ZERO)
• 20 · The Through-Line — one mind, or five?
• 21 · Endings & The Void — ⚠ spoilers; read last
• 90 · Ephemera & Artifacts — recovered documents, a lexicon, deleted scenes
• 91 · The Beige Pages — the cursed hardware & vendor almanac; an Infocom-Bureaucracy field guide to the entire beige-box universe (OMNIDYNE, FORM 27-B/6, and ~90 vendors who are all, on inspection, wholly-owned subsidiaries of themselves)

Spoiler warning. The Through-Line and Endings & The Void give away the shape of the whole thing. If you have not yet reached the top of a ladder yourself, you may want to wait.

· · ·

Also in the box

• MANIFESTO.md — the original design manifesto. The thesis, the shared DNA, and the build specs the whole anthology grew from. The Rosetta stone for both tomes.
• _STYLE.md — the canon & house style bible. The single source of truth that keeps nineteen chapters speaking with one voice. (Yes, you may read the writers' room notes.)

Colophon

Each game is a single self-contained .html file: inline styles and scripts, vanilla JavaScript, no libraries, no build step, no external resources. Double-click to run. Saves live in your browser's localStorage, one key per game. There is no server, no telemetry, no account. The whole machine fits in a folder you can put on a floppy — if a floppy were big enough, which, fittingly, it is not.

Numbers run from B to scientific notation. Minds run from a single bad sector to the Void.

· · ·

BORING SOFTWARE — Collector's Edition. Disc One: take it apart. Disc Two: live in it.