maux
Star on GitHub Buy me a coffee

Unpack a ShrinkIt archive from the wild

Watch / unshrink

Filmed on the Apple IIe 80-column display. The same session on the Videx UltraTerm: same keys, same text.

The Videx UltraTerm was an 80-column video card for the Apple IIe, with its own video memory and character generator, real hardware scrolling and more screen modes than the IIe's own 80 columns. This demo runs on either display; the UltraTerm film shows the original Videx UltraTerm, emulated.

Thirty years of Apple II software lives in ShrinkIt archives. This one is real, a 1990 freeware utility fetched from the asimov.net mirror. The demo lists it with nulib2 -v, unpacks it with nulib2 -x, lists the files, and reads the documentation with more.

What it types

Everything it types, in order. A line starting with $ is a command at the shell, RET included; keys lines are single keystrokes to a program (RET, ESC and the control keys are named).

$ cd /mnt/MAUX/OUT
$ nulib2 -v /mnt/MAUX/ARC/VBLSET.SHK
$ nulib2 -x /mnt/MAUX/ARC/VBLSET.SHK
$ ls
$ cksum SET.TIME SET.TIME.DOC
$ more SET.TIME.DOC

Between steps it presses ^L to clear the screen.

What the captions say

  1. Thirty years of Apple II software lives in ShrinkIt archives.
  2. This one is real: Doug Reeder's VBL clock utilities, 1990.
  3. Fetched from the wild in 2026.
  4. nulib2 -x unpacks it. LZW decompression on a 6502.
  5. ProDOS names run to 15 characters, and not one more.
  6. Two files that came out of the compressor: checksums first.
  7. And the documentation, straight from the archive.

The gate that proves it

This film is made by site/demos/unshrink.py. Run as assertions, the same file is make check-demo-unshrink, and it runs with the rest of the tests. It requires that the machine’s listing agrees with an independent reader of the archive on every name, type, size and auxiliary type; that the directory after unpacking holds exactly the archive’s files; that cksum of an unpacked program and an unpacked text file, both stored compressed (LZW) in the archive, equals the host’s checksum of the archive’s own bytes; and that the documentation text comes out row for row. The checks themselves were tested: with nulib2 replaced by a copy of true the listing is empty; with one byte flipped inside the compressed stream nulib2 reports a damaged stream and the demo fails at "nulib2 -x says nothing"; with cksum or more replaced by true the checksum and the text rows fail.

Transcript

The screen at every checkpoint the test checks, as the recorder saved it:

== host: the two files the demo checks are LZW-compressed in the archive, so only a working decompressor gets them right (t=0.0 s)
$

== list (t=22.6 s)
$ cd /mnt/MAUX/OUT
$ nulib2 -v /mnt/MAUX/ARC/VBLSET.SHK
 BIN      119 $0359 VBL.CLOCK.INT
 BIN       64 $6000 VBL.CLOCK.SETUP
 BIN     7438 $6000 SET.TIME
 TXT      433 $0000 VBL.CLOCK.DOC
 TXT      615 $0000 SET.TIME.DOC
$

== the machine lists the same records, types and sizes as an independent reader of the archive (t=22.6 s)
$ cd /mnt/MAUX/OUT
$ nulib2 -v /mnt/MAUX/ARC/VBLSET.SHK
 BIN      119 $0359 VBL.CLOCK.INT
 BIN       64 $6000 VBL.CLOCK.SETUP
 BIN     7438 $6000 SET.TIME
 TXT      433 $0000 VBL.CLOCK.DOC
 TXT      615 $0000 SET.TIME.DOC
$

== nulib2 -x says nothing and the prompt is back (t=36.3 s)
$ nulib2 -x /mnt/MAUX/ARC/VBLSET.SHK
$

== ls (t=42.3 s)
$ nulib2 -x /mnt/MAUX/ARC/VBLSET.SHK
$ ls
SET.TIME         VBL.CLOCK.DOC    VBL.CLOCK.SETUP
SET.TIME.DOC     VBL.CLOCK.INT
$

== ls shows exactly the archive's files (t=42.3 s)
$ nulib2 -x /mnt/MAUX/ARC/VBLSET.SHK
$ ls
SET.TIME         VBL.CLOCK.DOC    VBL.CLOCK.SETUP
SET.TIME.DOC     VBL.CLOCK.INT
$

== cksum (t=59.9 s)
$ cksum SET.TIME SET.TIME.DOC
1778855797 7438 SET.TIME
1371311518 615 SET.TIME.DOC
$

== cksum of the two unpacked files equals the host's checksum of the archive's own bytes (t=59.9 s)
$ cksum SET.TIME SET.TIME.DOC
1778855797 7438 SET.TIME
1371311518 615 SET.TIME.DOC
$

== the documentation record comes out row for row (t=72.1 s)
$ more SET.TIME.DOC
Set.Time by Doug Reeder

Use the arrow keys to set the time and date to the present and then hit return.

Set.Time remembers the last time you set, provided you keep the program named SE
T.TIME and set the prefix to the directory it's in before you run it.

A very useful thing to do if you have SETUP.SYSTEM is to put Set.Time in your SE
TUPS directory.

Set.Time was written in Aardvaark Pascal.
Copyright 1990 by Doug Reeder
Free for non-commercial purposes. Corporate Licence: $5

Doug Reeder                BITNET: reeder@reed.BITNET
1718 Birch                 USENET: ...!tektronix!reed!reeder
Richland,WA 99352
$