summaryrefslogtreecommitdiffstatshomepage
path: root/docs/source/tools/castool.rst
blob: a84742f96e86276f2bc9f0d2f5a46bcfa7d6b692 (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
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
Castool - *A generic casette image manipulation tool for MAME*
==============================================================



Castool is a tool for the maintenance and manipulation of cassette 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.

Castool 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 Castool
=============

Castool is a command line program that contains a simple set of instructions. Commands are invoked in a manner along the lines of this:

	**castool convert <format> <inputfile> <outputfile>**

* **<format>** is the format of the image
* **<inputfile>** is the filename of the image you're converting from
* **<outputfile>** is the filename of the output WAV file

Example usage:
	castool convert coco zaxxon.cas zaxxon.wav

	castool convert cbm arkanoid.tap arkanoid.wav

	castool convert ddp mybasicprogram.ddp mybasicprogram.wav




Castool Formats
===============

These are the formats supported by Castool for conversion to .WAV files.

**A26**

	Atari 2600 SuperCharger image

	File extension: a26

**APF**

	APF Imagination Machine

	File extensions: cas, cpf, apt

**ATOM**

	Acorn Atom

	File extensions: tap, csw, uef

**BBC**

	Acorn BBC & Electron

	File extensions: csw, uef

**CBM**

	Commodore 8-bit series

	File extensions: tap

**CDT**

	Amstrad CPC

	File extensions: cdt

**CGENIE**

	EACA Colour Genie

	File extensions: cas

**COCO**

	Tandy Radio Shack Color Computer

	File extensions: cas

**CSW**

	Compressed Square Wave

	File extensions: csw

**DDP**

	Coleco ADAM

	File extensions: ddp

**FM7**

	Fujitsu FM-7

	File extensions: t77

**FMSX**

	MSX

	File extensions: tap, cas

**GTP**

	Elektronika inzenjering Galaksija

	File extensions: gtp

**HECTOR**

	Micronique Hector & Interact Family Computer

	File extensions: k7, cin, for

**JUPITER**

	Jupiter Cantab Jupiter Ace

	File extensions: tap

**KC85**

	VEB Mikroelektronik KC 85

	File extensions: kcc, kcb, tap, 853, 854, 855, tp2, kcm, sss

**KIM1**

	MOS KIM-1

	File extensions: kim, kim1

**LVIV**

	PK-01 Lviv

	File extensions: lvt, lvr, lv0, lv1, lv2, lv3

**MO5**

	Thomson MO-series

	File extensions: k5, k7

**MZ**

	Sharp MZ-700

	File extensions: m12, mzf, mzt

**ORAO**

	PEL Varazdin Orao

	File extensions: tap

**ORIC**

	Tangerine Oric

	File extensions: tap

**PC6001**

	NEC PC-6001

	File extensions: cas

**PHC25**

	Sanyo PHC-25

	File extensions: phc

**PMD85**

	Tesla PMD-85

	File extensions: pmd, tap, ptp

**PRIMO**

	Microkey Primo

	File extensions: ptp

**RKU**

	UT-88

	File extensions: rku

**RK8**

	Mikro-80

	File extensions: rk8

**RKS**

	Specialist

	File extensions: rks

**RKO**

	Orion

	File extensions: rko

**RKR**

	Radio-86RK

	File extensions: rk, rkr, gam, g16, pki

**RKA**

	Zavod BRA Apogee BK-01

	File extensions: rka

**RKM**

	Mikrosha

	File extensions: rkm

**RKP**

	SAM SKB VM Partner-01.01

	File extensions: rkp

**SC3000**

	Sega SC-3000

	File extensions: bit

**SOL20**

	PTC SOL-20

	File extensions: svt

**SORCERER**

	Exidy Sorcerer

	File extensions: tape

**SORDM5**

	Sord M5

	File extensions: cas

**SPC1000**

	Samsung SPC-1000

	File extensions: tap, cas

**SVI**

	Spectravideo SVI-318 & SVI-328

	File extensions: cas

**TO7**

	Thomson TO-series

	File extensions: k7

**TRS8012**

	TRS-80 Level 2

	File extensions: cas

**TVC64**

	Videoton TVC 64

	File extensions: cas

**TZX**

	Sinclair ZX Spectrum

	File extensions: tzx, tap, blk

**VG5K**

	Philips VG 5000

	File extensions: k7

**VTECH1**

	Video Technology Laser 110-310

	File extensions: cas

**VTECH2**

	Video Technology Laser 350-700

	File extensions: cas

**X07**

	Canon X-07

	File extensions: k7, lst, cas

**X1**

	Sharp X1

	File extensions: tap

**ZX80_O**

	Sinclair ZX80

	File extensions: o, 80

**ZX81_P**

	Sinclair ZX81

	File extensions: p, 81