NAME

       aviplay - QT-based movie player

SYNOPSIS

       aviplay [options] [ files | URLs ]

DESCRIPTION

       aviplay  is  a  QT-based player for various avi, asf, mpeg4 movie files.  Avifile project creates library
       that allows programs to read and write compressed AVI/ASF files (Indeo Video, DivX :-), etc.)  under Unix
       OS. (De)compression is performed with various plugins (included Win32 DLLs for x86_32 OS) if native codec
       is not available.  Win32 libraries have to be downloaded separately. Primarily the ffmpeg project is used
       for  codecs  and  also for stream parsing. Over the time it's possible the project will mostly blend into
       ffmpeg.

FEATURES

       * low CPU usage (movies playable even P200MMX)

       * smooth video (using threads and frame precaching)

       * supports streamed .asf files

       * audio resampling suppport

       * modular design

OPTIONS

       -h --help Show help message

       -c --codec [help]
              Set codec options (use help to see options for this parameter)

       -s --size <width:height>
              Start playing movie at dimensions X * Y.

       -f --fullscreen
              Start playing movie in fullscreen.

       -f --maximize
              Start playing movie in maximized mode (i.e. preserve current resolution).

       --seek <position>
              Seek to given position in movie.

       -sub --subtitle <filename>
              Use give file as the source for subtitles.

       -subcp --subtitle_codepage <codepage>
              Select codepage for subtitles. They are internaly encoded into UTF-8.  See iconv(3) for  available
              codepages.  Codepage  "default"  means  current  default encoding in system. Example of codepages:
              CP1250, ISO8859-2, default.

       -subfont --subtitle_font <fontname>
              Select font for subtitles. At this moment only X11 fonts  are  supported  (either  in  traditional
              "-misc-*" or TTF notation)

       -ac --audio-codec <codecname>
              Prefered  codec  to  be  used  for  movie  audio decoding.  Use with "help" to see available audio
              codecs.

       -vc --video-codec <codecname>
              Prefered codec to be used for movie video decoding.   Use  with  "help"  to  see  available  video
              codecs.

       --rc   Enables remote control (stdin|stdout).

SHELL variables:

       WIN32_PATH  -  can  be  used  to  override  library path /usr/lib/win32 which holds MS Windows binary dll
       codecs.

       AVIPLUGIN_PATH - can be used to override library path /usr/lib/avifile which holds avifile plugins.

       AVIPLAY_MUTE_AUDIO - if set shows just video track

       AVIPLAY_MUTE_VIDEO - if set plays just audio track

       AVIPLAY_NOSYNC - do not synchronize audio and video track

       HTTP_PROXY

       WRITE_ASF - write asf file received over the network to file (/tmp/*.asf)

NOTE

       Press the About button in aviplay's GUI for more details about the usage and configuation.

       Aviplay automaticaly searches for subtitle file with the same name as the original ".avi" file  but  with
       .sub, .SUB, .srt, .SRT, .txt, .TXT, .smi, .SMI suffix.

       For  Debian  users:  After  the discussion with the autor I have came to the conclusion that GSM codec is
       legaly distributed under GPL terms since this piece of code was donated to the project  by  the  original
       author which was using it in the non-GPL project xanim.

SEE ALSO

       http://avifile.sourceforge.net for the original source and main CVS archive for binary codecs.

       http://mplayerhq.hu for mplayer - an excelent player with more options and supported formats

AUTHORS

       Original author: Eugene Kuznetsov <divx@euro.ru>

       Current developer: Zdenek Kabelac <kabi@users.sourceforge.net>