Quick Commander 4.01
====================
A commander for the ZX Spectrum: TR-DOS disks, the esxDOS SD card and the tape
in two panels.
About
-----
Quick Commander (QC) shows what is on your floppy disks, your SD card and your
tape, and lets you run, view, copy, pack and tidy it up with a few keys or the
mouse. It started in 1998 as a shell for TR-DOS floppies and still is one at
heart: it programs the WD1793 disk controller directly, for speed, and runs on
any Spectrum or clone from 48K to 1024K.
Version 4.00 was the biggest step in QC's history. It works under esxDOS on a
DivMMC or a DivIDE too: the SD card's folders, its TRD, SCL, TAP and TZX images
and esxDOS's tape are media to QC, as the floppy drives are, and files are
copied between any of them. QC has become a bridge between TR-DOS floppies, the
SD card and the tape. Version 4.01 adds esxDOS 0.9.0 and its long file names.
What's new in 4.01
------------------
- esxDOS 0.9.0: files and folders with long names (LFN=1, as in its kit) are
viewed, run, put in drives and the tape, copied, erased, renamed and entered
by their whole names; the panel shows a long name's first 7 characters and ~.
Quick Setup lists, mounts and opens them too. With esxDOS 0.8.9 (and 0.9.0
with LFN=0) all works as before.
- ".." is shown in the SD card's folders made on a Mac.
- Fixes: the Gluk clock no longer turns on Pentagon 1024's 7 MHz turbo; Break
(Caps Shift+Space) stops disk reads and writes, so paging a text with Space
no longer stops reading the next part of a file; Caps Shift+E with the card's
panel shown alone; the SD button after a reset with the ROM set; 48K going
from the tape to the SD card's panel.
What's new in 4.00
------------------
- Two panels: the input and the output disk side by side; a file can be dragged
to the other panel with the mouse.
- A panel of its own for the SD card under esxDOS: folders; TRD, SCL, TAP and
TZX images opened as folders, with nothing mounted; games and programs run as
from the NMI browser.
- Copying between any media: a drive, an SD card's folder, a TRD on the card, a
TAP and the tape, any way round; names and types are converted on their own.
- The tape as a fourth medium: a TAP becomes esxDOS's tape, its programs run by
Enter, and what they SAVE goes into the same TAP.
- Files of any length: long files on TR-DOS disks are groups of parts, as Hrip
and RAR write them, copied, viewed, packed and unpacked whole; texts and hex
dumps bigger than the memory scroll to their very end.
- The .qc command starts QC from esxDOS's BASIC.
- A snapshot and a tape run QC with all of its overlays and nothing to
install.
The full list is in the history of changes (see "Documentation").
Features
--------
- All the tools for four drives: copying, erasing, renaming and merging files,
marking them by a mask, renaming disks, squeezing deleted files out of a disk
(Move disk); disks of more than 160 tracks.
- The main menu runs a disk's programs by Enter, or by Caps shift and their
letter, as a boot does; the file menu works with all of its files.
- Viewers: texts in cp866 or UTF-8 (told apart on their own, with colours and
CR, CRLF or LF line ends), hex dumps, pictures (.bsc screens with their
border), fonts, sprites, ALASM sources; a ProTracker 2 and 3 player,
TurboSound too.
- Hrust 1 and 2 and ZX0 files unpacked on the fly; a ZX0 packer.
- Under esxDOS: the SD card's panel, its images and the tape; QC can be esxDOS's
default boot (TRDBOOT.BIN) in place of TR-DOS Navigator. Tested with esxDOS
0.8.9.
- 48K to 1024K of every standard: Pentagon, Scorpion, KAY, Profi, ATM,
ZX-Evolution and others.
- A Kempston mouse, the CMOS clock, Russian file names, 24 kinds of files in
colours of your choice.
- QC can live in the Shadow RAM, or in the ROM in place of BASIC 128.
Requirements
------------
- A ZX Spectrum or a clone with 48K or more. QC is at its best on 128K and more:
on 48K it has the main menu alone, to run programs (under esxDOS the SD card's
panel and the tape's main menu too).
- TR-DOS 5.03 or later with a WD1793 controller (Beta 128 and its clones), or
esxDOS on a DivMMC or a DivIDE. QC doesn't work with TR-DOS 5.01 or with a
hard disk.
Quick start
-----------
In an emulator
Open QC_4_01.sna, a 128K snapshot (put any disk image in drive A), or the disk
QC_4_01.TRD (it boots), or load the tape QC_4_01.tap with LOAD "".
On a machine with a disk drive
Write QC_4_01.TRD to a floppy disk and boot it (RUN in TR-DOS).
Under esxDOS (DivMMC, DivIDE)
To try QC, copy QC_4_01.tap or QC_4_01.sna to the SD card and press Enter on
it in the NMI browser. Nothing is installed.
To make QC the boot of every disk image, copy QC_4_01.TRD to the card, press
Enter on it in the NMI browser, and in QC's main menu run "QS 4.01" (Quick
Setup). There choose T and press Enter: Quick Setup puts QC in /SYS and the
.qc command in /BIN, and keeps TR-DOS Navigator as /SYS/TRDBOOT.NAV. From then
on Enter on any image with no boot of its own starts QC, and .qc starts it
from BASIC.
To start QC at power-on and at every reset (esxDOS 0.8.6 or later), choose A
in Quick Setup after T: it writes /SYS/AUTOBOOT.BAS and sets AutoBoot=3 in
/SYS/CONFIG/ESXDOS.CFG; A again turns it off. Hold Caps shift at a reset to
get BASIC. The NMI browser stays as it was: this adds to it.
Or by hand: rename /SYS/TRDBOOT.BIN (TR-DOS Navigator), then copy the folders
SYS and BIN from the kit's esxdos folder to the card's root. SYS/AUTOBOOT.BAS
there replaces your own one, if you have it; it starts QC only once AutoBoot=3
is set in /SYS/CONFIG/ESXDOS.CFG.
First keys
H or ? the keys of the current mode
Enter or 0 run the file under the cursor
Space the main menu or the file menu (all the files)
1-4, S, T a drive, the SD card, the tape
Extend mode the other panel (Caps shift + Symbol shift)
The guide tells the rest.
What's in the kit
-----------------
QC_4_01.TRD the disk: QC, its overlays (.qco), Quick Setup and the texts
QC_4_01.sna the snapshot: QC with all of its overlays, for emulators and
esxDOS
QC_4_01.tap the tape: the same, loaded by LOAD ""
readme.txt this file
rom/ QC_4_01.rom, QC for the ROM in place of BASIC 128, and
QC_4_01_ovr.rom, its overlays for Pentagon 1024's ROM set (see the
guide)
esxdos/ for the SD card's root: SYS/TRDBOOT.BIN (QC as esxDOS's boot),
SYS/TRDBOOT.OVR (its overlays), SYS/AUTOBOOT.BAS (QC at a reset,
with AutoBoot=3) and BIN/QC (the .qc command)
docs/ the guides, the texts for developers and the histories of changes,
in UTF-8
Documentation
-------------
docs/QC_4_01_guide_eng.txt the guide: every mode, key and setting
docs/QC_4_01_technical_eng.txt for developers: QC's files, memory and settings,
how a program goes back to QC
docs/QC_4_01_history_eng.txt the history of changes
The same in Russian: the files ending in _rus. The disk has them too, in cp866
(guide_en, tech_en, hist_en and the _ru ones), to read in QC's viewer.
Author
------
Andrey Bogdanovich aka Spectre/Optical Brothers
Site: https://www.zxby.org/ob/quick.html
E-mail: spectre@zxby.org
Wishes and bug reports are welcome. The thanks are at the end of the guide.
License
-------
Quick Commander is freeware. You may use it, copy it and share the kit or any of
its files, for free or in a paid collection: on sites, in archives, with
emulators and on disks. Modified versions (translations, patches) may be shared
too, if they say they are modified and name QC's author, Andrey Bogdanovich aka
Spectre.
It comes with no warranty: keep copies of the disks and cards you work on.
The ZX0 depacker in QC is (c) 2021 Einar Saukas (with Urusergi and introspec),
under the BSD 3-Clause licence; its text is in the texts for developers.