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 boot ROM.
     The best way to get one is to read it off your own iPod with Rockbox - it takes
     about five minutes and Rockbox can be uninstalled straight afterwards. See
     https://www.rockbox.org/wiki/IpodFlash.html

  2. Apple s iPod software update (an .ipsw). The emulator builds a drive from it.
     Apple no longer serves these.

Just run ipod-emulator. It asks for both, one at a time, and tells you what each file
you picked actually is before it tries to boot. The setup... button in the footer
brings that screen back.

This is ALPHA. It boots, it draws, it plays Brick, and it is a few days old. Please
report anything broken: https://github.com/siggifly/ipod-emulator/issues

The command-line tools are in tools/ and are for taking firmware apart, not for
playing anything.

Nothing here is signed. Anything you build yourself is not quarantined; a downloaded
binary may need to be allowed once by the operating system.

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