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

All the keyboad shortcuts are documented here: keyboard_shorcuts

Support and Documentation

• Documentation
• 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