Ubuntu Manpage: fmfconv — Fuse Movie File converter

Provided by: fuse-emulator-utils_1.4.3-1build1_amd64

NAME

       fmfconv — Fuse Movie File converter

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 mp4 -b:a 128k
                      -b:v 600k -pix_fmt yuv420p -strict -2 output.mp4

       Convert FMF to compact lossless 720p:

              fmfconv input.fmf | ffmpeg -i - -vf palettegen palette.png
              fmfconv --raw-sound input.fmf | ffmpeg -i - -i palette.png
                      -filter_complex
                      "scale=960:720:flags=neighbor [x]; [x][1:v] paletteuse"
                      -c:a flac -c:v zmbv -compression_level:a 12 output.mkv

       Convert FMF to compact lossless 1080p:

              fmfconv input.fmf | ffmpeg -i - -vf palettegen palette.png
              fmfconv --raw-sound input.fmf | ffmpeg -i - -i palette.png
                      -filter_complex
                      "crop=288:216,scale=1440:1080:flags=neighbor
                            [x]; [x][1:v] paletteuse"
                      -c:a flac -c:v zmbv -compression_level:a 12 output.mkv

       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 128k
                      -b:v 256k -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

BUGS

       None known.

AUTHOR

       Gergely Szasz.