= Manual Installation on Mac OS X =

{{{
#!html
<div style="margin:5px; float:right"> <a href="/attachment/wiki/ScreenShots/nicotine_1.2.10svn_on_macos.png"><img src="/attachment/wiki/ScreenShots/thumb_nicotine_1.2.10svn_on_macos.png?format=raw"><br>Running on MacOS<br />(Image was altered to remove<br />usernames for privacy reasons)</a></div>
}}}

 * Install X11 (Tiger and Leopard users can use Mac OS X CD to install, Panther users download it from the [http://www.apple.com/support/downloads/x11formacosx.html Apple website])

 * [http://svn.macports.org/repository/macports/downloads/MacPorts-1.6.0/ Get MacPorts]


 * Open a Terminal (Finder->Applications->Utilities)

 * Install all dependencies required by PyGTK2 (This will take a very long time... yeah really long)
{{{
sudo /opt/local/bin/port install py-gtk2
}}}

You have now two options: Download and extract a release tarball, or checkout the latest development code from the Subversion repository. I recommend using the SVN version.

=== Subversion ===
 * First, install subversion with [http://www.macports.org MacPorts]
{{{         
sudo /opt/local/bin/port install subversion
}}}

Then, download the latest source code from the repository.
{{{
svn checkout http://nicotine-plus.org/svn/trunk/nicotine+ nicotine+
cd nicotine+/
./nicotine
}}}
With the last command, Nicotine+ should start up

=== Release Tarball ===
First download a nicotine+-X.X.X.tar.bz2 (or .gz) file to your Home directory (or any specific directory you know the path to).
For example, if you copied the Bzip (.bz2) archive to your home directory (~/), in a terminal:
{{{
cd ~/
tar jxvf nicotine+-X.X.X.tar.bz2
cd nicotine+-X.X.X/
./nicotine
}}}
For the Gzip (.gz), do:
{{{
tar zxvf nicotine+-X.X.X.tar.gz
}}}


=== Improve Looks ===

{{{
sudo /opt/local/bin/port install gtk-theme-switch
}}}
{{{
sudo /opt/local/bin/port install gnome-themes
}}}
{{{
/opt/local/bin/switch2
}}}

Switch2 will let you choose a theme you like. The fonts are a bit small but you can follow this easy guide to fix that too: 

http://www.macosxhints.com/article.php?story=20080621201901244


= Using Gentoo Prefix =

This process is a lot slower than the other systems, but it requires almost no time '''from you'''. Knowledge of Linux/Gentoo is useful but not crucial. Installing Gentoo Prefix takes 10 hours of compiling on a 1.8 GHz PPC iMac 

 * Install [http://www.gentoo.org/proj/en/gentoo-alt/prefix/index.xml Gentoo Prefix] : [http://www.gentoo.org/proj/en/gentoo-alt/prefix/bootstrap-macos.xml|MacOS Bootstrap process] for Mac OSX
 * [http://www.gentoo.org/proj/en/gentoo-alt/prefix/ecopy.xml ecopy] nicotine. The current ecopy fails to process nicotine+ properly, but the old nicotine works
 * emerge nicotine. We do this to resolve all dependencies, we're not actually interested in using the old version
 * Fix two symlinks with GTK: 
{{{
ln -s $EPREFIX/usr/lib/python2.5/site-packages/gtk-2.0/gio/_gio.so $EPREFIX/usr/lib/python2.5/site-packages/gtk-2.0/gio/_gio.bundle
ln -s $EPREFIX/usr/lib/python2.5/site-packages/gtk-2.0/glib/_glib.so $EPREFIX/usr/lib/python2.5/site-packages/gtk-2.0/glib/_glib.bundle
}}}
 * Now do an SVN checkout on the nicotine+ repository and you should be able to run nicotine+