1fmfconv(1) Emulators fmfconv(1)
2
3
4
6 fmfconv — Fuse Movie File converter
7
9 fmfconv [options] [infile [outfile [soundfile]]]
10
12 fmfconv is a Fuse Movie File converter. It can read .fmf files produced
13 by Fuse ZX Spectrum emulator and write audio files, video files or se‐
14 quences of images in a variety of popular formats. It can also stream
15 data to external tools through a pipe, so you can get virtually any
16 possible format (see EXAMPLES).
17
18 fmfconv has built-in support for AIFF, AU and WAV sound formats, PPM
19 and SCR image formats, AVI and YUV4MPEG2 video formats. Supports PNG
20 and JPEG/MJPEG formats internally if libpng and libjpeg are available
21 respectively.
22
24 General options:
25 -h
26 --help
27 Give brief usage help, listing available options.
28
29 --info
30 Scan input file(s) and print information.
31
32 -i filename
33 --input filename
34 Input file.
35
36 -o filename
37 --output filename
38 Output file.
39
40 -y
41 --overwrite
42 Force overwrite of existing output file(s).
43
44 -g form
45 --progress form
46 Show progress, where `form' is one of `%', `bar', `frame' or
47 `time'. frame and time are similar to bar and show movie seconds
48 or frame number as well.
49
50 -q
51 --quiet
52 Decrease the verbosity level by one.
53
54 -v
55 --verbose
56 Increase the verbosity level by one.
57
58 -V
59 --version
60 Print the version number and exit.
61
62 Audio options:
63 --aifc
64 Force AIFF-C output if sound format is AIFF.
65
66 -m
67 --aiff
68 Save sound to Apple Computer audio (aiff/aiff-c) file.
69
70 -u
71 --au
72 Save sound to Sun Audio (au) file.
73
74 --mono
75 Convert sound to mono (by default sound is converted to stereo).
76
77 --raw-sound
78 Do not convert sound to 16-bit signed PCM and STEREO or MONO.
79 This is an advanced option. If stereo/mono or audio encoding
80 change through `fmf' file, your sound will be crappy.
81
82 -s filename
83 --sound filename
84 Output sound file.
85
86 --sound-only
87 Process only the sound from an `fmf' file.
88
89 -E rate
90 --srate rate
91 Resample audio to `rate' sampling rate where `rate' is `cd' for
92 44100 Hz or `dat' for 48000 Hz or a number (`cd' and `dat' set
93 `stereo' as well).
94
95 -w
96 --wav
97 Save sound to Waveform Audio (wav) file.
98
99 Video/image options:
100 --avi
101 Save video as AVI format with built-in AVI encoder. If fmfconv
102 supports jpeg files, encode video as M-JPEG and audio as S16_LE
103 PCM. If output is not a file (stdout or redirected) then fmfconv
104 encode video as uncompressed BGR24 DIB frames (see --avi-mjpeg
105 and --avi-uncompr).
106
107 -f timing
108 --frate timing
109 Set output frame rate. `timing' is `pal', `ntsc', `movie' or a
110 number with maximum 3 digit after decimal point, or a #/# (e.g.:
111 -f 29.97 or -f 30000/1001).
112 For video output formats (AVI/MJPEG/YUV4MPEG2) fmfconv set frame
113 rate to 25 fps (PAL timing). If you want to keep the original
114 frame rate use `raw' timing.
115
116 -C cut
117 --out-cut cut
118 Leave out the comma delimited `cut' ranges e.g.:
119 100-200,300,500,1:11-2:22 cut the frames 100–200, 300, 500 and
120 frames from 1 min 11 sec to 2 min 22 sec (in the given timing
121 see: -f/--frate).
122
123 -P
124 --ppm
125 Save video as PPM screenshots.
126
127 -S
128 --scr
129 Save video as SCR screenshots.
130
131 -Y
132 --yuv
133 Save video as yuv4mpeg2.
134
135 --yuv-format frm
136 Set yuv4mpeg2 file frame format to `frm', where `frm' is one of
137 `444', `422', `420j', `420m', `420' or `410'.
138
139 The following options are available when PNG files are supported:
140 --greyscale
141 Save greyscale images.
142
143 -G
144 --png
145 Save video frames as PNG screenshots.
146
147 --png-compress level
148 Set compression level from a range 0–9, or `none', `fast',
149 `best'.
150
151 --progressive
152 Save progressive (interlaced) PNG files.
153
154 The following options are available when JPEG files are supported:
155 --avi-mjpeg
156 Force the use of M-JPEG AVI frames (lossy).
157
158 --avi-uncompr
159 Force the use of uncompressed BGR24 AVI frames. This format does
160 not produce compression artifacts but the file size is bigger.
161 It is a good choice if you want to process the video with an ex‐
162 ternal tool.
163
164 --greyscale
165 Save greyscale images or convert video frames.
166
167 -J
168 --jpeg
169 Save video frames as JPEG screenshots.
170
171 --jpeg-fast
172 Use faster, less accurate integer method for DCT compression.
173
174 --jpeg-float
175 Use floating-point method for DCT compression.
176
177 --jpeg-optimize
178 Compute optimal Huffman coding tables for the image.
179
180 -Q
181 --jpeg-quality q
182 Set jpeg quality from a range 0–100.
183
184 --jpeg-smooth factor
185 Set jpeg smoothing factor from a range 0–100.
186
187 -M
188 --mjpeg
189 Save video as raw M-JPEG file (abbreviated JPEG stream).
190
191 --progressive
192 Save progressive (interlaced) JPEG files.
193
195 Some of the following examples use ffmpeg(1) as an external tool for
196 doing the final conversion. In some distributions avconv(1) is avail‐
197 able, which accepts the same parameters.
198
199 Convert FMF to AVI:
200
201 fmfconv input.fmf output.avi
202
203 Convert FMF to a mpeg video with quality equivalent to YouTube:
204
205 fmfconv input.fmf | ffmpeg -i - -vf scale=480:360 -r 25
206 -codec:v h264 -codec:a aac -f mp4 -b:a 128k
207 -b:v 600k -pix_fmt yuv420p -strict -2 output.mp4
208
209 Convert FMF to compact lossless 720p:
210
211 fmfconv input.fmf | ffmpeg -i - -vf palettegen palette.png
212 fmfconv --raw-sound input.fmf | ffmpeg -i - -i palette.png
213 -filter_complex
214 "scale=960:720:flags=neighbor [x]; [x][1:v] paletteuse"
215 -c:a flac -c:v zmbv -compression_level:a 12 output.mkv
216
217 Convert FMF to compact lossless 1080p:
218
219 fmfconv input.fmf | ffmpeg -i - -vf palettegen palette.png
220 fmfconv --raw-sound input.fmf | ffmpeg -i - -i palette.png
221 -filter_complex
222 "crop=288:216,scale=1440:1080:flags=neighbor
223 [x]; [x][1:v] paletteuse"
224 -c:a flac -c:v zmbv -compression_level:a 12 output.mkv
225
226 Convert FMF to a DVD video format:
227
228 fmfconv input.fmf | ffmpeg -i - -aspect 4:3 -target pal-dvd
229 output.vob
230
231 Convert FMF to SVCD video format:
232
233 fmfconv input.fmf | ffmpeg -i - -aspect 4:3 -target pal-svcd
234 output.mpg
235
236 Convert FMF to iPod video format:
237
238 fmfconv input.fmf | ffmpeg -i - -vf scale=320:240 -r 30
239 -codec:v h264 -codec:a aac -f ipod -ar 44100 -b:a 128k
240 -b:v 256k -pix_fmt yuv420p -strict -2 output.m4v
241
242 Convert FMF to animated GIF (25 fps) using ImageMagick:
243
244 fmfconv -f 25 input.fmf tmp.png
245 convert -delay 4 -loop 0 -layers removeDups -layers Optimize
246 tmp*.png output.gif
247
248 Extract audio (mono) from a FMF file:
249
250 fmfconv --sound-only --mono input.fmf output.wav
251
253 None known.
254
256 avconv(1), ffmpeg(1), fuse(1), fuse-utils(1), imagemagick(1).
257
258 The Fuse Movie File specification, at
259 http://sourceforge.net/p/fuse-emulator/wiki/FMF%20File%20Format/.
260
261 The comp.sys.sinclair Spectrum FAQ, at
262 http://www.worldofspectrum.org/faq/index.html.
263
265 Gergely Szasz.
266
267
268
269Version 1.4.3 1st July, 2018 fmfconv(1)