Emulator jsbeeb

jsbeeb — BBC Micro

jsbeeb is Matt Godbolt's BBC Micro emulator — the BBC B and Master 128 entries in GenX-DOS share one bundle. The integration was mostly hands-off (jsbeeb is a polished web product in its own right), but the bundle is the largest in the suite and has some scary-looking orphan situations that are actually load-bearing.

Where we started

jsbeeb is a Vite-built TypeScript bundle, GPL-3.0-or-later. Drop in the dist/ directory verbatim, point play.html at dist/index.html?disc=<url>, done. There wasn't really an integration step — jsbeeb already supports per-machine URL parameters and direct disc loading. We just hosted the build.

The bundle is 25 MB and most of it isn't orphan

A quick du -sh shows ~25 MB, which raises eyebrows on a static site. Two-thirds of that is intentional. Worth documenting because every audit pass re-discovers these:

• dist/teletext/ is 21 MB. Four txt0..3.dat files, referenced by dist/assets/index-*.js via the URL pattern teletext/txt${n}. No GenX-DOS menu path triggers teletext mode. The data is there because upstream jsbeeb keeps Ceefax viewer alive (F12 menu inside jsbeeb). Removing it is safe iff no one ever hits the teletext button. Defensible for our use, but it counts as a feature regression, not a cleanup.

• dist/roms/{atom,tube,compact,b1770,a01,us,b,bp}/ — system ROMs for BBC variants we don't expose (Acorn Atom, Tube co-processors, Master Compact, 1770 disc controller, BBC A01 / B early-OS / B+, US BBC). All referenced by assets/index-*.js's model picker, so they're technically not orphans even though we only ever launch Model B and Master 128. ~150 KB total.

The teletext blob is the only one that would meaningfully shrink the bundle if removed.

How the two entries work

There are two .bat launchers — bbc.bat and master.bat — pointing at different ?model= URL params on the same play.html. jsbeeb's model picker takes either; our wrapper is identical.

Bundle layout

emulators/jsbeeb/
├── dist/
│   ├── index.html              ← jsbeeb entry, used directly
│   ├── assets/                 ← Vite-built bundle (this is most of jsbeeb)
│   ├── discs/                  ← bundled disc images
│   ├── images/, sounds/        ← jsbeeb chrome
│   ├── roms/                   ← BBC variant system ROMs (most unused)
│   ├── teletext/               ← 21 MB Ceefax data, kept for completeness
│   └── tapes/
├── controls.html               ← thin wrapper page
└── COPYING                     ← GPL-3.0

play.html for jsbeeb is just dist/index.html. The controls.html next to it is GenX-specific, not from upstream.

Related

• Emulator-elkjs-Electron — sibling Acorn machine
• Emulators — index