fmfconv

fmfconv(1)                         Emulators                        fmfconv(1)



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.

SEE ALSO
       avconv(1), ffmpeg(1), fuse(1), fuse-utils(1), imagemagick(1).

       The Fuse Movie File specification, at
       http://sourceforge.net/p/fuse-emulator/wiki/FMF%20File%20Format/.

       The comp.sys.sinclair Spectrum FAQ, at
       http://www.worldofspectrum.org/faq/index.html.

AUTHOR
       Gergely Szasz.



Version 1.4.3                   1st July, 2018                      fmfconv(1)