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.
