Tools to manipulate ZX Spectrum files
Python Makefile
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
test
zxtools
.gitignore
.pylintrc
.travis.yml
LICENSE
Makefile
README.rst
setup.py
zeus2txt.jpg

README.rst

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