Skip to content

v0.4.0

Choose a tag to compare

@ha1tch ha1tch released this 29 Jun 06:13
· 15 commits to main since this release

zentools

A Go library and command-line toolkit for converting and manipulating ZX Spectrum file formats: TAP, TZX, snapshots (.sna, .z80), and BASIC. No third-party dependencies.

Four focused tools:

Tool Does
maketap binary to TAP (a CODE block)
totap binary or BASIC text to TAP
loadtap inspect a TAP, or extract its raw data
tap2tzx one or more TAPs to a single TZX, with metadata

And zx, a unified command organised by format:

Command Does
zx tap make and inspect TAP images
zx tzx make and inspect TZX images
zx basic tokenise and detokenise ZX BASIC
zx snap build a runnable snapshot from a binary, or inspect one
zx convert convert between any tape and snapshot format
zx info identify and summarise a file

Install

go get github.com/ha1tch/zentools@latest   # library
go build ./...                             # command-line tools

Requires Go 1.25 or later.

Library

Six packages, each owning one format family, depending only on the standard
library:

Package Does
pkg/tap read and write TAP images
pkg/tzx read and write TZX images (v1.20)
pkg/basic tokenise and detokenise ZX BASIC (48K and 128K)
pkg/snapshot read and write .sna and .z80 via a neutral state
pkg/build overlay code onto a boot state, emit tapes/snapshots
pkg/version the library version constant

Copyright (c) 2026 haitch <h@ual.li>