DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

mozplugger(7)




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


NAME

     mozplugger - a streaming multimedia plugin for UNIX mozilla


DESCRIPTION

     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.


CONFIGURE FILE

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

          $HOME/.netscape/
          $HOME/.opera/
          $MOZILLA_HOME/
          $OPERA_HOME/
          /usr/local/netscape/mozpluggerrc
          /etc/mozpluggerrc
          /usr/etc/mozpluggerrc
          /usr/local/etc/mozpluggerrc

     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.

     extensions
          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.

     description
          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

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

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


FINDING THE RIGHT COMMAND

     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.


FLAGS

     repeat
          This indicates that the command uses the $repeat  vari-
          able.

     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)

     stream
          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.

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

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

     nokill
          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.

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

     controls
          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.

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


VARIABLES

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

     $repeats
          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.

     $window
          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.

     $width
          This is the horizontal resolution in pixels.

     $height
          This is the vertical resolution in pixels.

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

     $mimetype
          This variable contains the mime type of $file.

     $VAR_<parameter_name>
          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.


BUGS

     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.


AUTHORS

     Fredrik H|binette, hubbe@hubbe.net
     Louis Bavoil, louis@bavoil.net

                          Last change:                          4


Man(1) output converted with man2html