summaryrefslogtreecommitdiffstatshomepage
path: root/docs/source/tools/floptool.rst
blob: bf71c296aee5ef62850c09ae0226927ae388bbf3 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
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