Metadata-Version: 2.4
Name: zx
Version: 0.13.4
Summary: ZX Spectrum emulation framework
Home-page: https://github.com/kosarev/zx/
Author: Ivan Kosarev
Author-email: Ivan Kosarev <mail@ivankosarev.com>
License: MIT
Project-URL: Homepage, https://github.com/kosarev/zx/
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pysdl2
Requires-Dist: pysdl2-dll
Requires-Dist: numpy
Requires-Dist: evdev; sys_platform == "linux"
Dynamic: author
Dynamic: home-page
Dynamic: license-file

# zx
ZX Spectrum emulation framework in Python and C++

![Python package CI](https://github.com/kosarev/zx/actions/workflows/python-package.yml/badge.svg)

![Elven](https://raw.githubusercontent.com/kosarev/zx/master/screenshots/elven.png "Elven Warrior")

[More screenshots](https://github.com/kosarev/zx/tree/master/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](https://github.com/kosarev/z80).


### 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](https://github.com/kosarev/zx/blob/master/test/screen_timing).
* 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:
```shell
$ pip install --upgrade pip
$ pip install --upgrade setuptools wheel

$ pip install zx
```

Or directly from the repository for current development version:
```shell
$ pip install --upgrade setuptools wheel
$ pip install git+https://github.com/kosarev/zx
```

Local development setups are also supported:
```shell
$ git clone --recursive https://github.com/kosarev/zx
$ cd zx
$ pip install --upgrade setuptools wheel
$ pip install --editable .
```

Running:
```shell
$ 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

```shell
$ zx elven.z80
```

```shell
$ zx exolon.rzx
```

```shell
$ 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](https://github.com/boriel/zxbasic) sources: `.zxb`.

Archives: `.zip`.


### Converting files

```shell
$ zx jack.tzx jack.wav
```

```shell
$ zx eric.tap eric.z80
```


### Dumping files

```shell
$ 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](https://github.com/kosarev/zx/blob/master/test/screen_timing/SCREEN_TIMING.md)
