mozplugger(7)PUBLIC FILES, TABLES, AND TROFF MACROS mozplugger(7)


     mozplugger - a streaming multimedia plugin for UNIX mozilla


     MozPlugger is a  Mozilla plugin which can show many types of
     multimedia   inside   your   Mozilla.  To  accomplish  this,
     MozPlugger uses external programs such  as  mplayer,  xanim,
     mtv, timidity and tracker.


     You can configure mozplugger by changing the  file  mozplug-
     gerrc  which  can  be located in any of the following direc-


     The format of mozpluggerrc is very simple. The general  lay-
     out  is to have one or more lines describing mime types fol-
     lowed by one or more lines describing commands used to  han-
     dle  those mime types. Lines beginning with # are considered
     comments and are ignored. Here is a simple example:

          video/mpeg; mpeg; Mpeg video
          video/quicktime; qt; Mpeg video
               : xanim +W$window -Zr +q +Ze +f $file

     Each line describing a mime type has three fields:

           mime type ; extensions ; description

     mime type
          The mime type is the standardized name for the  content
          type  you  want  MozPlugger to handle. This must be the
          same type as the web server claims the file to  be,  or
          MozPlugger  will  not be used for that file, regardless
          of the extension.

          This is a  comma  separated  list  of  extensions  that
          should  be  associated  with this particular mime type.
          The extensions are only used when a web server does not

                          Last change:                          1

mozplugger(7)PUBLIC FILES, TABLES, AND TROFF MACROS mozplugger(7)

          report  what  type of file it is, or when loading files
          directly from disk.

          This is the description that shows up in  about:plugins
          and in the application preferences section in Mozilla.

          Lines that describe what command to use for a mime type
          must begin with a whitespace and have two fields:

                flags :  command

          This is a comma-separated list  of  flags  which  tells
          mozplugger  how  to handle this particular application.
          See below for further details.

          This is a command which is sent to  /bin/sh  when  han-
          dling this mime type.


     When MozPlugger  is  called  from  your  browser,  it  looks
     through  the configuration file and tries to find a matching
     mime type.  For an application to be chosen it has  to  ful-
     fill  certain  criteria,  it has to exist, and it must match
     the flags given to mozplugger.

     When it does, it tries to figure out which command  to  use.
     First, it looks through all the commands for that particular
     mime type to see if it can find an application that has  the
     stream  flag.  If  it cannot find a streaming application it
     downloads the file and tries  again.  Note  that  MozPlugger
     will  check  the  first  word of the command and search your
     $PATH for  that  command.  If  that  command  is  not  found
     MozPlugger will go to the next line in your mozpluggerrc.


          This indicates that the command uses the $repeat  vari-

     loop This indicates that the application loops  forever.  If
          the <EMBED> tag used to start MozPlugger indicated that
          the file should not loop forever, the command  on  this
          line will not be used.

                          Last change:                          2

mozplugger(7)PUBLIC FILES, TABLES, AND TROFF MACROS mozplugger(7)

          This indicates that this application can take  an  url.
          In  this  case,  the variable $file contains the URL of
          the file to play and the browser does not download it.

          This flag tells MozPlugger to ignore the exit status of
          the application.

          This flag tells MozPlugger to redirect the  stdout  and
          stderr of the application to /dev/null.

          This will tell MozPlugger not to try to kill the appli-
          cation when leaving the page. This is normally used for
          programs which start in their own window and  can  play
          multiple files, such as xmms.

     swallow ( name )
          This is the only flag that takes an argument so far. It
          will  tell  mozplugger that the application will open a
          window with the specified name  and  that  this  window
          will then be moved to inside your browser.

     fill This keyword is used to maximize an swallowed window.

          This keyword is used to maximize  an  swallowed  window
          while keeping the width/height ratio constant.

          This flag is typically used with audio files to display
          a  controller  with  the  buttons  play, pause and stop
          while playing. It only works with EMBED tags.

     embed, noembed
          These flags can be used to define embed-only  or  full-
          window-only commands.

          In conjunction with the swallow keyword, this tells the
          plugin to swallow windows which are not visible yet.


     MozPlugger gives some variables to /bin/sh when starting the
     application, these variables are:

          This variable contains how many times the  file  should

                          Last change:                          3

mozplugger(7)PUBLIC FILES, TABLES, AND TROFF MACROS mozplugger(7)

          be played.  Applications which use this variable should
          also set the repeat flag.

          This is the X window Mozilla has given the plugin. This
          can  be  used  with  applications  such  as  MPlayer to
          display graphics inside the mozilla window.

          This is the horizontal resolution in pixels.

          This is the vertical resolution in pixels.

          This is the file to play.  If the application uses  the
          stream flag, this this variable contains the URL of the
          file to play.

          This variable contains the mime type of $file.

          All the parameters of the <EMBED> tags are made  avail-
          able  in  mozpluggerrc  through  environment variables.
          For example the parameter loop="1" in  an  <EMBED>  tag
          defines the variable VAR_loop=1.


     You    have    to    remove    ~/.netscape/plugin-list    or
     ~/.mozilla/pluginreg.dat  after  changing the configuration,
     or nothing will happen. This is a Netscape/Mozilla bug,  not
     a MozPlugger bug.

     Netscape 3.x will not play anything  for  <EMBED>  tags  for
     which height or width are zero. This too is a Netscape bug.


     Fredrik H|binette,
     Louis Bavoil,

                          Last change:                          4

Man(1) output converted with man2html