Repository files navigation

Tools to create, list and extract AtariATR disk images.

This program creates AtariATR disk images from a list of files givenin the command line, in the SpartaDOS / BW-DOS disk format.

Usage:

mkatr [options] output [+attributes] filenames

Options:

• -b Selects the next file in the command line as theboot file,the file will be loaded when the computer boots, and must bein the standard Atari binary file format.The bootloader for 128 bytes per sector needs 613 bytes, from $700 to$965, and the bootloader for 256 bytes per sector needs 848 bytes, from$700 to $A50, both can be relocated with the-B option.

• -x Output image with exact sector count for all available content.This will use non-standard sector counts, and return images with128 bytes per sector if the image is smaller than about 8MB.

• -s Specify the minimum size of the output image, in bytes. The imagewill be of this size or larger instead of the smaller possible.This allows creating images with available free space.Using this option with the-x option allows generating images ofspecific sizes (up to the sector size).

• -B Specify the page (high part of address) of the start of the bootloader.Use this option to load games or other software with a low loadingaddress that conflicts with the standard address of the bootloader. Asafe value is from page 6 instead of the default page 7, but page 4 or5 is also possible.

• -h Shows a brief help.

• -v Shows version information.

Also, in front of each file name you can optionally add a list of attributes tobe set for that file:

• +p Marks this file as protected (read-only).

• +h Hide file from directory. This only works in SpartaDOS-X.

• +a Marks the file as "archived". This only works in SpartaDOS-X.

To place files inside a sub-directory, simply add the directorybeforeall the files inside that directory.

The resulting image will be the smaller size that fits all the given files (orthe minimum specified with-s), from the following list (except when the-xoption is used):

This program list or extracts the contents of an AtariATR disk image.

The supported formats are:

• Atari DOS 1, single density.
• Atari DOS 2.0, single and double density.
• Atari DOS 2.5, enhanced density.
• MyDOS, up to 16MB images.
• SpartaDOS and BW-DOS, up to 16MB images.
• LiteDOS 2.x and LiteDOS-SE.
• BAS2BOOT images, extracts the BAS file inside.
• Howfen DOS images, extracting the raw BOOT images.
• K-file boot images, extracts the XEX file inside.

Usage:

lsatr [options] filenames.atr

Options:

• -a Shows the listing in the same format of native Atari tools,this is the file name separated by spaces to the file extension,followed by the size, date and time (if available), and eachsub-directory in a separate listing.Standard listing format shows the size, the date, time (if available)and the full path at the end.

• -l Show or extract all filenames in lowercase.

• -x Extract all files in the current directory.

• -X Extract all files in the directory given as argument to the option. Ifthe directory does not exists, it will be created first.

• -h Shows a brief help.

• -v Shows version information.

To create an image nameddisk1.atr with all the files in the "atari"directory:

mkatr disk1.atr atari/*

To create a bootable BW-DOS image with a hidden and protected DOS file insidea subdirectory and a protectedstartup.bat file outside:

mkatr bwdos.atr dos/ -b +ph dos/xbw130.dos +p startup.bat

To create an image with only one file that will be loaded at boot:

mkatr game.atr -b mygame.com

To list the files inside an image:

lsatr bwdos.atr

To extract all files from the image to a folderout:

lsatr -X out/ bwdos.atr

Compile withmake and copy the resultingmkatr andlsatr programs to yourbin folder.