This emulator needs two things it does not ship, because they are Apple s:

  1. A 1 MB (1 048 576 byte) dump of your iPod s NOR flash. Conventionally named
     internal_rom_000000-0FFFFF.bin, after the offset range it covers.
  2. Either an iPod software-update bundle (an .ipsw), from which a drive is built
     for you, or a drive image you already have.

Just run ipod-emulator. It opens on a setup screen that asks for both, says what
each file you picked actually is, and remembers them - so you do this once, and the
command-line recipes then use the same pair with no arguments. The images... button
in the footer takes you back there to change them.

No window on this machine? ipod-boot setup asks the same two questions here.

A cold boot spends about a minute on a white screen. That is faithful - the hardware
shows one too - but it takes far longer here than on hardware, which is a known bug.
The footer shows how far along it is. See KNOWN-BUGS.md.

Nothing here is signed. Anything you build yourself is not quarantined and runs with
no ceremony; a downloaded binary may need to be allowed once by the OS.

Windows: SmartScreen shows "More info" then "Run anyway" for a downloaded binary.
