Metadata-Version: 2.1
Name: zx
Version: 0.6.0
Summary: ZX Spectrum Emulator for Researchers and Developers
Home-page: https://github.com/kosarev/zx/
Author: Ivan Kosarev
Author-email: ivan@kosarev.info
License: MIT
Description: [![Build Status](https://travis-ci.org/kosarev/zx.svg?branch=master)](https://travis-ci.org/kosarev/zx)
        
        # zx
        ZX Spectrum Emulator written in a mix of Python and C++.
        
        ![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
        
        * 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/SCREEN_TIMING.md).
        * Sound: not supported yet.
        * Tape: TAP and TZX formats supported as well as conversion to WAV.
        * Snapshots: Z80.
        * Playback recordings: RZX.
        
        
        ### Installation and running
        
        ```shell
        $ pip install zx
        ```
        
        ```shell
        $ zx
        ```
        
        
        ### Controls
        
        `F1` displays help.
        
        `F2` is to save snapshot.
        
        `F3` is to load snapshot or tape file.
        
        `F6` pauses/resumes tape.
        
        `F10` and `ESC` quit the emulator.
        
        `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 eric.tap
        ```
        
        
        ### Converting tape files to the WAV format
        
        ```shell
        $ zx jack.tzx jack.wav
        ```
        
        
        ### 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)
        
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: X11 Applications :: GTK
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Emulators
Description-Content-Type: text/markdown
