Repository navigation
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.romPOM2
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.dbgor a symbol file. The Source and Symbols panels read cc65's
.dbgdirectly, 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
.midtimed 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=1puts POM2 in another page
withpostMessageevents (boot, pause, running, error). - For developers:
pom2_headlessruns 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 --videorecords every
emulated frame;pom2_prodosedits.2mgimages;--mount sNdM:path
fills any drive from the command line;--helplists 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.