TextMachine 3.0D for ZX Spectrum and Didaktik

TextMachine 3.0D is a Czech/Slovak WYSIWYG text editor for the ZX Spectrum and compatible Didaktik computers. It supports four editable 8×12 fonts, Czech and Slovak text, 32- and 64-column views, block formatting, headers and footers, ScreenMachine illustrations, installable utilities and several printer families.

This repository preserves the supplied distribution media and provides a readable, fully named and heavily commented reconstruction of the complete machine-code system. The source is reconstructed from preserved binaries; it is not the original historical source code.

Building the repository reproduces the 18,856-byte editor core, the Font Editor, all supplied printer and communications additions, the exact installer BASIC payloads, the original TZX distribution and both D80 images.

At a glance

Field	Value
Platform	ZX Spectrum 48K and Didaktik-compatible systems
Core load range	$7600-$BFA7
Core size	18,856 bytes
Font Editor	$EE48-$FDE7, 4,000 bytes
Printer slot	$B66C-$BB7F, 1,300 bytes
Historical additions	BT-100, GAMACENTRUM 01, Centronics STROBE A/B, ZX Interface 1 RS-232
Preserved media	TZX distribution, installation D80, runnable D80, Czech manual
External dependencies	None beyond Python 3.10+

Repository layout

documentation/  stable architecture, build and hardware guides
extracted/      deterministic inventories and reference payloads
original/       frozen original media and manual
src/            authoritative Z80 and BASIC sources
tools/          assembler, media and verification tools
Makefile        convenience targets
NOTICE.md       preservation and rights notice
requirements.txt

The publication repository deliberately omits iteration changelogs, temporary analysis, review ledgers, progress reports and generated build products. Start with src/README.md and documentation/SOURCE-TREE.md.

Build and verify

python3 tools/build.py

or:

make build

On Windows PowerShell:

./build.ps1

The build stops on the first mismatch. Main outputs include:

build/bin/textmachine-core-d80.bin
build/bin/textmachine-core-tape.bin
build/bin/font-editor.bin
build/media/TextMachine-distribution-rebuilt.tzx
build/media/TextMachine-installation-rebuilt.d80
build/media/TextMachine-run-rebuilt.d80
build/build-report.json

make verify repeats the complete build and make clean removes generated products.

Exact preservation fingerprints

18,856-byte D80 core
2bab4209f0338cece225f0bbe430f6afb146153fe261df724b5c7e4e45c540fa

18,856-byte cassette core
94f7bf8eef3ebc1e0f15a3b4ae7965dfd46ad9312352a4e67cf81e742bde3fc8

original/TextMachine.tzx
a92aec34810457e6f62af82ec6ba8938565048ca095c4e3b488cc1245f19a544

original/TextMachineInstall.d80
3b0567b6e61dede888c58c40fff73245da62ce310d13dc1ef31c5befa734770c

original/TextMachineRun.d80
d4be1baaefb2275a5aca610a24d08ad30a6062c508d218e09a4dae4d7a4262c4

Source architecture

The canonical top level is src/core/textmachine_core.asm. The alternative printer and communications modules are independent sources under src/drivers/. The code preserves fixed-address behaviour, self-modified state fields and unusual stack transfers because they are part of the program's ABI and device protocol.

See documentation/ARCHITECTURE.md, documentation/MEMORY-MAP.md and documentation/PRINTER-AND-COMMUNICATIONS.md.

Preservation and rights

The original binaries, media and manual are included for software preservation, research and interoperability. Rights remain with the respective authors and rightsholders. See NOTICE.md.