source: multimedia/videoutils/xine-ui.xml@ 89464ed

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY xine-ui-download-http "http://prdownloads.sourceforge.net/xine/xine-ui-&xine-ui-version;.tar.gz">
  <!ENTITY xine-ui-download-ftp  " ">
  <!ENTITY xine-ui-size          "2.6 MB">
  <!ENTITY xine-ui-buildsize     "18.5 MB">
  <!ENTITY xine-ui-time          "0.54 SBU">
]>

<sect1 id="xine-ui" xreflabel="xine User Interface-&xine-ui-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="xine-ui.html"?>
<title><application>xine User Interface</application>-&xine-ui-version;</title>
<indexterm zone="xine-ui">
<primary sortas="a-Xine-User-Interface">Xine User Interface</primary></indexterm>

<sect2>
<title>Introduction to <application>xine User Interface</application></title>

<para>The <application>xine User Interface</application> package contains a 
multimedia player. It plays back <acronym>CD</acronym>s, 
<acronym>DVD</acronym>s and <acronym>VCD</acronym>s. It also decodes 
multimedia files like <acronym>AVI</acronym>, <acronym>MOV</acronym>, 
<acronym>WMV</acronym>, <acronym>MPEG</acronym> and <acronym>MP3</acronym> 
from local disk drives, and displays multimedia streamed over the 
Internet.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&xine-ui-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&xine-ui-download-ftp;"/></para></listitem>
<listitem><para>Download size: &xine-ui-size;</para></listitem>
<listitem><para>Estimated disk space required:
&xine-ui-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&xine-ui-time;</para></listitem></itemizedlist>
</sect3>

<!-- <sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch (if utilizing cURL): <ulink
url="&patch-root;/xine-ui-&xine-ui-version;-curl-1.patch"/>
</para></listitem>
</itemizedlist></sect3> -->

<sect3><title><application>xine User Interface</application> 
dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="xine-lib"/></para>
</sect4>

<sect4><title>Optional</title>
<para><xref linkend="pkgconfig"/>, 
<xref linkend="curl"/>, 
<xref linkend="aalib"/>, 
<ulink url="http://www.lirc.org">LIRC</ulink> and 
<ulink url="http://sam.zoy.org/projects/libcaca/">libcaca</ulink></para>
</sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>xine User Interface</application></title>

<!-- <para>Apply the following patch if you have
<application>cURL</application> installed and you wish to utilize
it:</para>

<screen><userinput><command>patch -Np1 -i ../xine-ui-&xine-ui-version;-curl-1.patch</command></userinput></screen> -->

<para>Install <application>xine User Interface</application> by running the 
following commands:</para>

<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>

<para>Now, as the root user:</para>

<screen><userinput role='root'><command>make install</command></userinput></screen>

</sect2>

<sect2>
<title>Configuring <application>xine User Interface</application></title>

<sect3 id="xine-ui-config"><title>Config files</title>
<para><filename>~/.xine/config</filename></para>
<indexterm zone="xine-ui xine-ui-config">
<primary sortas="e-AA.xine-config">~/.xine/config</primary>
</indexterm>
</sect3>

<sect3><title>Configuration Information</title>
<para>The above file is created and maintainable through the
<command>xine</command> setup dialog box. The documentation for the 
configuration settings is located at
<filename>/usr/share/doc/xine-ui/README.config_en</filename>.</para>
</sect3>

</sect2>

<sect2>
<title>Contents</title>

<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>aaxine, cacaxine, fbxine, xine, xine-bugreport, xine-check and 
xine-remote</seg>
<seg>/usr/share/xine/[desktop,skins,visuals] and 
/usr/share/doc/[xine-ui,xitk]</seg>
</seglistitem>
</segmentedlist>

<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>

<varlistentry id="aaxine">
<term><command>aaxine</command></term>
<listitem><para>is an <acronym>ASCII</acronym> art video player which utilizes 
<application>AAlib</application> as the frontend for the 
<application>xine Libraries</application>.</para>
<indexterm zone="xine-ui aaxine">
<primary sortas="b-aaxine">aaxine</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="cacaxine">
<term><command>cacaxine</command></term>
<listitem><para>is a color <acronym>ASCII</acronym> art video player which 
utilizes <application>CACA</application> as the frontend for the 
<application>xine Libraries</application>.</para>
<indexterm zone="xine-ui cacaxine">
<primary sortas="b-cacaxine">cacaxine</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="fbxine">
<term><command>fbxine</command></term>
<listitem><para>is a frame buffer interface to the 
<application>xine Libraries</application>.</para>
<indexterm zone="xine-ui fbxine">
<primary sortas="b-fbxine">fbxine</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="xine">
<term><command>xine</command></term>
<listitem><para>is a multimedia player designed to play 
<acronym>MPEG</acronym> streams (audio and video), <acronym>MPEG</acronym> 
elementary streams (<acronym>MP3</acronym>), <acronym>MPEG</acronym> 
transport streams, Ogg files, <acronym>AVI</acronym> files, 
<acronym>ASF</acronym> files, some Quicktime files, <acronym>VCD</acronym>s 
and <acronym>DVD</acronym>s (non-encrypted).</para>
<indexterm zone="xine-ui xine">
<primary sortas="b-xine">xine</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="xine-bugreport">
<term><command>xine-bugreport</command></term>
<listitem><para>produces a terse system description and guides you through the 
process of reporting a bug.</para>
<indexterm zone="xine-ui xine-bugreport">
<primary sortas="b-xine-bugreport">xine-bugreport</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="xine-check">
<term><command>xine-check</command></term>
<listitem><para>tests the <command>xine</command> video player installation 
for common problems. It tests the operating system settings, installation of 
plugins, <acronym>CD</acronym>/<acronym>DVD</acronym> drive settings and video 
support parameters.</para>
<indexterm zone="xine-ui xine-check">
<primary sortas="b-xine-check">xine-check</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="xine-remote">
<term><command>xine-remote</command></term>
<listitem><para>is a tool to connect to a <command>xine</command> remote 
control server.</para>
<indexterm zone="xine-ui xine-remote">
<primary sortas="b-xine-remote">xine-remote</primary></indexterm>
</listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>