Skip to content

POM2 v1.2.2

Latest

Choose a tag to compare

@github-actions github-actions released this 20 Nov 03:09

Warning

First launch on macOS or Windows: you have to allow POM2 once. The packages
are not notarized by Apple or signed for Windows, so both systems block a
downloaded copy.

🍏 macOS: "Apple could not verify POM2". Drag POM2 from the .dmg into
Applications and try to open it. Click Done, then open the Apple menu →
System Settings → Privacy & Security, scroll down to Security, click
Open Anyway and confirm.

A package older than v1.1.2 says "POM2 is damaged" instead and has no
Open Anyway. Do not move it to the Trash. Run this in Terminal:

xattr -dr com.apple.quarantine /Applications/POM2.app

🪟 Windows: "Windows protected your PC". Click More info, then
Run anyway.

  • The ][+ firmware is fixed at the source. The apple2p.rom POM2
    downloads had the Monitor's reset entry as its IRQ/BRK vector, so every
    interrupt on a ][+ dropped to the * prompt. POM2 has patched it in
    memory since v1.2.1; the file itself is now Apple's ($FA40, the page MAME
    and AppleWin carry). ROM Status flags an old copy and Download missing
    ROMs
    replaces it.
  • Music and sound out of the machine. Audio Mixer ▸ Recording saves the
    Mockingboard's music as VGM (every AY write at its exact sample, both
    chips) or YM, and what you hear as WAV.
  • Debugger: Trace to file writes every instruction (PC, physical
    bank, bytes, disassembly, registers, cycles) with a format of your choice;
    Export callgrind opens the profiler in KCachegrind, routines named from
    a cc65 .dbg or a symbol file. The Source and Symbols panels read cc65's
    .dbg directly, and Step Over now stops after a ProDOS MLI call.
  • The Passport MIDI Interface (slot 2, for Ultima V and others): its
    music goes to the computer's MIDI synthesizer and can be recorded as a
    .mid timed by the emulated clock.
  • Disks: a WOZ whose bit cell is not a whole cycle (Prisoner 2) boots;
    the ImageWriter's paper is one continuous fanfold; Finder and Windows can
    open disk images with POM2 without taking them over from other programs.
  • In the browser: a link can fill several drives
    (?s6d1=…&s6d2=…, ?boot=s5d1), File ▸ Copy link to this setup
    writes one for what is running, and ?embed=1 puts POM2 in another page
    with postMessage events (boot, pause, running, error).
  • For developers: pom2_headless runs 6502 unit tests on a whole Apple
    II (--test-port, --load, exit status from the program), records VGM /
    YM / WAV and traces or profiles a run; pom2_corpus --video records every
    emulated frame; pom2_prodos edits .2mg images; --mount sNdM:path
    fills any drive from the command line; --help lists every environment
    variable.

Also: seven rounds of bug hunting since v1.2.1 — among them a paint editor
one alt-tab could break, a FASTChip set slow that ran fast, ROM files of any
size, hostile zips in the browser, the //e's $C800 window under the internal
ROM, the /NMI line in snapshots, and two rounds over this release's own new
features before it shipped (docs/audits/bug-hunt-2026-11-19.md). deater's
six demos and Apple's Service Disk joined the compatibility corpus, and the
$C019 VBL edge is checked on every push.

Full changelog