Skip to content

codeatcpp/zxtools

Repository files navigation

Tools to manipulate ZX Spectrum files

https://travis-ci.com/codeatcpp/zxtools.svg?branch=master https://img.shields.io/github/release/codeatcpp/zxtools.svg?style=flat https://img.shields.io/pypi/v/zxtools.svg?style=flat https://app.fossa.io/api/projects/git%2Bgithub.com%2Fjia3ep%2Fzxtools.svg?type=shield

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