1fmfconv(1)                         Emulators                        fmfconv(1)
2
3
4

NAME

6       fmfconv — Fuse Movie File converter
7

SYNOPSIS

9       fmfconv [options] [infile [outfile [soundfile]]]
10

DESCRIPTION

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
14       sequences 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

OPTIONS

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
162              external 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

EXAMPLES

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

BUGS

253       None known.
254

SEE ALSO

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

AUTHOR

265       Gergely Szasz.
266
267
268
269Version 1.4.2                   3rd June, 2018                      fmfconv(1)
Impressum