Repository navigation
Releases
v0.14.4
v0.8.6
Fixes two real BASIC tokenizer bugs. First: a variable name starting with a keyword (TOTAL, FORMAT, etc.) was silently torn apart during tokenization, regardless of spacing (could affect any hand-written BASIC loader). Second: BASIC listings in the standard Spectrum editors were showing doubled spaces after keywords (LET TOTAL instead of LET TOTAL), since a source-typed space was being stored on top of the one the ROM decoder always supplies itself. Verified against ZX Spectrum ROM behavior fixtures, ZenZX emulator run, and automated using zx scr ocr reading the actual screen output, not just unit tests.
Full Changelog: v0.8.5...v0.8.6
v0.8.5
v0.8.5
Fixes two real BASIC tokenizer bugs. First: a variable name starting with a keyword (TOTAL, FORMAT, etc.) was silently torn apart during tokenization, regardless of spacing (could affect any hand-written BASIC loader). Second: BASIC listings in the standard Spectrum editors were showing doubled spaces after keywords (LET TOTAL instead of LET TOTAL), since a source-typed space was being stored on top of the one the ROM decoder always supplies itself. Verified against ZX Spectrum ROM behavior fixtures, ZenZX emulator run, and automated using zx scr ocr reading the actual screen output, not just unit tests.
Full Changelog: v0.8.4...v0.8.5
v0.8.4
v0.8.4
- NEW:
zx tap make --basicfor BASIC-to-tape conversion, plus aMakefilefor the build/test/release loop. - Fixes a real bug where BASIC tapes made without
--autostartsilently auto-ran anyway, and adds correct £/© handling in tape block names. - Docs cleanup: stale migration doc removed, library docs caught up on
pkg/pzx/pkg/szx/pkg/rzx.
Full Changelog: v0.8.3...v0.8.4
v0.8.3
Added PZX, RZX, SZX support, expanded conversion pairs, vastly improved documentation
Full Changelog: v0.6.0...v0.8.3
v0.6.0
- Vastly improved tape decoding support in .tap and .tzx
- New
zx scr ocrcommand decodes text from the ZX Spectrum screen, as long as the standard ROM font is used.
Full Changelog: v0.5.0...v0.6.0
v0.5.0
--- The most important feature of this release is the addition of the pkg/scr image management package and tools.
--- Added various features and bug fixes.
Full Changelog: v0.4.1...v0.5.0
v0.4.1
Added extensive CI support with binaries built for ~17 platform / architecture pairs.
Full Changelog: v0.4.0...v0.4.1
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>