<?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 sound-juicer-download-http
          "&gnome-download-http;/sound-juicer/3.4/sound-juicer-&sound-juicer-version;.tar.xz">
  <!ENTITY sound-juicer-download-ftp
           "&gnome-download-ftp;/sound-juicer/3.4/sound-juicer-&sound-juicer-version;.tar.xz">
  <!ENTITY sound-juicer-md5sum        "a913b246260ccf3843ea779ae9cdb5e7">
  <!ENTITY sound-juicer-size          "1.9 MB">
  <!ENTITY sound-juicer-buildsize     "22 MB">
  <!ENTITY sound-juicer-time          "0.6 SBU">
]>

<sect1 id="sound-juicer" xreflabel="Sound-Juicer-&sound-juicer-version;">
  <?dbhtml filename="sound-juicer.html"?>

  <sect1info>
    <othername>$LastChangedBy: krejzi $</othername>
    <date>$Date: 2013-06-01 08:18:39 -0400 (Sat, 01 Jun 2013) $</date>
  </sect1info>

  <title>Sound-Juicer-&sound-juicer-version;</title>

  <indexterm zone="sound-juicer">
    <primary sortas="a-Sound-Juicer">Sound-Juicer</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Sound Juicer</title>

    <para>
      The <application>Sound Juicer</application> package contains the
      simple CD ripping tool which is useful for extracting the audio tracks
      from audio compact discs and converting them into audio files. It can
      also play the audio tracks directly from the CD, allowing you to preview
      the CD before ripping it.
    </para>

    &lfs72_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&sound-juicer-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&sound-juicer-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &sound-juicer-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &sound-juicer-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &sound-juicer-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &sound-juicer-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Sound Juicer Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="GConf"/>,
      <xref linkend="gnome-doc-utils"/>,
      <xref linkend="gst-plugins-base"/>,
      <xref linkend="gtk3"/>,
      <xref linkend="libcanberra"/> and
      <xref linkend="libmusicbrainz3"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="rarian"/>
    </para>

    <bridgehead renderas="sect4">Recommended (Runtime)</bridgehead>
    <para role="recommended">
      <xref linkend="gst-plugins-good"/>
      (for the flacenc and wavenc plugins) and
      <xref linkend="gst-plugins-ugly"/>
      (for the lame plugin)
    </para>

    <para condition="html" role="usernotes">User Notes:
      <ulink url="&blfs-wiki;/sound-juicer"/>
    </para>
  </sect2>

  <sect2 role="installation">
    <title>Installation of Sound Juicer</title>

    <para>
      Install <application>Sound Juicer</application> by running the
      following commands:
    </para>

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

    <para>
      This package does not come with a test suite.
    </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/without-scrollkeeper.xml"/>

  </sect2>

  <sect2 role="configuration">
    <title>Configuring Sound Juicer</title>

    <sect3 id="sound-juicer-config">
      <title>Configuration Information</title>

      <para>
        Configuration is accomplished by using the
        <quote>Preferences</quote> drop-down menu option.
        For information on how to configure
        <command>sound-juicer</command> to use
        <application>LAME</application> as the default
        encoding method (creating  MP3 files as the default)
        see the <application>Sound Juicer</application>
        Help section.
      </para>

    </sect3>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          sound-juicer
        </seg>
        <seg>
          None
        </seg>
        <seg>
          /usr/share/gnome/help/sound-juicer,
          /usr/share/omf/sound-juicer and
          /usr/share/sound-juicer
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="sound-juicer-prog">
        <term><command>sound-juicer</command></term>
        <listitem>
          <para>
            is a graphical CD extraction (ripping) tool based on
            <application>GTK+</application> and
            <application>GStreamer</application>.
          </para>
          <indexterm zone="sound-juicer sound-juicer-prog">
            <primary sortas="b-sound-juicer">sound-juicer</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>

  </sect2>

</sect1>
