<?xml version="1.0" encoding="utf-8"?>
<!-- -*- indent-tabs-mode: nil -*- -->
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY app "Sound Juicer">
<!ENTITY application "<application>&app;</application>">
<!ENTITY appversion "2.22.0">
<!ENTITY manrevision "2.22.0">
<!ENTITY musicbrainz "<ulink url='http://www.musicbrainz.org/'>MusicBrainz</ulink>">
]>
<?gnome-doc-status Version: 2.12
Status: Draft
?>
<article id="index" lang="sl">
  <articleinfo>
    <title lang="en"><application>Sound Juicer</application> Manual</title>
    
    <copyright lang="en">
      <year>2003</year>
      <holder>Mike Hearn (mike@theoretic.com)</holder>
    </copyright>
    <copyright lang="en">
      <year>2005</year>
      <holder>Shaun McCance</holder>
    </copyright>
    <copyright lang="en">
      <year>2008</year>
      <holder>Andreas Freund</holder>
    </copyright>
    
    <publisher>
      <publishername>Projekt dokumentacije GNOME</publishername>
    </publisher>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <authorgroup>
      <author lang="en">
        <firstname>Andreas</firstname>
        <surname>Freund</surname>
        <affiliation>
          <orgname>Google Highly Open Participation Contest</orgname>
        </affiliation>
      </author>
      <author lang="en">
        <firstname>Mike</firstname>
        <surname>Hearn</surname>
        <email>mike@theoretic.com</email>
      </author>
      <author role="maintainer" lang="en">
        <firstname>Shaun</firstname>
        <surname>McCance</surname>
        <affiliation>
          <orgname>GNOME Documentation Project</orgname>
        </affiliation>
        <email>shaunm@gnome.org</email>
      </author>
    </authorgroup>

    <revhistory>
      <revision lang="en">
        <revnumber>2.22.0</revnumber>
        <date>2008-01-12</date>
        <revdescription>
          <para role="author" lang="en">Andreas Freund</para>
          <para role="publisher" lang="en">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision lang="en">
        <revnumber>2.10</revnumber>
        <date>2005-03-06</date>
        <revdescription>
          <para role="author" lang="en">Shaun McCance</para>
          <para role="publisher" lang="en">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision lang="en">
        <revnumber>2.0</revnumber>
        <date>2003-07-06</date>
        <revdescription>
          <para role="author" lang="en">Mike Hearn
            <email>mike@theoretic.com</email>
          </para>
          <para role="publisher" lang="en">GNOME Documentation Project</para>
        </revdescription>
      </revision>
    </revhistory>
    <!-- Translators may also add here feedback address for translations -->

    <abstract role="description">
      <para lang="en"><application>Sound Juicer</application> is a simple and clean CD ripping tool. It allows you
      to extract the audio from audio compact discs and convert them into audio
      files that your computer can understand and play.</para>
    </abstract>
  </articleinfo>

  <section id="intro">
    <title>Uvod</title>
    <anchor id="aboutex"/>
    <anchor id="notice"/>
    <indexterm lang="en">
      <primary>Sound Juicer</primary>
      <secondary>Manual</secondary>
      <tertiary>sound-juicer</tertiary>
    </indexterm>

    <para lang="en"><application>Sound Juicer</application> is a simple and clean CD ripping tool. It allows you
    to extract the audio from audio compact discs and convert them into audio
    files that your computer can understand and play.  <application>Sound Juicer</application> can also
    play the audio tracks directly from the CD, allowing you to preview the
    CD before ripping it.</para>

    <para lang="en"><application>Sound Juicer</application> is designed to be easy to use, and to work with little
    user intervention.  When you start <application>Sound Juicer</application>, it will examine the CD in
    the drive and try to locate information about the audio tracks using the
    freely-available <ulink url="http://www.musicbrainz.org/">MusicBrainz</ulink> service.</para>

    <informalfigure>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/startup.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase><application>Sound Juicer</application> on startup</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </informalfigure>
  </section>

  <section id="track-data">
    <title lang="en">Entering Track Data</title>

    <para lang="en">When you insert an audio CD, <application>Sound Juicer</application> will automatically retrieve
    the track data from <ulink url="http://www.musicbrainz.org/">MusicBrainz</ulink>.  <ulink url="http://www.musicbrainz.org/">MusicBrainz</ulink> is a free service that provides
    a database of data for most published CDs.  <application>Sound Juicer</application> uses the CD's serial
    number and the positions and lengths of the tracks to match against CD in the
    <ulink url="http://www.musicbrainz.org/">MusicBrainz</ulink> database.</para>

    <para lang="en">Occasionally, more than one CD will have the same layout.  If more than
    one CD is found, <application>Sound Juicer</application> will present a dialog allowing you to choose
    which CD data to use.  If the wrong CD is detected, or if <ulink url="http://www.musicbrainz.org/">MusicBrainz</ulink> does
    not contain any matching CDs, you will have to enter the track information
    manually.  Also, if you choose, you can add the information for the CD to
    <ulink url="http://www.musicbrainz.org/">MusicBrainz</ulink> database with a banner that will appear.</para>

    <para lang="en">The top of the window contains text boxes for the title, artist, year,
    and genre of the CD.  Below that is a list of the audio tracks on the CD.  You
    can set the track title and artist for each track.  <application>Sound Juicer</application> uses this
    information to name the files and folders where your music is stored.  The
    track and album information is also encoded directly into the audio files.
    Many music players, including portable devices, use this information to
    organize and display the audio files.</para>

    <para lang="en">To edit the title of a track, first select the track, then click
    on the title.  When you have finished entering the title, press the
    <keycap>Enter</keycap> key on your keyboard, or click outside the
    title.</para>

    <para lang="en">When you edit the artist for the CD, the artist for each track is
    automatically updated, but only if they also matched before the change (so that
    changling the album artist of a compilation doesn't change all of the track
    artists too).  Most CDs are by a single artist, and this feature saves you the time 
    of entering the artist for each track.</para>

    <para lang="en">Some CDs, however, are compilations of songs by different artists.
    For these CDs, you will have to enter the artist for each track.  To set
    the artist for a track, first select the track, then click on the artist.
    You can set the artist for the CD to a value like "Various" or simply
    leave it blank, depending on how you prefer to organize your music.</para>

    <tip>
      <title lang="en">Entering Track Data With the Keyboard Only</title>
      <para lang="en">You can enter track data without using the mouse.  Use the up and
      down arrow keys to select a track, and the left and right arrow keys to
      focus the title or artist.  Press the space bar to begin editing the
      title or artist, and press <keycap>Enter</keycap> when finished.</para>
    </tip>

    <para lang="en"><ulink url="http://www.musicbrainz.org/">MusicBrainz</ulink> unfortunately does not provide genre data, but
    <application>Sound Juicer</application> includes several stock genres:
    </para>

    <anchor id="genres"/>
    <itemizedlist>
      <listitem><para lang="en">Ambient    </para></listitem>
      <listitem><para lang="en">Blues      </para></listitem>
      <listitem><para lang="en">Classical  </para></listitem>
      <listitem><para lang="en">Country    </para></listitem>
      <listitem><para lang="en">Dance      </para></listitem>
      <listitem><para lang="en">Electronica</para></listitem>
      <listitem><para lang="en">Folk       </para></listitem>
      <listitem><para lang="en">Funk       </para></listitem>
      <listitem><para lang="en">Jazz       </para></listitem>
      <listitem><para lang="en">Latin      </para></listitem>
      <listitem><para lang="en">Pop        </para></listitem>
      <listitem><para lang="en">Rap        </para></listitem>
      <listitem><para lang="en">Reggae     </para></listitem>
      <listitem><para lang="en">Rock       </para></listitem>
      <listitem><para lang="en">Soul       </para></listitem>
      <listitem><para lang="en">Spoken Word</para></listitem>
    </itemizedlist>

    <tip><para lang="en">If you choose to make a custom genre, it will be remembered in the future.</para></tip>

  </section>

  <section id="extracting">
    <title lang="en">Extracting</title>
    <anchor id="using"/>

    <para lang="en">By default, <application>Sound Juicer</application> will extract all of the tracks on the CD
    to audio files.  If you do not wish to extract all of the tracks, you can
    control which tracks are extracted using the check boxes in the first column
    of the track listing.  Only the tracks you have selected will be extracted.
    </para>

    <para lang="en">You can also use the <menuchoice><guimenu>Edit</guimenu>
    <guimenuitem>Select All</guimenuitem></menuchoice> and <menuchoice>
    <guimenu>Edit</guimenu><guimenuitem>Deselect All</guimenuitem>
    </menuchoice> menu items to select all or none of the tracks to
    be extracted.</para>

    <para lang="en">When you have entered all the information you need, click on the
    <guibutton>Extract</guibutton> button, or press <keycombo><keycap>Ctrl</keycap>
    <keycap>Enter</keycap></keycombo>.  <application>Sound Juicer</application> will begin reading the audio
    from the CD and saving it to files on your computer.  By default, the audio
    files are stored under the <filename>Music</filename> folder in your home
    folder.</para>

    <para lang="en">When you begin extracting, the <guibutton>Extract</guibutton> button
    will change to a <guibutton>Stop</guibutton> button.  You can click this
    button at any time to stop extracting.</para>

    <para lang="en"><application>Sound Juicer</application> indicates which track it is currently extracting by
    displaying an icon next to the track number.  You can also see the total
    progress and estimated time left in the status bar at the bottom of the
    window.</para>

    <para lang="en">Extracting a CD can take a long time, depending on the speed of your
    computer.  You can safely minimize <application>Sound Juicer</application> or move to another workspace
    to continue using your computer while the audio is being extracted.</para>
  </section>

  <section id="playing">
    <title lang="en">Playing</title>

    <para lang="en"><application>Sound Juicer</application> allows you to play the tracks on your CD directly.
    To begin playing the CD, simply click the <guibutton>Play</guibutton>
    button, or press <keycombo><keycap>Ctrl</keycap><keycap>P</keycap>
    </keycombo>.  To play a particular track, select that track and click
    <guibutton>Play</guibutton>, or simple double-click the track.</para>

    <para lang="en">When <application>Sound Juicer</application> is playing a CD, the <guibutton>Play</guibutton>
    button changes to a <guibutton>Pause</guibutton> button.  You can click
    this at any time to pause the playing, and click <guibutton>Play</guibutton>
    again to continue playing where you left off.</para>

    <para lang="en">While playing, <application>Sound Juicer</application> displays a slider showing the position 
    on the current track.  To seek to another part of the track, drag the handle
    along the slider and release.</para>
  </section>

  <section id="preferences">
    <title lang="en">Preferences</title>

    <para lang="en">The preferences window allows you to control:</para>

    <itemizedlist>
      <listitem><para lang="en">Which CD drive <application>Sound Juicer</application> uses, if you have more than
      one drive,</para></listitem>
      <listitem><para lang="en">Whether or not to eject the CD when <application>Sound Juicer</application> is
      finished extracting,</para></listitem>
      <listitem><para lang="en">Whether or not to open the music folder when <application>Sound Juicer</application>
      is finished extracting,</para></listitem>
      <listitem><para lang="en">Where the extracted audio files are placed on your
      computer,</para></listitem>
      <listitem><para lang="en">Which system to use for the folder hierarchy in the music
      folder,</para></listitem>
      <listitem><para lang="en">Which format to use for the track names of the extracted
      audio files, and</para></listitem>
      <listitem><para lang="en">Which file format and codec are used for the extracted
      audio files.</para></listitem>
    </itemizedlist>

    <informalfigure>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/prefs.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Preferences window</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </informalfigure>

    <section id="prefs-drive">
      <title lang="en">Selecting a CD Drive</title>

      <para lang="en">If you have multiple CD drives in your computer, the drop-down list
      labelled <guilabel>CD drive</guilabel> under <guilabel>Device</guilabel>
      allows you to select which drive to use.  The check boxes <guibutton>Eject
      when finished</guibutton> and <guibutton>Open music folder when finished
      </guibutton>allow you to control whether <application>Sound Juicer</application> will eject the CD 
      from the drive, and whether it will open your music folder respectively, 
      when it has finished extracting the audio files.</para>
    </section>

    <section id="prefs-naming">
      <title lang="en">Naming Audio Files</title>

      <para lang="en">The <guilabel>Music Folder</guilabel> drop-down list allows you to
      select which folder to store your audio files in.  Select one of the
      folders from the list, or choose <guilabel>Other</guilabel> to select
      another folder with the file chooser.  By default, files are placed
      under the <filename>Music</filename> folder in your home folder.</para>

      <para lang="en">The <guilabel>Track Names</guilabel> section allows you to control
      how the files and folders are named.  <application>Sound Juicer</application> can store audio files
      in seperate folders, helping you keep your music organized.  You can
      choose how these folders are created and named using the <guilabel>Folder
      hierarchy</guilabel> drop-down list.  By default,  <application>Sound Juicer</application> creates
      a folder for the album artist and a subfolder for the album.</para>

      <para lang="en">Use the <guilabel>File name</guilabel> drop-down list to select
      how the audio files are named.  By default, <application>Sound Juicer</application> uses the track
      number followed by a hyphen and the track title.</para>

      <para lang="en">Select the <guibutton>Strip special characters</guibutton> check
      box to make <application>Sound Juicer</application> remove or replace characters such as spaces and
      punctuation in the filenames.  This is useful if you plan to put the audio
      files onto a portable device or another computer which has more limitations
      on file names.</para>

      <note><para lang="en">Even when <guibutton>Strip special characters</guibutton>
      is not selected, <application>Sound Juicer</application> will remove the <literal>/</literal>
      character from filenames.  This character cannot be used in any
      filenames on UNIX, Linux, and similar systems.</para></note>

      <tip><para lang="en">At the bottom of the <guilabel>Track Names</guilabel> section,
      an example path is shown.  This lets you know what a file name might look
      like and where it is placed, according to your settings for <guilabel>Folder
      hierarchy</guilabel>, <guilabel>File name</guilabel>, and <guibutton>Strip
      special characters</guibutton>.</para></tip>
    </section>

    <section id="prefs-format">
      <title lang="en">Selecting a Format</title>

      <para lang="en">You can select which audio file format <application>Sound Juicer</application> uses to store
      your tracks on your computer.  There are a number of available formats,
      each with its own advantages.  The available formats on your computer
      may vary, but the following choices are usually available:</para>

      <variablelist>
        <varlistentry>
          <term lang="en">CD Quality, Lossy (Ogg multimedia)</term>
          <listitem>
            <para lang="en">This option is selected by default.
            <ulink url="http://www.vorbis.org/">Ogg Vorbis</ulink>, like other
            lossy audio formats (such as MP3 and AAC) discards some information
            from the original audio data.  Although the audio file is not a
            perfect replica of the CD audio, the differences are often not
            distinguishable to most listeners.  As a result, lossy formats
            tend to have very small file sizes.</para>

            <para lang="en">The Ogg Vorbis format is the default lossy format used in
            <application>Sound Juicer</application>.  Ogg Vorbis is an open format, developed by the
            <ulink url="http://xiph.org/">Xiph.Org Foundation</ulink>, which
            tends to produce smaller file sizes and higher quality audio than
            many other lossy formats.  While it is not as widespread as the
            older MP3 format, most music software can play Ogg Vorbis files,
            and many hardware players have incorporated support.</para>

            <para lang="en">Xiph.Org maintains lists of <ulink url="http://wiki.xiph.org/index.php/VorbisSoftwarePlayers">software
            players</ulink>, <ulink url="http://wiki.xiph.org/index.php/PortablePlayers">portable
            hardware players</ulink>, and <ulink url="http://wiki.xiph.org/index.php/StaticPlayers">static hardware
            players</ulink> which support Ogg Vorbis.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term lang="en">CD Quality, Lossless (FLAC audio)</term>
          <listitem>
            <para lang="en">The <ulink url="http://flac.sourceforge.net/">FLAC</ulink>
            audio format is a lossless format.  No audio data is lost when
            converting to FLAC, even though it compresses audio files by as
            much as 70%.  FLAC and other lossless formats are popular in
            cases where high fidelity audio is needed, but files need to be
            compressed to save disk space and network transfer times.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term lang="en">CD Quality, AAC (MPEG-4 audio)</term>
          <listitem>
            <para lang="en">The AAC (short for Advanced Audio Coding) audio format is a
            standardized lossy format. It is a successor to the MP3 format and
            it achieves better sound quality than the MP3 format. Many software
            players and hardware players support the AAC format.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term lang="en">Voice, Lossless (WAV audio)</term>
          <listitem>
            <para lang="en">The Voice output profile produces low-quality mono audio
            files.  You may wish to select this for lectures, books on tape,
            and other spoken word CDs, where the loss in audio quality is
            less important.</para>
          </listitem>
        </varlistentry>
        
<varlistentry>
          <term lang="en">MP3</term>
          <listitem>
            <para lang="en">The MP3 audio format is a lossy format. It is widely supported
            and popular, especially because of its use for portable media
            players.</para>
          </listitem>
        </varlistentry>

      </variablelist>

      <para lang="en">You can click the <guibutton>Edit Profiles</guibutton> button to
      edit the available audio formats.  The profile editor dialog provides
      direct access to the audio conversion.  Profiles are defined with
      <application>GStreamer</application> pipelines.
      <application>GStreamer</application> is the underlying multimedia
      library used by <application>Sound Juicer</application> and other multimedia applications.
      A full explanation of audio profiles is outside the scope of this
      document.</para>
    </section>
  </section>

</article>
