Regenerator 2000

A 6502 disassembler with a TUI. A modern take on Regenerator.

Features

Regenerator 2000 brings modern conveniences to 6502 disassembly:

• Disassembly: Full 6502 support including undocumented opcodes.
• Hex Dump:
  • Side-by-side view with disassembly.
  • Synchronized or independent navigation.
  • Unshifted or Shifted PETSCII and Screencode charset.
• Sprites:
  • Side-by-side view with disassembly.
  • Multicolor or Single Color
• Bitmap:
  • Side-by-side view with disassembly.
  • High-Resolution (320x200) and Multicolor (160x200).
  • Uses quadrant-block rendering for full resolution in TUI.
• Charset:
  • Side-by-side view with disassembly.
  • Multicolor or Single Color
• Blocks:
  • Side-by-side view with disassembly.
• Platforms: Supports Commodore 8-bit machines like C64, C128, Plus/4, etc.
• Import: Load .prg, .crt, .t64, .vsf, .bin, .raw, and .regen2000proj files.
• Export: Generate compatible assembly source code for:
  • 64tass
  • ACME
  • Kick Assembler
  • ca65
• Project Management: Save and load your work with .regen2000proj files.
• Analysis: Auto-analysis to identify code and data regions.
• Editing:
  • Labels: Add, edit, and remove local and global labels.
  • Comments: Add side comments and line comments.
  • Origin: Change the load address/origin of the binary.
  • Data Types: Convert regions to Code, Byte, Word, Address, Lo/Hi Address, Hi/Lo Address, PETSCII Text, Screencode Text, External file or Unknown.
  • Undo/Redo: Full history support for all actions.
• Navigation:
  • Jump: Go to specific addresses, specific line numbers, or follow operands.
  • X-Ref: Inspect cross-references for labels/addresses.
  • History: Navigate back to previous locations.
• Customization:
  • Configure document settings (max x-refs, platform, assembler).
  • Customizable display options (show/hide all labels, etc.).
• TUI:
  • Text User interface
  • Everything can be done from the keyboard
  • Visual Mode: Vim-like selection for batch operations.
• Fast:
  • Extremely fast

Requirements

Recommended Terminals

To ensure the best experience, especially regarding keyboard shortcuts and rendering, we recommend using a modern terminal.

Installation

From Crates.io

cargo install regenerator2000

From Source

git clone https://github.com/ricardoquesada/regenerator2000.git
cd regenerator2000
cargo install --path .

Usage

Start the application with an optional file to load:

regenerator2000 [path/to/file.prg]

Supported file formats: .prg, .crt, .t64, .vsf, .bin, .raw, and .regen2000proj.

Keyboard Shortcuts

Some actions can be triggered with more than one keyboard combination. This is intentional to ensure compatibility across Windows, macOS, and Linux, and different terminal emulators.

Support and Documentation

• User Guide
• Architecture
• Support in Discord (join the #regenerator2000 channel, under "Misc Projects")

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgements

• Regenerator: The original 6502 disassembler for Windows.
• 64tass, ACME, Kick Assembler, ca65 : Supported assemblers.

License

Dual license: MIT and Apache 2