====== QLTools ======

===== Introduction =====

Qltools is a utility that allows you to access files stored on a QL Floppy Disc, or an image of a floppy, whether you are running on Linux (or other Unices) or Windows.

Qltools was originally written by [[Giuseppe Zanetti]] and the following list of people have had a hand in it, somewhere or other:

  * [[Valenti Omar]]
  * [[Richard Zidlicky]]
  * [[Jonathan Hudson]]
  * [[Graeme Gregory]]
  * [[Norman Dunbar]]

===== Downloading Binaries =====
For now, binaries are only available from my own ([[Norman Dunbar]]) Github account at https://github.com/NormanDunbar/qltools/releases where you will always be able to find the latest version.

You may also like to check https://github.com/SinclairQL/qltools/releases too, as that is the official site for qltools.

===== Description =====

QLTools allows QL floppy disc images, or actual floppy discs, to be created, formatted, writted, read, or modified on a QL or on a Windows or Linux computer. DS/DD 720 kb, DS/HD 1.44 mb and DS/ED 3.2 mb floppies are catered for.

If you run qltools without any options, it will display the following, potentially helpful, screen of information:

<code>
qltools

Error: too few parameters

Usage: qltools device -[options] [filename]

Options:

    -d         List directory          -s         List short directory
    -i         List disk info          -m         List disk map
    -c         List conversion table   -l         List files on write

    -w <files> Write files (query)     -W <files> (Over)write files
    -r <name>  Remove file <name>      -n <flle>  Copy <file> to stdout

    -uN        ASCII dump cluster N    -UN        Binary dump
    -M <name>  Make level 2 directory <name>
    -x <name> <size> Make <name> executable with dataspace <size>
    -t         Do not translate '.' to '_' in filenames

    -fxx <name> Format as xx=hd|dd|ed disk with label <name>

QLTOOLS for Linux/win32 (version 2.15.5, Jan 31 2019)

'Device' is either a file with the image of a QL format disk
or a floppy drive with a SMS/QDOS disk inserted in it (e.g. diskimage)

by Giuseppe Zanetti,Valenti Omar,Richard Zidlicky, Jonathan Hudson
& Norman Dunbar
</code>

This is a very useful utility. The user manual, in PDF format, can be downloaded from:

  * [[https://github.com/NormanDunbar/qltools/blob/master/docs/qltools.pdf|Development version]]; or
  * [[https://github.com/SinclairQL/qltools/blob/master/docs/qltools.pdf| Stable version]].