READY.

READY. is an educational & fun Commodore 64 emulator, written for learning and rebuilding after decades.

A special thank to the numberless sources of information found on the web.

Installation

Python >= 3.10 is required. On GNU/Linux xsel or xclip packages are required in order to paste text.

git clone https://github.com/tofu13/READY..git
cd READY.

For a standalone environment it is suggested to:

virtualenv venv -p python3
. venv/bin/activate
pip install -r requirements.txt

ROMS are not included here: download basic, kernal and chargen into roms/ folder.

Usage

Running the emulator

python READY..py

Options

python READY..py --help

usage: READY..py [-h] [-s {raster,virtual,fast}] [-c] [-t LOADSTATE] [-ar] [-ad] [-at AUTOTYPE] [-noar] [-ds DISPLAY_SCALE] [-ll LOGLEVEL] [datafile]

An educational C=64 emulator.

positional arguments:
  datafile              D64 image file or PRG (autodetect). Implies --autorun unless one of --autodir|--autoype|--no-autorun is set (default: None)

options:
  -h, --help            show this help message and exit
  -s {raster,virtual,fast}, --screen {raster,virtual,fast}
                        Screen driver (default: raster)
  -c, --console         Show screen in console (chars only) (default: False)
  -t LOADSTATE, --loadstate LOADSTATE
                        Load state from file (default: False)
  -ar, --autorun        Autorun * from disk (default: False)
  -ad, --autodir        Autodir (default: False)
  -at AUTOTYPE, --autotype AUTOTYPE
                        Autotype command. Use | for return key (default: )
  -noar, --no-autorun   Disable autorun when datafile is set (default: False)
  -ds DISPLAY_SCALE, --display-scale DISPLAY_SCALE
                        Display scale factor (default: 2.0)
  -ll LOGLEVEL, --loglevel LOGLEVEL
                        Log level (default: 30)

Configuration

See config.py for available parameters:

Keyboard mapping

Default keys

- PAGE_DOWN: <RESTORE>
- PAGE_UP: <UP_ARROW>
- ESC: <RUN/STOP>
- BACKSPACE, CANC: <INS/DEL>
- HOME: <HOME>
- LEFT_ALT: <C=>
- LEFT_CTRL: <CTRL>

Bonus keys

- LEFT: <SHIFT+CRSR_LR>
- UP: <SHIFT+CRSR_UD>
- INS: <INS> (<SHIFT+INS/DEL>)

Special keys

- F10 paste
- F11 enter monitor
- F12 reset
- NUMLOCK: cycle trough numpad modes: NUMeric/JoystickPort1/JoystickPort2 
- NUMPAD 0 2 4 6 8: joystick fire and directions
- RIGHT_CTRL + P: PLAY on datassette
- RIGHT_CTRL + S: STOP on datassette

Keymaps

Available keymaps: it, en.

(Definitions in constants.py, contributions welcome)

Monitor

Enter monitor pressing F11

$e5f5> help
Documented commands (type help <topic>):
========================================
convert  disass  go  help  i  mem  next  reset  step  trace  x