www/install.html

   1 <?xml version="1.0"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
   4 <head>
   5         <link rel="stylesheet" href="style.css" type="text/css" />
   6         <title>Installing GSSMP</title>
   7 </head>
   8 <body>
   9
  10 <address><a href="index.html">Home</a> | Install |
  11 <a href="use.html">Use</a> |
  12 <a href="screenshots.html">Screenshots</a> |
  13 <a href="developers.html">Developers</a> |
  14 <a href="contact.html">Contact</a></address>
  15
  16 <h1>Installing GSSMP</h1>
  17
  18 <p>If your Linux distribution provides a package of GSSMP, you should
  19 generally use that, but if not, you should be able to use the binary
  20 package for your distro provided here, or failing that, the generic binary
  21 tarball.</p>
  22
  23 <h2>Before you start</h2>
  24
  25 <p>You will need the GNOME and gstreamer libraries installed,
  26 and you will need gstreamer plugins for the music file formats you want
  27 GSSMP to play.</p>
  28
  29 <p>On most systems with GNOME, everything you need will be installed.  If
  30 you have problems, check out the
  31 <a href="install-prerequisites.html">Prerequisites</a> page.</p>
  32
  33 <p>If you can't play back MP3s (and want to), read the
  34 <a href="install-mp3.html">MP3 playback</a> page.</p>
  35
  36 <h2>Ubuntu</h2>
  37
  38 <p>If you use Ubuntu, download the .deb file from the
  39 <a href="http://sourceforge.net/project/showfiles.php?group_id=187144&amp;package_id=218378">binary
  40 download page</a>, cd into the directory where you downloaded it, and
  41 install it like so:</p>
  42
  43 <p><tt>sudo dpkg --install gssmp-*.deb</tt></p>
  44
  45 <p>You can now run GSSMP from the Audio menu, or by typing:</p>
  46
  47 <p><tt>gssmp</tt></p>
  48
  49 <h2>Debian, MEPIS, Linspire and other Debian-derived distros</h2>
  50
  51 <p>If you use Debian or another Debian-derived distro, the Ubuntu deb file
  52 might work for you.  If it doesn't please get in touch on the developers'
  53 mailing list and help us work out how to fix it!</p>
  54
  55 <p>Also, please get in touch if it does work, so we can update these
  56 instructions.</p>
  57
  58 <h2>Fedora</h2>
  59
  60 <p>If you use Fedora, download the .rpm file from the
  61 <a href="http://sourceforge.net/project/showfiles.php?group_id=187144&amp;package_id=218378">binary
  62 download page</a>, cd into the directory where you downloaded it, and
  63 install it like so:</p>
  64
  65 <p><tt>su -c rpm --install gssmp-*.rpm</tt></p>
  66
  67 <p>You can now run GSSMP from the Audio menu, or by typing:</p>
  68
  69 <p><tt>gssmp</tt></p>
  70
  71 <h2>SUSE, Mandriva, Red Hat and other RPM-based distros</h2>
  72
  73 <p>If you use a different distribution that is RPM-based, the Fedora RPM
  74 might work for you.  If it doesn't please get in touch on the developers'
  75 mailing list and help us work out how to fix it!</p>
  76
  77 <p>Also, please get in touch if it does work, so we can update these
  78 instructions.</p>
  79
  80 <h2>Other distributions</h2>
  81
  82 <p>Most distributions should work fine with the binary tarball (see below).
  83 Just make sure you've installed the prerequisites as explained at the top
  84 of this page.</p>
  85
  86 <p>Please let us know if you get GSSMP working on your distro - we'd love
  87 to explain how to do it here.</p>
  88
  89 <p>We'd also like to hear from people willing to package GSSMP for their
  90 distro.</p>
  91
  92 <h2>Running the binary tarball</h2>
  93
  94 <p>If you are using a different distribution, or have trouble with the
  95 instructions above, try using the binary tarball.</p>
  96
  97 <p>Download the .tar.bz2 file from the
  98 <a href="http://sourceforge.net/project/showfiles.php?group_id=187144&amp;package_id=218378">binary
  99 download page</a> and untar and run it like so:</p>
 100
 101 <p><tt>tar -xjf gssmp-*-bin.tar.bz2<br />
 102 cd gssmp-*-bin<br />
 103 cd bin<br />
 104 ./gssmp</tt></p>
 105
 106 <p>If something goes wrong, email the mailing list (see the
 107 <a href="contact.html">Contact</a> page) and we'll try to help.</p>
 108
 109 <h2>Other operating systems</h2>
 110
 111 <p>To use GSSMP on a non-Linux operating system you will need to do some
 112 investigation - at the very least you will need to compile the program
 113 from source (see the <a href="developers.html">Developers</a> page for
 114 details), and you may need to port other GNOME components to the system
 115 too.</p>
 116
 117 <p>If you do manage to get GSSMP to work on your operating system, please
 118 do get in touch with us - we'd love to have easy-to-install packages for
 119 as many systems as possible.</p>
 120
 121 <h2>Using GSSMP with last.fm</h2>
 122
 123 <p><a href="http://last.fm">last.fm</a> is a web site that collects statistics
 124 about the music you and others are playing and recommends music you might
 125 be interested in.  If you want to get GSSMP to submit information about what
 126 tracks you are playing, you will need to
 127 <a href="install-lastfm.html">install lastfmsubmitd</a>, which is presently
 128 not as easy as it should be.</p>
 129
 130 <div style="float:right"><a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=187144&amp;type=2" width="125" height="37" alt="SourceForge.net Logo" /></a></div>
 131
 132 <address><a href="index.html">Home</a> | Install |
 133 <a href="use.html">Use</a> |
 134 <a href="screenshots.html">Screenshots</a> |
 135 <a href="developers.html">Developers</a> |
 136 <a href="contact.html">Contact</a></address>
 137
 138 </body>
 139 </html>
 140