zx 0.13.3

ZX Spectrum emulation framework

zx

ZX Spectrum emulation framework in Python and C++

More screenshots

Features

• Designed to be suitable for research and development purposes such as unattended testing of Spectrum software, timing analysis, etc.
• Meant to be easy to customize and re-use via Python interfaces.
• Fast and accurate emulation.
• Based on the fast and flexible Z80 emulator.

Development status

• Platforms: Linux and Windows (via SDL2).
• General status: working pre-alpha.
• Supported machines: 48K only for now.
• Display: multi-colour effects, accurate timings.
• Sound: EAR beeper and tape output supported.
• Tape: TAP and TZX formats supported as well as conversion to WAV.
• Snapshots: Z80.
• Playback recordings: RZX.
• Joystick: D-Pad mapped to cursor keys, supported via SDL.

Installation and running

For the latest release:

$ pip install --upgrade pip
$ pip install --upgrade setuptools wheel

$ pip install zx

Or directly from the repository for current development version:

$ pip install --upgrade setuptools wheel
$ pip install git+https://github.com/kosarev/zx

Local development setups are also supported:

$ git clone --recursive https://github.com/kosarev/zx
$ cd zx
$ pip install --upgrade setuptools wheel
$ pip install --editable .

Running:

$ zx

Controls

F1 displays help.

F2 is to save snapshot.

F3 is to load snapshot or tape file.

F6 pauses/resumes tape.

F10 quits the emulator.

F11 and double click switch between fullscreen and windowed mode.

PAUSE and mouse click pause/resume emulation or RZX playback.

Any Spectrum key stroke resumes emulation and leaves the RZX playback mode back to the regular emulation mode.

Running snapshots, recordings and tapes

$ zx elven.z80

$ zx exolon.rzx

$ zx https://www.worldofspectrum.org/pub/sinclair/games/e/EricTheFloaters.tzx.zip

Supported formats

Snapshots: .z80.

Tapes: .tap, .tzx, .wav.

Playbacks: .rzx.

Screenshots: .scr.

ZX Basic compiler sources: .zxb.

Archives: .zip.

Converting files

$ zx jack.tzx jack.wav

$ zx eric.tap eric.z80

Dumping files

$ zx dump rick.z80
OrderedDict([('id', 'z80_snapshot'), ('a', 213), ('f', 66), ...

On the dump command, zx parses the specified file (that can be of any supported format) in the form of raw Python data.

Reference papers

• Screen timings