PEEKaboo

PEEK($DFF006)=$2C81the beam, right now

An Amiga you can see through.

PEEKaboo is an Amiga emulator with the lid off. Play any game, demo or diskmag, then look inside while it runs: the copper painting the sky, the blitter drawing the sprites, every byte of memory and every track of the disk.

Point at the ball.Tap near the ball. The lens shows what the chips see. The ball never spins. Its colour registers take turns.

$FC0000 Kickstart ROM, where every boot begins

TheExplorer

97,424 disks. Pick one and it boots.

The TOSEC browser puts the Amiga's catalogued history in one list: games, demos, diskmags, coverdisks and public domain. Search it, filter it, pick a title. PEEKaboo fetches the disk, boots it, and keeps it in your recent files for next time.

Spotted something on Pouët or Demozoo? The browser extension adds a button to the page that sends the release straight to PEEKaboo.

  • Filter like a collector. Category, group, language and region, plus TOSEC's own flags: cracked, trained, alternate, verified.
  • It boots what you've got. ADF, extended ADF, DMS, IPF, SCP flux, hard files, WHDLoad and CD32.
  • Missed a jump? Rewind a few seconds, or save a state and come back to it tomorrow.
Games47,641
Demos22,893
Applications6,846
Collections6,815
Diskmags3,102
Coverdisks3,034
TOSEC Browser

A sample of 306 real entries from the catalogue. Pick one to boot it.

$E80000 Autoconfig, where expansion boards say hello

TheTinkerer

Build the Amiga you could never afford.

Start with an A500 and half a meg, or go straight to an A4000T with a 68060. Every Amiga from the A1000 to the CD32 and CDTV is one preset away, and you can change any part of it: processor, chipset, Chip and Fast RAM, Kickstart.

Then fill the slots. Zorro III memory, a Picasso96 graphics card, an A2065 network card, MIDI, serial and parallel ports, a sound card, CD-ROM drives, and hard drives that are just folders on your PC.

  • Every chipset. OCS, ECS and AGA, with Akiko for the CD32.
  • Every processor. 68000 to 68060, with FPU and MMU when you want them.
  • Try it on the board behind this page. Pick a machine and watch the chips swap.
Machine

Amiga 500 As it left the shop

CPU
68000 at 7.09 MHz
Chipset
OCS: Agnus, Denise, Paula
Memory
512 KB Chip + 512 KB trapdoor
Kickstart
1.3
Drives
DF0: internal, DF1: external
Slots
Side expansion port

The circuit board behind this window follows the machine you pick.

$DFF000 Custom chips, where Agnus, Denise and Paula live

TheCurious

How on earth did it do that?

Keep scrolling. The picture comes apart into its five bitplanes.

A 7 MHz computer from 1985 shouldn't be able to do what Amiga demos do. The secret is a team of custom chips working beside the processor, each with its own job.

Agnus
Moves memory around, and runs the copper and the blitter.
Denise
Turns bitplanes and eight sprites into pixels.
Paula
Plays four voices of sound and reads the disk.
CIA ×2
Timers, keyboard, joystick buttons and the drive motor.
68000
Runs the program, whenever the chips let it near the bus.

PEEKaboo lets you watch the team at work. Pause any frame and read the copper list that painted the sky, the blitter jobs that drew the scene, and the exact moment each register was written.

  • Raster beam view. Every colour clock of the frame, coloured by what used the bus.
  • Layers you can switch off. Hide a bitplane or a sprite and see what's underneath.
  • Copper and blitter logs for every frame, with the hardware reference one click away.
  • Inside AmigaOS. Tasks, libraries, devices, interrupts and memory, as Exec sees them.
Copper list, live
$021A40  2C07 FFFE  WAIT  line 44
$021A44  0180 0EEF  MOVE  COLOR00 = $EEF
$021A48  FFFF FFFE  END

This is the real copper list for the stripes behind this page. Watch the WAITs follow the bars.

$00007C Level 7 interrupt, the freeze button

ThePirate

Action Replay veterans, press the big red button.

If you had an Action Replay cartridge, you'll feel right at home. PEEKaboo's console speaks the same commands, then keeps going. Freeze the game, hunt down your lives counter, lock it, and save the trainer for next time.

Find the music in memory and rip it. Follow the copy protection to the one branch that decides your fate, and patch it. Hoist the flag and climb aboard.

  • Trainers. Search for a value you can see, or deep-search for one you can't. Lock what you find and it becomes a cheat.
  • Share them. Save trainer files, or import RetroArch .cht cheats.
  • Rip it. Find Protracker modules anywhere in memory and save them to disk.
  • Break on anything. An address, a memory write, a copper instruction, a raster line, a DOS call, a disk read, a CPU exception.

Go on. Press it.

Debugger Console
Machine frozen at $00FC0F3A. Type a command.
TS 3
Trainer started — 2917 candidates holding $03.
Change the value in-game, then run  T <newvalue>  to narrow.
(back to the game, lose a life, freeze again)
T 2
23 candidates still match $02:
(and once more)
T 1
1 candidate still match $01:
  $0002A6F4
PR 2A6F4 SET=9 SIZE=8
Lock 1 set: forcing $09 at $0002A6F4.
PR SAVE lives.trainer
X
Back in the game with nine lives. Arr.

$BFD100 CIA-B, drive motor, side and step

TheArchivist

Floppies fade. What's on them doesn't have to.

Scroll to move the drive head across the disk.

Plug a Greaseweazle or an XCopy Standalone into your PC and PEEKaboo reads real Amiga floppies. Boot a disk straight from the drive, copy protection and all, or copy it to an image. Write images back to real disks when you need a fresh copy.

When a disk fights back, open it up. Every sector is decoded with both checksums, the block map shows what each block holds, and the validator walks the file system looking for broken chains. Repair the checksum, drag the files out, and check the image against TOSEC.

  • Live drives on DF0: to DF3: through Greaseweazle, XCopy Standalone, DrawBridge and SuperCard Pro.
  • Both directions. Read whole disks, write whole disks, and let the emulated Amiga write to a real one.
  • Every format. ADF, extended ADF, DMS, IPF and SCP.
  • Know what you've got. Boot block identification, viruses included, and TOSEC matching by hash.
Floppy Drives
DF0: Greaseweazle, live cylinder
  • DF0: Greaseweazle ready. Cylinder 0, head 0.
  • Cyl 0: 11 of 11 sectors, sync $4489

$000004 AbsExecBase, the one fixed address in AmigaOS

TheDeveloper

Press F5. Watch it run.

PEEKaboo plugs into Bartman's Amiga toolchain for VS Code. Press F5 and your program is running on the emulated Amiga moments later, symbols and all. Set breakpoints in C, C++ or assembly, step through, and read the call stack in your own source.

Then find out where the frame went. The profiler times every function and every line from a trace of the real 68000 code and draws it as a flame chart across the Frame Scrubber. Your debug bitmaps and palettes appear in their own window. Rewind a few frames, change a line, run it again.

  • Source-level debugging from VS Code, with line, inline and call-frame information from DWARF.
  • Profiling per frame, per function and per line, with idle time marked.
  • Bartman's debug calls work. Registered bitmaps, palettes and idle markers show up live.
  • Tests that boot. Record a session as a scenario and replay it against golden frames.
cube.c
88 static void DrawFrame(void)
89 {
90     BlitClear(back, SCREEN_BYTES);
91     RotateCube(&cube, frame);
92     DrawCube(back, &cube);
93     SwapBuffers();
94     frame++;   // 50 of these a second
95 }
Profiler: one frame, 141,876 cycles

Hover a block to see its cycles. The line is the beam behind this page.

$DFF096 DMACON, which chips get the bus

InsideOne Frame

Twenty milliseconds, taken apart.

Behind this text is the Frame Scrubber, blown up. Keep scrolling to zoom from the whole frame down to one instruction.

Fifty times a second, a PAL Amiga draws a frame: 313 lines of 227 colour clocks, more than 70,000 chances to use the chip bus. Every one of them goes to somebody. The bitplanes fetch the picture, the copper rewrites registers as the beam goes by, the blitter moves memory, sprites, audio, disk and refresh take their fixed slots, and the processor gets whatever is left.

The Frame Scrubber lays one frame out as a strip you can zoom with the mouse wheel. Pull back and you see its shape: the blank at the top, the picture, the music, the blits. Zoom in and every colour clock is there, down to the instruction that used a slot, what it should have cost and what it really cost.

It works on any program, with no source needed. Load a demo from 1991 and see how its frame is spent, then load your own and see where yours goes. From the top, the strip shows:

  • Heat, line by line: CPU density, bus stalls, cycles, branches, DMA pressure, or one DMA channel.
  • DMA: every bus slot, coloured by the chip that owned it, with each instruction's number once you zoom in.
  • Idle: the time your program told Bartman's markers it was only waiting.
  • Fn bands: your functions across the frame from the program's symbols, flat or as a flame chart.
  • Blits from start to finish, coloured by what started them, with their registers, minterm and a preview of what they wrote.
  • Copper: a tick for every copper instruction. Click one to open it in the Copper window.
  • Above it all, Frame History's seek bar picks the frame, with previews, A–B loops and reverse play. Scrub anywhere and the disassembly, the copper trace and the picture follow.
Frame Scrubber
L0000000 Idle: 20.0%
Zoom to
Zoom 1×

The whole frame in 20 milliseconds. Click the strip and use the mouse wheel to zoom, the way PEEKaboo does, or pick a level.

  • CPU
  • Copper
  • Blitter
  • Bitplane
  • Sprite
  • Audio
  • Disk
  • Refresh
  • Free

$DFF0A0 AUD0LC, where Paula finds the music

TheDesigner

Put it on the beat.

Exocet is a sync tracker built into PEEKaboo. The coder exposes the knobs: a colour, a speed, a camera move, a cut from one part to the next. You set them on the song's own rows while the real demo runs on the emulated Amiga. Key a flash on every snare, scrub back a bar, push, and watch it land.

When it looks right, Exocet writes a new disk with your keys in it, built by the production's own tools. Send it to the coder and go and make the next part.

  • A tracker grid on the music's rows, with the song's four channels beside your tracks. Each channel lights up as Paula plays it.
  • Every snare at once. Pick a sample and key a track on every row it plays.
  • Step, linear, smooth and ramp interpolation, and colour tracks with a proper picker.
  • Push, rewind, repeat. Changes go straight into the running demo, and Frame History takes you back a bar.
Exocet Grid: party.exocet
Row 00:00 Part PLASMA
RowKickSnareHatBassdirector.cutflash.colorplasma.zoomtunnel.speed
00:00C-2 01---G-4 03A-1 04PLASMA#FFFFFF001.00 ~1.00

The effect behind this page follows these tracks. Press Play to hear the beat it's synced to.

127.0.0.1:7475 MCP server, the one address outside the Amiga

TheAI
Enthusiast

Give your AI an Amiga to look at.

Every dot is one of PEEKaboo's 191 tools. They light up as the agent calls them.

PEEKaboo runs an MCP server with 191 tools: registers, memory, disassembly, the copper and the blitter, disks, screenshots, breakpoints and rewind. Connect Claude or any MCP client and ask it about what's on screen. Instead of guessing, it goes and looks.

That changes how you build. Ask for an effect and your agent can write it, run it, watch it misbehave, find out why and fix it, in a loop a chat window on its own can't manage. Learn the Amiga with the rest of PEEKaboo and the two of you get there faster. The only limits are time, tokens and imagination.

  • 191 tools across the CPU, the custom chips, memory, disks, the file system and the UI.
  • Notes that stick. The agent leaves labels and comments in the disassembly for you to find.
  • Watch it work. The MCP Activity window shows every call as it happens.
Claude, connected to PEEKaboo
  1. My scroller judders about once a second. Can you find out why?
  2. run_until_frame 1800
  3. get_blitter_log
  4. get_register_log
  5. set_beam_break line 212
  6. inspect_call_chain
  7. disassemble $00021C40
  8. Once every 50 frames your music routine does its pattern jump and runs long. That pushes the blit that clears the scroller past line 212, so the next frame draws over a half-cleared buffer.
  9. Move mt_music after the blit wait and it goes away. Want me to make the change and watch 500 frames to be sure?
  10. Yes please.
  11. load_document scroller.exe
  12. loop_frames 500
  13. diff_frames
  14. Rebuilt and ran 500 frames. The clear now finishes on line 168 every time, and no frame shows the tear.

An example session.

Your Amiga, amplified.

PEEKaboo is a lens for the machine you love. Keep the real one on your desk and use PEEKaboo to see how it works: play the software, open it up, learn the tricks, then make something new.

Version 0.9.1, for Windows 10 and 11, 64-bit. A 33 MB zip with no installer: unzip it anywhere and run it. Bring your own Kickstart ROMs and Workbench (Amiga Forever, AmigaOS 3.2, or your own Amiga's) and the setup wizard finds them for you. It isn't code-signed yet, so Windows may ask you to confirm the first time. Free and open source under the GPL, with every release on GitHub.

PEEKaboo stands on the shoulders of PUAE and WinUAE, Robert Smith's FloppyBridge, alpine9000's ENGINE9000, Losso's Coppenheimer, Bartman's vscode-amiga-debug, the GNU Rocket sync library, the TOSEC project and Dear ImGui.