c64-binary-analyzer

# C64 Binary Analyzer

A cross-platform disassembler and reverse-engineering tool for Commodore 64 machine code.

Load `.prg`, `.bin`, or `.d64` files, inspect the disassembly in a fully interactive table, patch bytes, add labels and bookmarks, and export your work when you're done.

## Features

- Interactive disassembly table with addresses, bytes, opcodes, cycles, flags, and notes

- File loading for `.prg`, `.bin`, and `.d64` images

- Search, jump history, and direct navigation to branch targets

- Auto-generated labels for subroutines and jump targets

- Notes, bookmarks, and jump reference popups

- Byte patching with undo/redo

- Self-modifying code detection and PETSCII hints

- Export to plain-text `.asm`

- Optional VICE emulator integration

- Optional Ultimate64 integration

## Requirements

- Python 3.10 or newer

- tkinter

- Optional: `tkinterdnd2` for drag-and-drop loading

- Optional: VICE for emulator testing

## How to Run

```bash

python3 analyzer.py

```

You can also open a file directly:

```bash

python3 analyzer.py myprogram.prg

python3 analyzer.py game.d64

```

## Supported File Types

- `.prg` - Commodore 64 program files with an embedded load address

- `.bin` - Raw binaries where you enter the load address manually

- `.d64` - 1541 disk images with a file picker for PRG contents

## Controls

- Double-click the ASM column to follow jumps and branches

- Double-click the Notes column to add annotations

- Double-click the Bytes, Hex, or Dec column to patch bytes

- Right-click rows for labels, bookmarks, and breakpoints

- Use the search bar to find text across ASM and Notes

## Built For

Anyone who wants to inspect, patch, and understand Commodore 64 binaries without leaving a modern desktop environment.

If you’re sharing this on itch.io, add a screenshot or two above this text and use the first paragraph as the short description.