mame/docs/source/tools/floptool.rst

206 lines
3.3 KiB
ReStructuredText

Floptool - *A generic floppy image manipulation tool for MAME*
==============================================================
Floptool is a tool for the maintenance and manipulation of floppy images that MAME users need to deal with. MAME directly supports .WAV audio formatted images, but many of the existing images out there may come in forms such as .TAP for Commodore 64 tapes, .CAS for Tandy Color Computer tapes, and so forth. Castool will convert these other formats to .WAV for use in MAME.
Floptool is part of the MAME project. It shares large portions of code with MAME, and its existence would not be if it were not for MAME. As such, the distribution terms are the same as MAME. Please read the MAME license thoroughly.
Using Floptool
==============
Floptool is a command line program that contains a simple set of instructions. Commands are invoked in a manner along the lines of this:
**floptool identify <inputfile> [<inputfile> ...]**
**floptool convert [input_format|auto] output_format <inputfile> <outputile>**
* **<format>** is the format of the image
* **<input_format>** is the format of the inputfile, use auto if not known
* **<output_format>** is the format of the converted file
* **<inputfile>** is the filename of the image you're identifying/converting from
* **<outputfile>** is the filename of the converted file
Example usage:
floptool convert coco zaxxon.cas zaxxon.wav
floptool convert cbm arkanoid.tap arkanoid.wav
floptool convert ddp mybasicprogram.ddp mybasicprogram.wav
Floptool Formats
================
These are the formats supported by Floptool for conversion to other formats.
**MFI**
MAME floppy image
File extension: mfi
**DFI**
DiscFerret flux dump format
File extensions: dfi
**IPF**
SPS floppy disk image
File extensions: ipf
**MFM**
HxC Floppy Emulator floppy disk image
File extensions: mfm
**ADF**
Amiga ADF floppy disk image
File extensions: adf
**ST**
Atari ST floppy disk image
File extensions: st
**MSA**
Atari MSA floppy disk image
File extensions: msa
**PASTI**
Atari PASTI floppy disk image
File extensions: stx
**DSK**
CPC DSK format
File extensions: dsk
**D88**
D88 disk image
File extensions: d77, d88, 1dd
**IMD**
IMD disk image
File extensions: imd
**TD0**
Teledisk disk image
File extensions: td0
**CQM**
CopyQM disk image
File extensions: cqm, cqi, dsk
**PC**
PC floppy disk image
File extensions: dsk, ima, img, ufi, 360
**NASLITE**
NASLite disk image
File extensions: img
**DC42**
DiskCopy 4.2 image
File extensions: dc42
**A2_16SECT**
Apple II 16-sector disk image
File extensions: dsk, do, po
**A2_RWTS18**
Apple II RWTS18-type image
File extensions: rti
**A2_EDD**
Apple II EDD image
File extensions: edd
**ATOM**
Acorn Atom disk image
File extensions: 40t, dsk
**SSD**
Acorn SSD disk image
File extensions: ssd, bbc, img
**DSD**
Acorn DSD disk image
File extensions: dsd
**DOS**
Acorn DOS disk image
File extensions: img
**ADFS_O**
Acorn ADFS (OldMap) disk image
File extensions: adf, ads, adm, adl
**ADFS_N**
Acorn ADFS (NewMap) disk image
File extensions: adf
**ORIC_DSK**
Oric disk image
File extensions: dsk
**APPLIX**
Applix disk image
File extensions: raw
**HPI**
HP9845A floppy disk image
File extensions: hpi