<HTML
><HEAD
><TITLE
>Network Applets</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
REL="HOME"
TITLE="GNOME User's Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNOME Applets"
HREF="gnome-applets.html"><LINK
REL="PREVIOUS"
TITLE="Multimedia Applets"
HREF="multimedia-applets.html"><LINK
REL="NEXT"
TITLE="Utility Applets"
HREF="utility-applets.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>GNOME User's Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="multimedia-applets.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>GNOME Applets</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="utility-applets.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="NETWORK-APPLETS"
>Network Applets</A
></H1
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="APPLETS-CORE-MAILCHECK"
>The Mail Check Applet</A
></H2
><P
>    The <TT
CLASS="APPLICATION"
>mailcheck applet</TT
> is an applet which
    sits in your panel and tells you when you have new email. To add 
    this applet to the panel, right-click on the panel and choose
    <B
CLASS="GUIMENU"
>Add applet</B
>-&gt;<B
CLASS="GUISUBMENU"
>Network</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Mailcheck</B
>
  </P
><DIV
CLASS="FIGURE"
><A
NAME="MAILCHECK-APPLETS-CORE-FIG"
></A
><P
><IMG
SRC="./figs/mailcheck-applet.png"></P
><P
><B
>Figure 48. Mail Check Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="MAILCHECK-USAGE"
>Usage</A
></H3
><P
>      You don't need to do anything in particular to run this applet.
      Providing it is looking in the right place for your email, it
      will run itself quite happily. The following options, however,
      are available:
    </P
><P
></P
><UL
><LI
><P
>        Clicking <SPAN
CLASS="MOUSEBUTTON"
>mouse button 1</SPAN
> does nothing
        unless you have told it to start a program when you do this. You
        do this with the properties box described <A
HREF="network-applets.html#MAILCHECK-PREFS"
>below</A
>.
      </P
></LI
><LI
><P
>        Holding down <SPAN
CLASS="MOUSEBUTTON"
>mouse button 2</SPAN
> allows
        you to drag the applet around the panel (and between panels).
        option.
      </P
></LI
><LI
><P
>        Clicking <SPAN
CLASS="MOUSEBUTTON"
>mouse button 3</SPAN
> brings up
        the typical <B
CLASS="GUIMENU"
>applet menu</B
> which includes an
        About box and a <A
HREF="network-applets.html#MAILCHECK-PREFS"
>properties</A
>
      </P
></LI
></UL
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="MAILCHECK-PREFS"
>Preferences</A
></H3
><P
>       The mailcheck <SPAN
CLASS="INTERFACE"
>properties dialogue box</SPAN
> is
       divided into two sections, one for what the mail check applet
       does, and one for where it checks for email.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="MAILCHECK-SETTINGS-MAILCHECK-FIG"
></A
><P
><IMG
SRC="./figs/mailcheck-properties-mailcheck.png"></P
><P
><B
>Figure 49. Properties dialog &#8212; Mail check tab</B
></P
></DIV
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Mail check options</DT
><DD
><P
>         The mail check options have six sections:
       </P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Execute...before each update</DT
><DD
><P
>            Sometimes you may want to run something such as
            <TT
CLASS="APPLICATION"
>fetchmail</TT
> before the applet 
            checks for new mail. To do this, check the checkbox and
            fill in the program name in the space here.
          </P
></DD
><DT
>Execute...when new mail arrives</DT
><DD
><P
>            Sometimes you may want other programs to run when new mail
            arrives. It is common to tell the machine to play a noise 
            at you, for example. Checking this checkbox and filling in
            the command (such as <B
CLASS="COMMAND"
>mpg123 sillynoise.mpg</B
>
            or <B
CLASS="COMMAND"
>esdplay sillynoise.wav</B
>) will let this
            happen.
          </P
></DD
><DT
>Execute...when clicked</DT
><DD
><P
>            By putting a program name (generally a mail-reader such as
            <TT
CLASS="APPLICATION"
>balsa</TT
> or <TT
CLASS="APPLICATION"
>spruce</TT
>
            here and clicking on the checkbox, you can set things up so that
            when you click <SPAN
CLASS="MOUSEBUTTON"
>button 1</SPAN
> on the 
            applet, that program will be automatically run.
          </P
></DD
><DT
>Check for mail every...</DT
><DD
><P
>            You can adjust the range for checking whether mail has arrived
            between 1440 minutes (once a day) to never. Setting it to never
            is silly and will confuse it. The default value is every two
            minutes.
          </P
></DD
><DT
>Play a sound when new mail arrives</DT
><DD
><P
>            The sound played if you check this <B
CLASS="GUIBUTTON"
>checkbox</B
>
            is an alarm bell. It is contained in
            <TT
CLASS="FILENAME"
>$prefix/sound/events/mailcheck.soundlist</TT
>;
            if you want to change it to a different sound, alter that and
            put the sound in <TT
CLASS="FILENAME"
>$prefix/sounds/</TT
>.
          </P
></DD
><DT
>Select animation</DT
><DD
><P
>            By clicking on the <TT
CLASS="GUILABEL"
><B
>box with the animation name</B
></TT
>,
            you can get a list of different pictures which have different
            animations when new email arrives.
          </P
></DD
></DL
></DIV
></DD
></DL
></DIV
><DIV
CLASS="FIGURE"
><A
NAME="MAILCHECK-SETTINGS-MAILBOX-FIG"
></A
><P
><IMG
SRC="./figs/mailcheck-properties-mailbox.png"></P
><P
><B
>Figure 50. Properties dialog &#8212; Mailbox tab</B
></P
></DIV
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Mailbox options</DT
><DD
><P
>         The mailbox options have four sections, some of which will be
         greyed-out.
       </P
><P
>         By clicking on the <TT
CLASS="GUILABEL"
><B
>box with the mailbox location</B
></TT
>,
         you can tell the mailcheck applet where to look for your incoming
         email.
       </P
><P
></P
><UL
><LI
><P
>           When local mailspool or local maildir are selected as the location
           for the mailbox, then you can fill in the details on which file
           or directory the applet should check for new email. You can only
           put one filename here. The section about mail servers will be
           greyed out.
          </P
></LI
><LI
><P
>           When remote POP3 or remote IMAP are selected as the location for
           the mailbox, then you can fill in the details on the mail server,
           username and password. If the you don't supply the password, the
           applet will ask for it when it first tries to check for mail.
           The section about local filenames will be greyed out.
         </P
></LI
></UL
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="MAILCHECK-BUGS"
>Known bugs and limitations</A
></H3
><P
></P
><UL
><LI
><P
>       Setting something to be executed before each update can hang the
       applet and the panel.
     </P
></LI
><LI
><P
>       Sometimes the animation stops happening after prolonged use.
     </P
></LI
><LI
><P
>       If you use a mail filter such as <TT
CLASS="APPLICATION"
>procmail</TT
>,
       which sorts email into different folders, the applet won't check them
       all for new email. It will only look at one file.
     </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MODEMLIGHTS"
>Modem Lights Applet</A
></H2
><P
> <TT
CLASS="APPLICATION"
>Modem Lights Applet</TT
>, shown in <A
HREF="network-applets.html#MODEMLIGHTS-FIG1"
>Figure 51</A
>, monitors your modem while it is
  working. To add this applet to a <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>,
  right-click on the panel
  and choose
         <B
CLASS="GUIMENU"
>Panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Add to panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Applet</B
>-&gt;<B
CLASS="GUISUBMENU"
>Network</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Modem Lights</B
>
  </P
><DIV
CLASS="FIGURE"
><A
NAME="MODEMLIGHTS-FIG1"
></A
><P
><IMG
SRC="./figs/modemlights.png"></P
><P
><B
>Figure 51. Modem Lights Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="MODEMLIGHTS-USAGE"
>Usage</A
></H3
><P
>This applet can be used to tell if your modem is working,
    and to track its behavior and performance. It can also be
    configured to call a separate script or program to have your modem
    connect and disconnect when you click on the <B
CLASS="GUIBUTTON"
>button
    with the single green light</B
>.
    </P
><P
>Right-clicking on the applet brings up a menu containing the
    following items:
<P
></P
><UL
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>Properties</B
>&#8212; brings up
	    <A
HREF="network-applets.html#MODEMLIGHTS-PREFS"
>                <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
>
            </A
> dialog
	    </P
></LI
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>Help</B
> &#8212; brings up this
            document. 
	    </P
></LI
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>About</B
> &#8212; shows basic
            information about the <TT
CLASS="APPLICATION"
>Modem Lights
            Applet</TT
>, including the applet's version and
            author's name.
         </P
></LI
></UL
>
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="MODEMLIGHTS-PREFS"
>Customization</A
></H3
><P
>      You can customize <TT
CLASS="APPLICATION"
>Modem Lights Applet</TT
> by
      right-clicking on it and choosing
      <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
>. This will open the
      <SPAN
CLASS="INTERFACE"
>Modem Lights Settings</SPAN
> dialog (shown in <A
HREF="network-applets.html#MODEMLIGHTS-FIG2"
>Figure 52</A
>, which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="MODEMLIGHTS-FIG2"
></A
><P
><IMG
SRC="./figs/modemlights-prefs.png"></P
><P
><B
>Figure 52. Preferences dialog</B
></P
></DIV
><P
>     The properties are:
     <P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show connect time and
    throughput</B
></TT
> &#8212; have <TT
CLASS="APPLICATION"
>Modem
    Lights Applet's</TT
> graphic display expand to include
    two small text boxes showing the current data transfer rate (top)
    and connect time (bottom).</P
><P
><TT
CLASS="GUILABEL"
><B
>Connect command:</B
></TT
> and
        <TT
CLASS="GUILABEL"
><B
>Disconnect command: </B
></TT
> &#8212;  To use
    <TT
CLASS="APPLICATION"
>Modem Lights Applet</TT
> to initiate a
    connection, place the name of the startup command in the
    <TT
CLASS="GUILABEL"
><B
>Connect command</B
></TT
> text box, and the disconnect
    command in the box beneath it labeled <TT
CLASS="GUILABEL"
><B
>Disconnect
    command</B
></TT
>. When you click on the single button on the
    applet, it will connect or disconnect your modem.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Confirm connection</B
></TT
> &#8212;
        Display a dialog box confirming your connection.</P
></LI
><LI
><P
>        <TT
CLASS="GUILABEL"
><B
>Updates per second</B
></TT
> &#8212; Set the update
        rate of <TT
CLASS="APPLICATION"
>Modem Lights
        Applet's</TT
> display.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show connect time and
        throughput</B
></TT
> &#8212; add two text windows to the
        applet showing the time you have been connected at the data
        transfer rate. This is a good way to monitor your modem's
        performance.</P
></LI
></UL
>

    </P
><P
> 
      After you have made all the changes you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to apply the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click the
      <B
CLASS="GUIBUTTON"
>Cancel</B
> button.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="MODEMLIGHTS-FIG3"
></A
><P
><IMG
SRC="./figs/modemlights-advpref.png"></P
><P
><B
>Figure 53. Advanced preferences dialog</B
></P
></DIV
><P
><TT
CLASS="APPLICATION"
>Modem Lights Applet's</TT
>
    <SPAN
CLASS="INTERFACE"
>Advanced preferences window</SPAN
> allows you to
    control advanced features of the applet.</P
><P
>     The properties are:
     <P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Modem lock file:</B
></TT
> &#8212;
    specifies the file created by the computer when the modem is
    working, allowing other programs to know it is in
    operation. <TT
CLASS="FILENAME"
>/var/lock/LCK..modem</TT
>, the default
    setting, is the most common, if your computer uses a symbolic link
    from <TT
CLASS="FILENAME"
>/dev/modem</TT
> to the actual modem
    device. Check with your system administrator to see if a different
    device name and therefore lock file is in use. <TT
CLASS="APPLICATION"
>Modem
    Lights Applet</TT
> needs this information to find and
    monitor your modem.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Verify owner of lock file</B
></TT
>
        &#8212;  verify that the lockfile really belongs to the
        currently running PPP daemon and is not left over from an
        older one. This is checked by default and shouldn't be changed.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Device</B
></TT
> &#8212; Device, typically
    <TT
CLASS="FILENAME"
>ppp0</TT
> on a Linux machine, is the name of the
    network interface being used by the modem. If
    <TT
CLASS="FILENAME"
>ppp0</TT
> is not correct for your machine, check
    your system documentation for the correct designation.</P
><P
>Other possible network interface names commonly used include
    <TT
CLASS="FILENAME"
>ippp0</TT
> for Linux ISDN;
    <TT
CLASS="FILENAME"
>isp0</TT
> for NetBSD ISDN and
    <TT
CLASS="FILENAME"
>ipdptp0</TT
> for Solaris PPP.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Use ISDN</B
></TT
> &#8212; If you use
    an ISDN modem, check the <TT
CLASS="GUILABEL"
><B
>Use ISDN</B
></TT
>
    checkbox. <TT
CLASS="APPLICATION"
>Modem Lights Applet</TT
> will then
    ignore all the settings above related to standard modems.</P
></LI
></UL
>
    </P
><P
> 
      After you have made all the changes you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to apply the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click the
      <B
CLASS="GUIBUTTON"
>Cancel</B
> button.
    </P
><P
> After you made all the choices you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to make the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click on
      <B
CLASS="GUIBUTTON"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="MODEMLIGHTS-BUGS"
>Known bugs and limitations</A
></H3
><P
>    The <TT
CLASS="GUILABEL"
><B
>Verify lock file</B
></TT
> check box on the
    advanced preferences window should always be left true. It is
    likely to be removed from future versions of <TT
CLASS="APPLICATION"
>Modem
    Lights Applet.</TT
>
    </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="WEBCONTROL"
>WebControl Applet</A
></H2
><P
> <TT
CLASS="APPLICATION"
>WebControl Applet</TT
>, shown in <A
HREF="network-applets.html#WEBCONTROL-APPLET-FIG1"
>Figure 54</A
>, allows you to launch your
  <TT
CLASS="APPLICATION"
>Netscape</TT
> browser with the URL you
  indicate in the URL text box. To add this applet
  to a <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, right-click on the panel and choose

 <B
CLASS="GUIMENU"
>Panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Add to panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Applet</B
>-&gt;<B
CLASS="GUISUBMENU"
>Network</B
>-&gt;<B
CLASS="GUIMENUITEM"
>WebControl</B
>
  </P
><DIV
CLASS="FIGURE"
><A
NAME="WEBCONTROL-APPLET-FIG1"
></A
><P
><IMG
SRC="./figs/webcontrol-applet.png"></P
><P
><B
>Figure 54. WebControl Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="WEBCONTROL-APPLET-USAGE"
>Usage</A
></H3
><P
> To use this applet, type the URL of the document you wish
    to view in the text box. For an Internet URL, you must type in
    <B
CLASS="COMMAND"
>http://</B
> followed by the web address, for
    example, <B
CLASS="COMMAND"
>http://www.gnome.org</B
>. For a local
    file, simply type the file's name. 
    </P
><P
>If you would like to launch a new browser window instead of
    using the currently active one, check the <TT
CLASS="GUILABEL"
><B
>Launch new
    window</B
></TT
> check box.</P
><P
> Right-clicking on the applet brings up a menu containing the
    following items:
      <P
></P
><UL
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>Properties</B
>&#8212; opens the
	    <A
HREF="network-applets.html#WEBCONTROL-APPLET-PREFS"
>                <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
>
            </A
> dialog
	    </P
></LI
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>Help</B
> &#8212; displays this
            document. 
	    </P
></LI
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>About</B
> &#8212; shows basic
            information about <TT
CLASS="APPLICATION"
>WebControl
            Applet</TT
>, including the applet's version and author's name. 
	    </P
></LI
></UL
>
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="WEBCONTROL-APPLET-PREFS"
>Customization</A
></H3
><P
>      You can customize <TT
CLASS="APPLICATION"
>WebControl Applet</TT
> by
      right-clicking on it and choosing
      <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
>. This will open
      the <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog (shown in <A
HREF="network-applets.html#WEBCONTROL-APPLET-FIG2"
>Figure 55</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="WEBCONTROL-APPLET-FIG2"
></A
><P
><IMG
SRC="./figs/webcontrol-applet-prefs.png"></P
><P
><B
>Figure 55. WebControl Properties Dialog</B
></P
></DIV
><P
>     The properties are:
     <P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Display URL label</B
></TT
> &#8212;
      display the text <TT
CLASS="GUILABEL"
><B
>Url:</B
></TT
> to the left of the
      text entry window in the applet.</P
></LI
><LI
><P
>        <TT
CLASS="GUILABEL"
><B
>Display "launch new window" option</B
></TT
>
    &#8212; display check box on the applet window allowing you to
    decide whether your document will be displayed in a new browser
    window or the currently open.</P
></LI
></UL
>
    </P
><P
> 
      After you have made all the changes you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to apply the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click the
      <B
CLASS="GUIBUTTON"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="WEBCONTRO-APPLET-BUGS"
>Known bugs and limitations</A
></H3
><P
>      <TT
CLASS="APPLICATION"
>WebControl Applet</TT
> only starts
      <TT
CLASS="APPLICATION"
>Netscape</TT
>. If you don't have
      <TT
CLASS="APPLICATION"
>Netscape</TT
>, it won't work. If you have
      a different browser set as your URL handler, <TT
CLASS="APPLICATION"
>Web
      Control Applet</TT
> will still start <TT
CLASS="APPLICATION"
>Netscape</TT
>.
    </P
><P
><TT
CLASS="APPLICATION"
>WebControl Applet</TT
> does not
    resize to match the size of the panel if the panel is smaller than
    <TT
CLASS="APPLICATION"
>WebControl Applet's</TT
> normal height and width. This
    effects both small horizontal panels and all vertical panels.</P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="multimedia-applets.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="utility-applets.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Multimedia Applets</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gnome-applets.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Utility Applets</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>