glfs/gnome/add/totem.xml
Ken Moffat 0a6491f61d totem-3.2.1
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9549 af4574ff-66df-0310-9fd7-8a98e5e911e0
2012-02-28 22:05:39 +00:00

226 lines
8.6 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY totem-download-http "&gnome-download-http;/totem/&gnome-version;/totem-&totem-version;.tar.xz">
<!ENTITY totem-download-ftp "&gnome-download-ftp;/totem/&gnome-version;/totem-&totem-version;.tar.xz">
<!ENTITY totem-md5sum "6a7911b45f908fd8237ba1217d0fded3">
<!ENTITY totem-size "3.0 MB">
<!ENTITY totem-buildsize "98 MB">
<!ENTITY totem-time "2.9 SBU">
]>
<sect1 id="totem" xreflabel="Totem-&totem-version;">
<?dbhtml filename="totem.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>Totem-&totem-version;</title>
<indexterm zone="totem">
<primary sortas="a-Totem">Totem</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Totem</title>
<para>The <application>Totem</application> package contains the official
movie player of the GNOME desktop environment based on
<application>GStreamer</application>. It features a playlist, a full-screen
mode, seek and volume controls, as well as keyboard navigation. This is
useful for playing any <application>GStreamer</application> supported file,
DVD, VCD or digital CD.</para>
<para>Now that this package uses the <application>clutter</application> toolkit,
it is only useful if you have accelerated video.</para>
&lfs70_built;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&totem-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&totem-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &totem-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &totem-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &totem-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &totem-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Totem Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="GConf"/>,
<xref linkend="gnome-doc-utils"/>,
<xref linkend="gst-plugins-good"/>,
<xref linkend="libunique"/>,
<xref linkend="shared-mime-info"/>,
<xref linkend="totem-pl-parser"/>, and
<xref linkend="which"/></para>
<para>Ensure you built <application>GStreamer Good Plugins</application>
with <application>GConf</application> support or the
<command>configure</command> script will fail.</para>
<!-- commenting, I can find no references to PyGTK or pygtk in the package, except
for old ChangeLog entries.
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended"><xref linkend="pygtk"/> (Required for various plugins)</para>-->
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><ulink url="http://www.bluez.org/">BlueZ</ulink>,
<ulink url="http://gmyth.sourceforge.net">GMyth</ulink>,
<ulink url="http://gmyth.sourceforge.net">GMyth-upnp</ulink>,
<ulink url="http://www.home.unix-ag.org/simon/gromit/">Gromit</ulink>
(required for the telestrator mode),
<ulink url="http://live.gnome.org/libepc/">libepc</ulink>,
<ulink url="http://www.galago-project.org/">libgalago</ulink>,
<ulink url="http://live.gnome.org/libgdata/">libgdata</ulink>,
<ulink url="http://www.lirc.org">LIRC</ulink>,
<xref linkend="nautilus"/>,
<xref linkend="pygobject2"/>,
<ulink url="http://pypi.python.org/pypi/pylint"/> (required, with its dependencies,
to run the testsuite),
<ulink url="http://live.gnome.org/Tracker/">Tracker</ulink>,
<ulink url="http://live.gnome.org/Vala/">Vala</ulink>, and
<xref linkend="firefox"/> or <xref linkend="xulrunner"/>
(to build the browser plug-in)</para>
<para>Note: <xref linkend="libdvdcss"/> is a run-time requirement if you
wish to play encrypted DVDs</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/totem"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Totem</title>
<para>Install <application>Totem</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=$GNOME_PREFIX \
--libexecdir=$GNOME_PREFIX/lib/totem &amp;&amp;
make</userinput></screen>
<para>If you have installed the dependencies for the testsuite,
issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gnome-prefix.xml"/>
<para><parameter>--libexecdir=$GNOME_PREFIX/lib/totem</parameter>: This
parameter is used so that the movie player browser plugin is installed in
the preferred location of <filename
class='directory'>$GNOME_PREFIX/lib/totem</filename> instead of <filename
class='directory'>$GNOME_PREFIX/libexec</filename>.</para>
<para><option>--enable-static=no</option>: This switch prevents the static
libraries being installed.</para>
<!-- This is broken now so disabling the comment
<para><option>-enable-vanity</option>: Using this parameter will build the
webcam utility (still in development).</para>
-->
</sect2>
<sect2 role="configuration">
<title>Configuring Totem</title>
<sect3><title>Configuration Information</title>
<para>You may find that <application>totem</application> crashes. If so,
you can set the following in your environment, either in ~/.xinitrc or in
your .Xsession: <command>export CLUTTER_DISABLE_ARGB_VISUAL=1</command></para>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>totem, totem-audio-preview,
totem-video-thumbnailer, and totem-plugin-viewer</seg>
<seg>libtotem.{so,a}, libtotem-properties-page.{so,a}, libbrasero-disc-recorder.{so,a},
libgromit.{so,a}, libmedia_player_keys.{so,a}, libontop.{so,a},
libmovie-properties.{so,a}, libscreensaver.{so,a}, libscreenshot.{so,a},
libskipto.{so,a}, libthumbnail.{so,a}, libtotem-cone-plugin.{so,a},
libtotem-gmp-plugin.{so,a}, libtotem-mully-plugin.{so,a}, and
libtotem-narrowspace-plugin.{so,a}</seg>
<seg><envar>$GNOME_PREFIX</envar>/{lib/totem/{plugins/{brasero-disc-recorder,
coherence_upnp,dbus,gromit,iplayer,jamendo,media-player-keys,ontop,
opensubtitles,properties,pythonconsole,screensaver,screenshot,skipto,
thumbnail,totem},totem},share/{gnome/help/totem/*,gtk-doc/html/totem,
omf/totem,totem}}</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="totem-prog">
<term><command>totem</command></term>
<listitem>
<para>is a <application>GNOME</application> desktop movie player based
on <application>GStreamer</application>.</para>
<indexterm zone="totem totem-prog">
<primary sortas="b-totem">totem</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="totem-video-thumbnailer">
<term><command>totem-video-thumbnailer</command></term>
<listitem>
<para>is a video thumbnailer for the GNOME desktop used internally by
GNOME applications such as <application>Nautilus</application> to
generate PNG thumbnails of video files. While it is possible to
invoke it manually, it is usually done automatically by
<application>Nautilus</application>.</para>
<indexterm zone="totem totem-video-thumbnailer">
<primary sortas="b-totem-video-thumbnailer">totem-video-thumbnailer</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>