Repository navigation
v0.4.0
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 toolsRequires 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>