Skip to content

Releases

v0.14.4

Choose a tag to compare

@ha1tch ha1tch released this 15 Nov 23:16

Full Changelog: v0.8.6...v0.14.4

v0.8.6

Choose a tag to compare

@ha1tch ha1tch released this 02 Sep 13:04

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

Choose a tag to compare

@ha1tch ha1tch released this 01 Sep 22:16

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

Choose a tag to compare

@ha1tch ha1tch released this 01 Sep 21:20

v0.8.4

  • NEW: zx tap make --basic for BASIC-to-tape conversion, plus a Makefile for the build/test/release loop.
  • Fixes a real bug where BASIC tapes made without --autostart silently 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

Choose a tag to compare

@ha1tch ha1tch released this 01 Sep 00:34

Added PZX, RZX, SZX support, expanded conversion pairs, vastly improved documentation

Full Changelog: v0.6.0...v0.8.3

v0.6.0

Choose a tag to compare

@ha1tch ha1tch released this 27 Aug 21:18
  • Vastly improved tape decoding support in .tap and .tzx
  • New zx scr ocr command 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

Choose a tag to compare

@ha1tch ha1tch released this 30 Jun 13:21

--- 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

Choose a tag to compare

@ha1tch ha1tch released this 29 Jun 07:12

Added extensive CI support with binaries built for ~17 platform / architecture pairs.

Full Changelog: v0.4.0...v0.4.1

v0.4.0

Choose a tag to compare

@ha1tch ha1tch released this 29 Jun 06:13

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>

v0.2.0

Choose a tag to compare

@ha1tch ha1tch released this 29 Jun 00:42
Added z80 v1 v2 v3, sna support, BASIC tokenisation