SYNOPSIS

fmfconv [options] [infile [outfile [soundfile]]]

DESCRIPTION

fmfconv is a Fuse Movie File converter. It can read .fmf files produced by Fuse ZX Spectrum emulator and write audio files, video files or sequences of images in a variety of popular formats. It can also stream data to external tools through a pipe, so you can get virtually any possible format (see EXAMPLES).

fmfconv has built-in support for AIFF, AU and WAV sound formats, PPM and SCR image formats, AVI and YUV4MPEG2 video formats. Supports PNG and JPEG/MJPEG formats internally if libpng and libjpeg are available respectively.

OPTIONS

General options:

-h
--help

Give brief usage help, listing available options.

--info

Scan input file(s) and print information.

-i filename
--input filename

Input file.

-o filename
--output filename

Output file.

-y
--overwrite

Force overwrite of existing output file(s).

-g form
--progress form

Show progress, where `form' is one of `%', `bar', `frame' or `time'. frame and time are similar to bar and show movie seconds or frame number as well.

-q
--quiet

Decrease the verbosity level by one.

-v
--verbose

Increase the verbosity level by one.

-V
--version

Print the version number and exit.

Audio options:

--aifc

Force AIFF-C output if sound format is AIFF.

-m
--aiff

Save sound to Apple Computer audio (aiff/aiff-c) file.

-u
--au

Save sound to Sun Audio (au) file.

--mono

Convert sound to mono (by default sound is converted to stereo).

--raw-sound

Do not convert sound to 16-bit signed PCM and STEREO or MONO. This is an advanced option. If stereo/mono or audio encoding change through `fmf' file, your sound will be crappy.

-s filename
--sound filename

Output sound file.

--sound-only

Process only the sound from an `fmf' file.

-E rate
--srate rate

Resample audio to `rate' sampling rate where `rate' is `cd' for 44100 Hz or `dat' for 48000 Hz or a number (`cd' and `dat' set `stereo' as well).

-w
--wav

Save sound to Waveform Audio (wav) file.

Video/image options:

--avi

Save video as AVI format with built-in AVI encoder. If fmfconv supports jpeg files, encode video as M-JPEG and audio as S16_LE PCM. If output is not a file (stdout or redirected) then fmfconv encode video as uncompressed BGR24 DIB frames (see --avi-mjpeg and --avi-uncompr).

-f timing
--frate timing

Set output frame rate. `timing' is `pal', `ntsc', `movie' or a number with maximum 3 digit after decimal point, or a #/# (e.g.: -f 29.97 or -f 30000/1001).
For video output formats (AVI/MJPEG/YUV4MPEG2) fmfconv set frame rate to 25 fps (PAL timing). If you want to keep the original frame rate use `raw' timing.

-C cut
--out-cut cut

Leave out the comma delimited `cut' ranges e.g.: 100-200,300,500,1:11-2:22 cut the frames 100-200, 300, 500 and frames from 1 min 11 sec to 2 min 22 sec (in the given timing see: -f/--frate).

-P
--ppm

Save video as PPM screenshots.

-S
--scr

Save video as SCR screenshots.

-Y
--yuv

Save video as yuv4mpeg2.

--yuv-format frm

Set yuv4mpeg2 file frame format to `frm', where `frm' is one of `444', `422', `420j', `420m', `420' or `410'.

The following options are available when PNG files are supported:

--greyscale

Save greyscale images.

-G
--png

Save video frames as PNG screenshots.

--png-compress level

Set compression level from a range 0-9, or `none', `fast', `best'.

--progressive

Save progressive (interlaced) PNG files.

The following options are available when JPEG files are supported:

--avi-mjpeg

Force the use of M-JPEG AVI frames (lossy).

--avi-uncompr

Force the use of uncompressed BGR24 AVI frames. This format does not produce compression artifacts but the file size is bigger. It is a good choice if you want to process the video with an external tool.

--greyscale

Save greyscale images or convert video frames.

-J
--jpeg

Save video frames as JPEG screenshots.

--jpeg-fast

Use faster, less accurate integer method for DCT compression.

--jpeg-float

Use floating-point method for DCT compression.

--jpeg-optimize

Compute optimal Huffman coding tables for the image.

-Q
--jpeg-quality q

Set jpeg quality from a range 0-100.

--jpeg-smooth factor

Set jpeg smoothing factor from a range 0-100.

-M
--mjpeg

Save video as raw M-JPEG file (abbreviated JPEG stream).

--progressive

Save progressive (interlaced) JPEG files.

EXAMPLES

Some of the following examples use ffmpeg(1) as an external tool for doing the final conversion. In some distributions avconv(1) is available, which accepts the same parameters.

Convert FMF to AVI:

fmfconv input.fmf output.avi

Convert FMF to a mpeg video with quality equivalent to YouTube:

fmfconv input.fmf | ffmpeg -i - -vf scale=480:360 -r 25
        -codec:v h264 -codec:a aac -f mov -b:a 128000
        -b:v 600000 -pix_fmt yuv420p -strict -2 output.mov

Convert FMF to a DVD video format:

fmfconv input.fmf | ffmpeg -i - -aspect 4:3 -target pal-dvd
        output.vob

Convert FMF to SVCD video format:

fmfconv input.fmf | ffmpeg -i - -aspect 4:3 -target pal-svcd
        output.mpg

Convert FMF to iPod video format:

fmfconv input.fmf | ffmpeg -i - -vf scale=320:240 -r 30
        -codec:v h264 -codec:a aac -f ipod -ar 44100 -b:a 128000
        -b:v 256000 -pix_fmt yuv420p -strict -2 output.m4v

Convert FMF to animated GIF (25 fps) using ImageMagick:

fmfconv -f 25 input.fmf tmp.png convert -delay 4 -loop 0 -layers removeDups -layers Optimize
        tmp*.png output.gif

Extract audio (mono) from a FMF file:

fmfconv --sound-only --mono input.fmf output.wav

AUTHOR

Gergely Szasz.