<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
  <!ENTITY dhfirstname "<firstname>Thomas</firstname>">
  <!ENTITY dhsurname   "<surname>PIERSON</surname>">
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY dhdate      "<date>August 29, 2010</date>">
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
       allowed: see man(7), man(1). -->
  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
  <!ENTITY dhemail     "<email>contact@thomaspierson.fr</email>">
  <!ENTITY dhusername  "Thomas PIERSON">
  <!ENTITY dhucpackage "<refentrytitle>CLEMENTINE</refentrytitle>">
  <!ENTITY dhpackage   "clementine">

  <!ENTITY debian      "<productname>Debian</productname>">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
]>

<refentry>
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
    </author>
    <copyright>
      <year>2010</year>
      <holder>&dhusername;</holder>
    </copyright>
    &dhdate;
  </refentryinfo>
  <refmeta>
    &dhucpackage;

    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>&dhpackage;</refname>

    <refpurpose>A modern music player and library organizer</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&dhpackage;</command>
      <arg><option><replaceable>options</replaceable></option></arg>
      <arg><option><replaceable>URL(s)</replaceable></option></arg>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>

    <para>This manual page documents briefly the
      <command>&dhpackage;</command> commands.</para>

    <para>This manual page was written for the &debian; distribution
      because the original program does not have a manual page.
    </para>

    <para><command>&dhpackage;</command> is modern music player and library organizer.
 It is inspired by Amarok 1.4 and is written to take advantage of Qt4.</para>
    <para>Features :</para>
    <itemizedlist mark='opencircle'>
      <listitem>
	<para>Search and play your local music library.</para>
      </listitem>
      <listitem>
	<para>Listen to internet radio from SomaFM, Magnatune, Jamendo, Intergalactic FM, Digitally Imported, JAZZRADIO.com, ROCKRADIO.com, RadioTunes.com, Soundcloud, Icecast and Subsonic servers.</para>
      </listitem>
      <listitem>
        <para>Search and play songs you've uploaded to Box, Dropbox, Google Drive, and OneDrive.</para>
      </listitem>
      <listitem>
        <para>Create smart playlists and dynamic playlists.</para>
      </listitem>
      <listitem>
        <para>Tabbed playlists, import and export M3U, XSPF, PLS and ASX.</para>
      </listitem>
      <listitem>
        <para>CUE sheet support.</para>
      </listitem>
      <listitem>
        <para>Play audio CDs.</para>
      </listitem>
      <listitem>
        <para>Visualisations from projectM.</para>
      </listitem>
      <listitem>
        <para>Lyrics and artist biographies and photos.</para>
      </listitem>
      <listitem>
        <para>Transcode music into MP3, Ogg Vorbis, Ogg Speex, FLAC or AAC.</para>
      </listitem>
      <listitem>
        <para>Edit tags on MP3 and OGG files, organise your music.</para>
      </listitem>
      <listitem>
        <para>Fetch missing tags from MusicBrainz.</para>
      </listitem>
      <listitem>
        <para>Discover and download Podcasts.</para>
      </listitem>
      <listitem>
        <para>Download missing album cover art from Last.fm.</para>
      </listitem>
      <listitem>
        <para>Native desktop notifications using libnotify.</para>
      </listitem>
      <listitem>
        <para>Remote control using an Android device, a Wii Remote, MPRIS or the command-line.</para>
      </listitem>
      <listitem>
        <para>Copy music to your iPod, iPhone, MTP or mass-storage USB player.</para>
      </listitem>
      <listitem>
        <para>Queue manager.</para>
      </listitem>
    </itemizedlist>  

  </refsect1>
  <refsect1>
    <title>OPTIONS</title>

    <para>These programs follow the usual &gnu; command line syntax,
      with long options starting with two dashes (`-').  A summary of
      options is included below.  For a complete description, see the
      <application>Info</application> files.</para>

    <para>Player options :</para>
    <variablelist>
      <varlistentry>
        <term><option>-p</option>
          <option>--play</option>
        </term>
        <listitem>
          <para>Start the playlist currently playing.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-t</option>
          <option>--play-pause</option>
        </term>
        <listitem>
          <para>Play if stopped, pause if playing.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-u</option>
          <option>--pause</option>
        </term>
        <listitem>
          <para>Pause playback</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-s</option>
          <option>--stop</option>
        </term>
        <listitem>
          <para>Stop playback</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-q</option>
          <option>--stop-after-current</option>
        </term>
        <listitem>
          <para>Stop playback after current track</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-r</option>
          <option>--previous</option>
        </term>
        <listitem>
          <para>Skip backwards in playlist.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-f</option>
          <option>--next</option>
        </term>
        <listitem>
          <para>Skip forwards in playlist.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-v</option>
          <option>--volume &lt;value&gt;</option>
        </term>
        <listitem>
          <para>Set the volume to &lt;value&gt; percent.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--volume-up</option>
        </term>
        <listitem>
          <para>Increase the volume by 4%.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--volume-down</option>
        </term>
        <listitem>
          <para>Decrease the volume by 4%..</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--seek-to &lt;seconds&gt;</option>
        </term>
        <listitem>
          <para>Seek the currently playing track to an absolute position.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--seek-by &lt;seconds&gt;</option>
        </term>
        <listitem>
          <para>Seek the currently playing track by a relative amount.</para>
        </listitem>
      </varlistentry>
    </variablelist>
      
    <para>Playlist options:</para>
    <variablelist>
      <varlistentry>
        <term><option>-c</option>
          <option>--create &lt;name&gt;</option>
        </term>
        <listitem>
          <para>Create a new playlist with files/URLs.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-a</option>
          <option>--append</option>
        </term>
        <listitem>
          <para>Append files/URLs to the playlist.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-l</option>
          <option>--load</option>
        </term>
        <listitem>
          <para>Loads files/URLs, replacing current playlist.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-k</option>
          <option>--play-track &lt;n&gt;</option>
        </term>
        <listitem>
          <para>Play the &lt;n&gt;th track in the playlist</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para>Other options:</para>
    <variablelist>
      <varlistentry>
        <term><option>-h</option>
          <option>--help</option>
        </term>
        <listitem>
          <para>Show summary of options.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-o</option>
          <option>--show-osd</option>
        </term>
        <listitem>
          <para>Display the on-screen-display.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-y</option>
          <option>--toggle-pretty-osd</option>
        </term>
        <listitem>
          <para>Toggle visibility for the pretty on-screen-display</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-g</option>
          <option>--language &lt;lang&gt;</option>
        </term>
        <listitem>
          <para>Change the language</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>--quiet</option></term>
        <listitem>
          <para>Equivalent to --log-levels *:1</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>--verbose</option></term>
        <listitem>
          <para>Equivalent to --log-levels *:3</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
	  <option>--log-levels &lt;levels&gt;</option>
        </term>
        <listitem>
          <para>Comma separated list of class:level, level is 0-3</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>--version</option></term>
        <listitem>
          <para>Print out version information</para>
        </listitem>
      </varlistentry>
    </variablelist>
    
  </refsect1>
 
  <refsect1>
    <title>AUTHORS</title>

    <para>Clementine main developers :</para>
    <itemizedlist mark='opencircle'>
      <listitem>
	<para>David Sansome <email>me@davidsansome.com</email></para>
      </listitem> 
      <listitem>
	<para>John Maguire <email>john.maguire@gmail.com</email></para>
      </listitem>
    </itemizedlist>  

    <para>This manual page was written by &dhusername; &dhemail; for
      the &debian; system (and may be used by others).  Permission is
      granted to copy, distribute and/or modify this document under
      the terms of the &gnu; General Public License, Version 3 any
      later version published by the Free Software Foundation.
    </para>
    <para>
      On Debian systems, the complete text of the GNU General Public
      License can be found in /usr/share/common-licenses/GPL-3.
    </para>

  </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
