Permalink
Find file
Fetching contributors…
Cannot retrieve contributors at this time
46 lines (29 sloc) 2.27 KB

Tools to manipulate ZX Spectrum files

https://img.shields.io/travis/codeatcpp/zxtools/master.svg?style=flat https://img.shields.io/github/release/codeatcpp/zxtools.svg?style=flat https://img.shields.io/pypi/v/zxtools.svg?style=flat http://img.shields.io/pypi/dm/zxtools.svg?style=flat

Here's a set of utils to manipulate files that were copied from a TR-DOS diskette or from a tape.

Originally the tools were written to simplify the following workflow:

  1. Grab diskette image using Hobeta tool.
  2. Strip the file header and save the result to a new file.
  3. Convert resulting Zeus Z80 assembler file to the plain text format.

TODO: I have future plans to implement some more tools I need to restore my old ZX Spectrum projects.

But you can use them in the way you need. And it's very easy to use: download the package, run setup.py (or install via pip install zxtools), invoke in the following way:

$ python3 -m zxtools.hobeta strip input.hobeta result.zeus
$ python3 -m zxtools.zeus2txt result.zeus listing.asm --include-code

https://raw.githubusercontent.com/codeatcpp/zxtools/master/zeus2txt.jpg

NOTE: Python 3 is required to use this package, and Python 2 is not supported but you are welcome to fix it.

To view the resulting files with syntax colorization you can use special Visual Studio Code plugin:

https://raw.githubusercontent.com/codeatcpp/vscode-language-z80-asm/master/vscode.png