File: NicotinePlusGuide.html

package info (click to toggle)
nicotine 1.2.9%2Bdfsg-2
links: PTS
area: main
in suites: lenny
size: 6,152 kB
ctags: 2,358
sloc: python: 26,106; ansic: 312; makefile: 69; sh: 37
file content (1975 lines) | stat: -rw-r--r-- 103,935 bytes
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta name="generator" content="HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
<meta http-equiv="Content-Type" content="text/html; charset=us-utf8" />
<title>Nicotine Guide: Single Page</title>

<style type="text/css">

/* Nicotine+ Guide CSS */
body {
background: #fff;
color: #000;
margin: 10px;
padding: 0;
}
body, th, td {
font: normal 13px verdana,arial,'Bitstream Vera Sans',helvetica,sans-serif;
}
h1, h2, h3, h4 {
font-family: arial,verdana,'Bitstream Vera Sans',helvetica,sans-serif;
font-weight: bold;
letter-spacing: -0.018em;
}
h1 { font-size: 19px; margin: .15em 1em 0 0 }
h2 { font-size: 16px }
h3 { font-size: 14px }
hr { border: none; border-top: 1px solid #f37c08; margin: 2em 0 }
address { font-style: normal }
img { border: none }
.underline { text-decoration: underline }
ol.loweralpha { list-style-type: lower-alpha }
ol.upperalpha { list-style-type: upper-alpha }
ol.lowerroman { list-style-type: lower-roman }
ol.upperroman { list-style-type: upper-roman }
ol.arabic { list-style-type: decimal }
/* Link styles */
:link, :visited {
text-decoration: none;
color: #f37c08;
border-bottom: 1px dotted #bbb;
}
:link:hover, :visited:hover {
background-color: #eee;
color: #555;
}
h1 :link, h1 :visited ,h2 :link, h2 :visited, h3 :link, h3 :visited,
h4 :link, h4 :visited, h5 :link, h5 :visited, h6 :link, h6 :visited {
color: inherit;
}
#header {
width:auto;
height: 75px;
background:url("Images/NicotinePlusLogo.png");
background-repeat: no-repeat;
}
/* Navigation */
.nav h2, .nav hr { display: none }
.nav ul { font-size: 10px; list-style: none; margin: 0; text-align: right }
.nav li {
border-right: 1px solid #d7d7d7;
display: inline;
padding: 0 .75em;
white-space: nowrap;
}
.nav li.last { border-right: none }
/* Alternate links */
#altlinks { clear: both; text-align: center }
#altlinks h3 { font-size: 12px; letter-spacing: normal; margin: 0 }
#altlinks ul { list-style: none; margin: 0; padding: 0 0 1em }
#altlinks li {
border-right: 1px solid #d7d7d7;
display: inline;
font-size: 11px;
line-height: 16px;
padding: 0 1em;
white-space: nowrap;
}
#altlinks li.last { border-right: none }
#altlinks li :link, #altlinks li :visited {
background-position: 0 -1px;
background-repeat: no-repeat;
border: none;
}
/* Footer */
#footer {
clear: both;
color: #000;
font-size: 10px;
border-top: 1px solid #f37c08;
height: 31px;
padding: .25em 0;
}
#footer :link {color: #f37c08}, #footer :visited { color: #bbb; }
#footer hr { border: none; }
#footer #tracpowered { border: 0; float: left }
#footer #tracpowered:hover { background: transparent }
#footer p { margin: 0 }
#footer p.left {
float: left;
margin-left: 1em;
padding: 0 1em;
border-left: 1px solid #d7d7d7;
border-right: 1px solid #d7d7d7;
}
#footer p.right {
float: right;
text-align: right;
}
#content { padding-bottom: 2em; position: relative }
#help {
clear: both;
color: #999;
font-size: 90%;
margin: 1em;
text-align: right;
}
#help :link, #help :visited { cursor: help }
#help hr { display: none }
/* Styles for the page editing form */
#edit #rows { float: right; font-size: 80% }
#edit #rows select { font-size: 90% }
#edit #text { clear: both; width: 100% }
#edit .wikitoolbar { float: left; }
#changeinfo { padding: .5em }
#changeinfo .field { float: left; margin: 0 1em .5em 0 }
#changeinfo br { clear: left }
#changeinfo .options { padding: 0 0 1em 1em }
#changeinfo .options, #changeinfo .buttons { clear: left }
#delete { margin-left: 6em }
#preview {
background: #f4f4f4;
margin: 1em 0 2em;
overflow: auto;
}
/* Diff view */
#overview .multi { color: #999 }
#overview .ipnr { color: #999; font-size: 80% }
#overview .comment { padding: 1em 0 0 }
/* Heading anchors */
.anchor:link, .anchor:visited {
border: none;
color: #d7d7d7;
font-size: .8em;
vertical-align: text-top;
visibility: hidden;
}
h1:hover .anchor, h2:hover .anchor, h3:hover .anchor,
h4:hover .anchor, h5:hover .anchor, h6:hover .anchor {
visibility: visible;
}
/* Styles for the page history table
(extends the styles for "table.listing") */
#wikihist td { padding: 0 .5em }
#wikihist td.date, #wikihist td.diff, #wikihist td.version,
#wikihist td.author {
white-space: nowrap;
}
#wikihist td.version { text-align: center }
#wikihist td.comment { width: 100% }
/* Styles for the TracGuideToc wikimacro */
.wiki-toc {
padding: .5em 1em;
margin: 0 0 2em 1em;
float: right;
border: 1px outset #ddc;
background: #ffd;
font-size: 85%;
position: relative;
}
.wiki-toc h4 { font-size: 12px; margin: 0 }
.wiki-toc ul, .wiki-toc ol { list-style: none; padding: 0; margin: 0 }
.wiki-toc ul ul, .wiki-toc ol ol { padding-left: 1.2em }
.wiki-toc li { margin: 0; padding: 0 }
.wiki-toc .active { background: #ff9; position: relative; }
pre.wiki {
width: 85%;
background-color: #cdcdcd;
padding:3px;
border-style: solid;
border-width: 1px
}
p.display {
color: #298d29;
}
.note {
text-align: left;
border-color: black; border-style:dashed; border-width: 1px;
background-color: #eae211; max-width: 600px; min-height:48px; padding: 10px;
}
.tip {
text-align: left; border-color: black; border-style:dashed; border-width: 1px; background-color: #9bb5f8; max-width: 600px; min-height:48px; padding: 10px
}
.explanation {
text-align: left; border-color: black; border-style:dashed; border-width: 1px; background-color: #93b2dd; max-width: 600px; min-height:48px; padding: 10px
}
.warning {
text-align: left; border-color: black; border-style:dashed; border-width: 1px; background-color: #ed6a6a; max-width: 600px; min-height:48px; padding: 10px
}
.windows {
text-align: left; border-color: black; border-style:dashed; border-width: 1px; background-color: #8eb15d; max-width:600px; min-height:48px; padding: 10px
}
.apple {
text-align: left; border-color: black; border-style:dashed; border-width: 1px; background-color: #f3b565; max-width:600px; min-height:48px; padding: 10px
}

</style>
</head>
<body>
<div id="header"></div>
<div id="credit">
<h1>Nicotine+ Guide</h1>
<h3>by Vandy Omall and daelstorm</h3>
view <a href="http://nicotine-plus.sourceforge.net/NicotinePlusGuide/NicotinePlusGuideS.htm">online version</a></div>
<hr />
<div id="content" class="wiki">
<h2>Table of Contents</h2>
<ol>
<li><a href="#Conventions">Conventions Used in This Guide</a></li>
<li><a href="#FAQs">Frequently Asked Questions</a></li>
<li>Installation
<ul>
<li><a href="#Installation-NicotineDependencies">Dependencies</a></li>
<li><a href="#Installation-Linux">Linux</a></li>
<li><a href="#Installation-Windows">Windows</a></li>
<li><a href="#Installation-Apple">Apple</a></li>
</ul>
</li>
<li>Settings
<ul>
<li><a href="#SettingsBasic">Before you connect</a></li>
<li><a href="#SettingsServer">Server</a></li>
<li><a href="#SettingsShares">Shares</a></li>
<li><a href="#SettingsTransfers">Transfers</a>
<ul>
<li><a href="#SettingsEvents">Events</a></li>
<li><a href="#SettingsGeoBlock">Geo Block</a></li>
</ul>
</li>
<li><a href="#SettingsInterface">Interface</a>
<ul>
<li><a href="#SettingsColours">Colours</a></li>
<li><a href="#SettingsIcons">Icons</a></li>
<li><a href="#SettingsNotebookTabs">Notebook Tabs</a></li>
</ul>
</li>
<li><a href="#SettingsChat">Chat</a>
<ul>
<li><a href="#SettingsAway">Away mode</a></li>
<li><a href="#SettingsLogging">Logging</a></li>
<li><a href="#SettingsCensorList">Censor List</a></li>
<li><a href="#SettingsAutoReplace">Auto-Replace</a></li>
<li><a href="#SettingsURLCatching">URL Catching</a></li>
<li><a href="#SettingsCompletion">Completion</a></li>
</ul>
</li>
<li><a href="#SettingsMiscellaneous">Miscellaneous</a>
<ul>
<li><a href="#SettingsBanIgnore">Ban/ignore</a></li>
<li><a href="#SettingsSounds">Sounds</a></li>
<li><a href="#SettingsSearches">Searches</a></li>
<li><a href="#SettingsUserInfo">User info</a></li>
<li><a href="#SettingsImportConfig">Import Config</a></li>
</ul>
</li>
</ul>
</li>
<li>Getting Around
<ul>
<li><a href="#Basics">Basics</a>
<ul>
<li><a href="#BasicsMenus">Menus</a></li>
<li><a href="#BasicsTabs">Tabs</a></li>
<li><a href="#BasicsLogwindow">Log window</a></li>
</ul>
</li>
<li><a href="#ChatRooms">Chat rooms</a>
<ul>
<li><a href="#ChatRoomsMenu">Menus</a></li>
<li><a href="#ChatRoomsCommands">/Commands</a></li>
</ul>
</li>
<li><a href="#PrivateChat">Private chat</a>
<ul>
<li><a href="#PrivateChatMenus">Menus</a></li>
<li><a href="#PrivateChatCommands">/Commands</a></li>
</ul>
</li>
<li><a href="#Downloads">Downloads &amp; Uploads</a>
<ul>
<li><a href="#DownloadsMenus">Menus</a></li>
<li><a href="#DownloadsCommands">/Commands</a></li>
</ul>
</li>
<li><a href="#SearchFiles">Search Files</a>
<ul>
<li><a href="#SearchFiles">Menus</a></li>
</ul>
</li>
<li><a href="#UserInfo">User info</a></li>
<li><a href="#UserBrowse">User browse</a>
<ul>
<li><a href="#UserBrowseMenus">Menus</a></li>
</ul>
</li>
<li><a href="#Interests">Interests</a>
<ul>
<li><a href="#InterestsMenus">Menus</a></li>
</ul>
</li>
<li><a href="#BuddyList">Buddy list</a>
<ul>
<li><a href="#BuddyListMenus">Menus</a></li>
</ul>
</li>
</ul>
</li>
<li>Aliases
<ul>
<li><a href="#AliasNowPlaying">Now Playing</a> (use the NowPlaying dialog for versions &gt;= 1.2.6)</li>
</ul>
</li>
<li>Customization
<ul>
<li><a href="#IconThemes">Icon Themes</a></li>
<li><a href="#SoundThemes">Sound Themes</a></li>
<li><a href="#GtkTheme">How To Change GTK+ Theme</a></li>
<li><a href="#SoulseekPorts">Understanding Soulseek Ports</a></li>
</ul>
</li>
</ol>
</div>
<hr />
<div id="content2" class="wiki">
<ol>
<li>
<h2><a name="Conventions" id="Conventions">Conventions Used in This Guide</a></h2>
<p>Grey background with dark-grey border and black font-color (Used for commands, command output, and switches)</p>
<pre class="wiki">
./nicotine<br />
</pre>
<h3 id="Icons">Icons</h3>
<div class="apple"><img src="Images/Conventions/Apple.png" alt="Apple" align="left" />
<h3>Mac users</h3>
This icon designates a Mac note relating to the surrounding text.</div>
<p><br /></p>
<div class="windows"><img src="Images/Conventions/Windows.png" alt="Windows" align="left" />
<h3>Windows users</h3>
This icon designates a Windows note relating to the surrounding text.</div>
<p><br /></p>
<div class="warning"><img src="Images/Conventions/Warning.png" alt="Warning" align="left" />
<h3>Warning</h3>
This icon designates a warning relating to the surrounding text.</div>
<p><br /></p>
<div class="explanation"><img src="Images/Conventions/Explain.png" alt="Explanation" align="left" />
<h3>Explanation</h3>
This icon shows a situations for better understanding relating to the surrounding text.</div>
<p><br /></p>
<div class="tip"><img src="Images/Conventions/Tip.png" alt="Tip" align="left" />
<h3>Tip</h3>
This icon designates a tip relating to the surrounding text.</div>
<p><br /></p>
<div class="note"><img src="Images/Conventions/Note.png" alt="Note" align="left" />
<h3>Note</h3>
This icon designates a note relating to the surrounding text.</div>
<br /></li>
<li>
<h2><a name="FAQs" id="FAQs">Frequently Asked Questions</a></h2>
<ul>
<li><b>Where do I download Nicotine-Plus?</b><br />
You can download Nicotine-Plus from <a href="http://nicotine-plus.org/">Trac / Wiki</a>, via the <a href="http://nicotine-plus.sf.net">Website</a>, or directly from Sourceforge project <a href="http://sourceforge.net/project/showfiles.php?group_id=171906">file mirrors</a>.</li>
<li><b>Where did Nicotine-Plus originate from?</b><br />
Nicotine-Plus is a fork by daelstorm of <a href="http://nicotine.thegraveyard.org">Nicotine</a>, hyriand's fork of <a href="http://www.sensi.org/%7Eak/pyslsk/">PySoulSeek</a>, Alex Kanavin's original Python/WxGTK client. Several other programmers have contributed to Nicotine-Plus' development.
Check the credits for more information.</li>
<li><b>How do I initiate uploads to my buddies or trusted users?</b><br />
Browse yourself, select the directory or files you want to upload, and right-click to display the popup menu. Select the Upload submenu and choose upload method. A popup dialog with a combo list of your buddies will appear. Select a buddy, or type in a username and press Okay. If the user accepts
uploads from you, it should appear as queued or transferring in your Uploads list.</li>
<li><b>Where's the Mac OS X version?</b><br />
It's quite possible to run Nicotine-Plus on Mac OS X, but there is an significant amount of effort involved. A self-contained package for Nicotine-Plus would be nice, but so far, we have no one with the skill set required for creating one.</li>
<li><b>What are privileges?</b><br />
There are two types of privileges, but they both end up doing the same thing. Having privileges gives you a higher priority in peoples' upload queues, meaning you won't have to wait for <i>your</i> downloads to start as long as you would without privileges. If no other privileged users are in a user's upload queue, you will always get priority.<ul>
<li>The first kind of priority is <b>global privileges</b>. You get global privileges after donating real money to the <a href="http://www.slsknet.org/donate.php">official soulseek website</a>.</li><li> The second kind of privileges is per-user privileges. Depending upon each user's configuration, all or some of their buddies may get privileges.</a></li></ul></li>
</ul>
</li>
<li>
<h2>Installation</h2>
<ul>
<li>
<h2 class="underline"><a name="Installation-NicotineDependencies" id="Installation-NicotineDependencies">Dependencies</a></h2>
<div class="note"><img src="Images/Conventions/Note.png" alt="Note" align="left" />On Linux, the BSDs and Mac OS X, a <a href="http://x.org/">X-Server</a> is required.<br />
If you want to use a Windows installer you only need to install GTK+.</div>
<h3>Required Dependencies</h3>
<ul>
<li><a href="http://www.gtk.org/">GTK2</a> Gimp Tool Kit Version 2 (requires 2.6.x, preferably 2.10.x)</li>
<li><a href="http://www.pygtk.org/">PyGTK2</a> Python Bindings for GTK2 (requires 2.6.x, preferably 2.10.x)</li>
<li><a href="http://www.python.org/">Python</a> Python 2.x or greater</li>
</ul>
<h2 class="underline">Optional Dependencies</h2>
<ul>
<li>PyOGG &amp; <a href="http://ekyo.nerim.net/software/pyogg/">PyVorbis</a> ( OGG metadata support )</li>
<li><a href="http://www.maxmind.com/app/python">GeoIP Python API</a> (Country lookup / blocking support )</li>
<li><a href="http://psyco.sourceforge.net/">Psyco</a> (Speeds up Python Code execution)</li>
<li>Sound Effects
<ul>
<li>ogg123</li>
<li><a href="http://sox.sf.net">soX</a> ( &gt;= 1.2.5 )</li>
<li><a href="http://gstreamer.freedesktop.org/modules/gst-python.html">GStreamer-Python</a> ( &gt; 1.2.7.1 )</li>
</ul>
</li>
<li>The <a href="#TrayIcon">TrayIcon</a> is a Python module the requires the development packages of PyGTK, GTK2 and Python as well as GCC.<br />
<br />
<div class="note"><img src="Images/Conventions/Note.png" alt="Note" align="left" />Nicotine+ &gt; 1.2.7.1 no longer requires the TrayIcon module if you have PyGTK 2.10 and GTK 2.10. The TrayIcon in Windows for older versions used PyWin32, but GTK 2.10 made that unnecessary.</div>
<br /></li>
<li>Spell Checking requires <a href="http://www.chipx86.com/wiki/Libsexy">libsexy and sexy-python</a>. Libsexy uses <a href="http://www.abisource.com/projects/enchant/">Enchant</a>.</li>
<li>Download Notifications requires <a href="http://www.galago-project.org/downloads.php">notification-daemon &amp; notify-python &amp; libnotify</a></li>
</ul>
</li>
<li>
<h2 class="underline"><a name="Installation-Linux" id="Installation-Linux">Nicotine+ Installation: Linux</a></h2>
The easiest way of running Nicotine+ is to download source, untar the tarball and run nicotine straight from the source directory.<br />
To install Nicotine+, you should get a package from your distribution, if possible.<br />
<br />
<ol>
<li>Download the latest release from <a href="http://nicotine-plus.sf.net">nicotine-plus.sf.net</a>.</li>
<li>Extract the tarball
<pre class="wiki">
tar jxvf nicotine+-X.X.X.tar.bz2<br />
</pre>
or
<pre class="wiki">
tar zxvf nicotine+-X.X.X.tar.gz<br />
</pre></li>
<li>Change to the nicotine directory
<pre class="wiki">
cd nicotine+-X.X.X<br />
</pre></li>
<li>Run nicotine
<pre class="wiki">
./nicotine<br />
</pre></li>
</ol>
</li>
<li>
<h2 class="underline"><a name="Installation-Windows" id="Installation-Windows">Nicotine+ Installation: Windows</a></h2>
<p>To get Nicotine working under windows you need to download and install:</p>
<ul>
<li>A new <a class="wiki" href="http://gladewin32.sourceforge.net/modules/wfdownloads/viewcat.php?cid=15">GTK+ 2.10 / Win32</a> installer</li>
<li>A <a class="wiki" href="http://sourceforge.net/project/showfiles.php?group_id=171906&amp;package_id=196557">Nicotine+ windows installer</a>
<ul>
<li>Past versions of nicotine sometimes had Bundle installers.<br />
Bundles usually contained mp3's, application or an ebook. Always provided by the author with permission</li>
<li>Normal, or 'Lite' installer is the Nicotine+ Application, its dependencies, and Source.</li>
</ul>
</li>
</ul>
Installer always allows you to choose what you want to be installed.
<h3>How to install for 1.2.7.1 and greater</h3>
- download &amp; install gtk+-win32-runtime version 2.10 or greater<br />
- download &amp; nicotine+-x.x.x-win32.exe (x.x.x is current version number, choose the latest)<br />
<br /></li>
<li>
<h2 class="underline"><a name="Installation-Apple" id="Installation-Apple">Nicotine+ Installation: Apple</a></h2>
<ul>
<li>Install X11</li>
<li><a href="http://darwinports.com/download/">Get DarwinPorts</a></li>
<li>Open a Terminal (Finder-&gt;Applications-&gt;Utilities)<br /></li>
<li>Install all dependencies required by PyGTK2&nbsp;(This will take a very long time)
<pre class="wiki">
sudo port install py-gtk2
</pre></li>
<li>You have two options: Download and extract a release tarball, or checkout the latest development code from the Subversion repository.</li>
<li style="list-style: none">
<ul>
<li><b>Subversion:<br /></b> First, install subversion with DarwinPorts
<pre class="wiki">
sudo port install subversion
</pre>
Then, download the latest source code.
<pre class="wiki">
svn checkout http://nicotine-plus.org/svn/trunk/nicotine+ nicotine+<br />
cd nicotine+/<br />
./nicotine
</pre></li>
<li><b>A release tarball:</b><a href="#Installation-Linux"><br />
Follow these instructions</a></li>
</ul>
</li>
</ul>
</li>
<li style="list-style: none"><br />
You can also use the ancient <a href="http://sourceforge.net/projects/nicotine-app">nicotine.app</a> for Nicotine 1.0.8 (it's a PPC build)</li>
</ul>
</li>
<li>
<h2>Settings</h2>
<ul>
<li>
<h2 class="underline"><a name="SettingsMain" id="SettingsMain">Settings: Index</a></h2>
When you click on settings name, in this case Connection, you get to see a short explanation of what you can configure.<br />
Connection settings has 3 items. Each can be use to configure settings which suit you the best.<br />
<br />
<ul>
<li><a href="#SettingsServer">Server</a> allows you to configure login/password info.</li>
<li><a href="#SettingsShares">Shares</a> allows you to add files/directories for share</li>
<li><a href="#SettingsTransfers">Transfers</a> allows you to configure upload limits and download filters.</li>
<li><a href="#SettingsInterface">Interface</a> allows you to configure many and varied GUI customizations.</li>

</ul>
</li>
<li>
<h2 class="underline"><a name="SettingsBasic" id="SettingsBasic">Settings: Before you connect</a></h2>
These settings are needed to connect to Soulseek Network or a Soulfind server.<br />
The first time you run Nicotine+, the settings dialog will appear and you should enter the following:<br />
<br />
In <a href="#SettingsServer">Server settings</a>:
<ul>
<li>A <span style="font-weight: bold;">username</span>.</li>
<li>A <span style="font-weight: bold;">password</span>.</li>
</ul>
In <a href="#SettingsShares">Shares settings</a>:
<ul>
<li>The <span style="font-weight: bold;">download directory</span>.</li>
<li>One or more shared directories (or share your download directory).</li>
</ul>
<br />
Now press OK to close the settings window and through the Main Menu select: File-&gt;Connect.<br />
If all goes well, you will be connected to the Soulseek server and automatically join the nicotine chat room.</li>


<li>
<h2 class="underline"><a name="SettingsServer" id="SettingsConnectionServer">Settings: Server</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/server.png" ><img title="Server Settings" src="Images/ScreenShots/thumb_server.jpg"></a>
</div>
Server settings allows you to choose the server you wish to connect to and configure your username, password and connection ports.

<h3>Server</h3>
This combo entry allows you to choose which server and port you want connect to
<ul>
<li>The default server is: <i>server.slsknet.net:2240</i></li>
<li>Unless you know what you doing, leave this option default!</li>
</ul>
<h3>Login</h3>
Fill this entry with your username.
<ul>
<li>If it's the first time you're connecting to Soulseek Network, you may have chosen a username that is already in use.</li>
<li>Look in Log window to see if your username is in use. If it's already used by someone else you'll see an <i>INVALID PASS</i> message, and the settings dialog should reappear with the password entry colored red.</li>
<li>If it's not in use, well, you'll just connect and enjoy Nicotine+, Soulseek Network and the whole experience :)</li>
</ul>
<br />
<h3>Password</h3>
Fill this entry with your password. It will be hidden while you type it.<br />
<div class="warning"><img src="Images/Conventions/Warning.png" alt="Warning" align="left" />Choose a password carefully. There is no way to recover password you've lost. If this is a concern for you, backup your config files.</div>
<h3>Network Character Encoding</h3>
This allows you to choose the default encoding for all strings (such as transfer filenames, shares, and chat messages)
<ul>
<li>By default, it's <i>UTF-8</i></li>
<li>If you are frequently accessing the shares of users without the benefit of unicode (utf-8), you can change this to something more relavent. Some European and Asian language encodings aren't compatible with UTF-8 (Microsoft's codepages are a good example).</li>
</ul>
<br />
<h3>Client connection ports</h3>
This is a range of possible ports that is used by Nicotine+ to connect to peers, and for peers to connect to you.
<ul>
<li>By default, the range is <i>2234 - 2239</i>. Only one port is used a time, and that port is the first unused one in the range. If no ports in the range are available, you will experience catastrophic connection failure. :)</li>
<li>There's a short guide on <a href="http://thegraveyard.org/daelstorm/soulseekports.php">Soulseek Ports</a> by daelstorm</li>
<h3>I can receive direct connections</h3>
<li>If ports are open and can receive direct connection, check that box</li>
</ul>
<h3>CTCP VERSION</h3>
This allows other users to check which version Nicotine+ you have. 
<ul>
<li>By default, it's <i>checked</i></li>
<li>If other users have this option checked, you can check their version.</li>
<li>You do this in Private chat session with the <b>Client Version</b> item in the popup menu or the /ctcpversion command.</li>
</ul>
</li>
</ul>
<ul>
<li>
<h2 class="underline"><a name="SettingsShares" id="SettingsConnectionShares">Settings: Shares</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/shares.png" ><img title="Shares Settings" src="Images/ScreenShots/thumb_shares.jpg"></a>
</div>
Shares allows you to configure your Download and Shared files directories<br />
<br />
Your shares will automatically be scanned after you add or remove shared directories if you save your changes in the settings window by pressing the <b>Ok</b> or <b>Apply</b> buttons.<br />
You can manually rescan from the <b>Edit</b> menu or /rescan. Rebuilding shares does not use <acronym title="Modified Time">mtime</acronym> to determine whether to rescan a directory. Rebuilding instead of rescanning is neccessary with FAT filesystems.
<br />
One or more progress bars (depending whether you have Buddy-only Shares enabled) will show you the shares scanning progress.<br />
<br />
In Log window&nbsp;you can see messages:
<ul>
<li><i>Rescanning started</i> shows that scanning of your shared folders is started</li>
<li><i>Rescanning finished</i> shows when scanning is finished</li></ul>

<h3>Incomplete directory</h3>
<ul>
<li>Choose where temporary incoming files should be stored. This is optional, and by leaving it blank all incomplete downloads will be stored in the Download directory.<br /></li>
<li>After a file is finished downloading, it is then moved to&nbsp;your chosen Download directory (see below)</li>
</ul>
<h3>Download directory</h3>
<ul>
<li>
Choose where the finished downloads should be stored. It's a good idea to place this directory separate from your incomplete files if you plan to share downloads.
</li><li>For example: /home/your_username/Soulseek Downloads
</li>
</ul>
<h3>Share download directory</h3> This allows you to share your download directory, which will also add new completed downloads to you shares immediately.<br />
<div class="windows"><img src="Images/Conventions/Windows.png" alt="Windows" align="left" />If you want to sort out your downloads by moving files to their appropriate location, do NOT check "Share download directory", since Windows cannot move files while they're in use. (getting downloaded by
others)</div>
<h3>Upload directory</h3>
<ul>
<li>
Choose where finished remotely-initiated downloads should be stored (Your buddies will manually upload files to subdirectories (of their usernames) to this directory.
</li><li>It's a good idea to place this directory separate from your downloads, or in a special <b>uploads</b> subdirectory to avoid confusion.
</li><li>For example: /home/your_username/Soulseek Uploads
</li>
</ul>
<h3>Rescan shares on startup</h3>
This will automatically rescan your shares every time you start Nicotine+. If you often move or rename files and directories, enable this.<br />
<div class="tip"><img src="Images/Conventions/Tip.png" alt="Tip" align="left" />If you rename or move files and do not rescan your shares afterwards, you may get many annoyed people complaining about File errors? If you want to have a good way of keeping your collection sorted, so it's easy for you and
others, browse users who share lots of files to see how they have sorted their collection. Watch, learn and do the same.</div>
<h3>Shares list</h3>
<ul>
<li>
This is a list of shared directories. Use the <b>Add</b> and <b>Remove</b> buttons to select directories you wish to share.
</li><li>If you're using Linux or another Unix-like operating system, you can create symlinks to provide a better layout for your shares. I.E. instead of sharing /home/your_username/Media/Music, you could create a symlink from /home/your_username/Media/Music to /Music and share /Music, instead. Creating a symlink in the / directory requires root, of course.
</li>
</ul>
<br />
<h3>Buddy-only shares</h3>

<ul>
<li>Enable this option if you want to have files which only people in your Buddy list are allowed to download. Then, add the directories, like in the normal shares.</li>
<li>Buddy-only shares includes normal shares, so there's no need to add the same directories to Buddy-only shares.</li>
</ul>
</li>


<h2 class="underline"><a name="SettingsTransfers" id="SettingsConnectionTransfers">Settings: Transfers</a></h2>

<div style="float: right;">
<a href="Images/ScreenShots/transfers_upload.png" ><img  title="Upload Queue" src="Images/ScreenShots/thumb_transfers_upload.jpg"></a><br />
<a href="Images/ScreenShots/transfers_filters.png" ><img  title="Download Filters" src="Images/ScreenShots/thumb_transfers_filters.jpg"></a></div>
Transfer settings allows you to configure how uploads are queued and what privileges you give to Buddies
<h2>Upload queue</h2>
<h3>Upload queue type</h3>
Set the queue method here.
<ul>
<li><b>Round-robin</b> uploads one file to each user and the changes to another user.</li>
<li><b>First in, First out</b> will upload in the order of oldest-queued to newest queued.</li>
</ul>
<h3>Queue Uploads if total transfer speed reaches __ KBytes/sec</h3>
<ul>
<li>By default it's <i>10</i></li>
<li>When transfer speeds go over this limit new transfers will be queued.</li>
</ul>
<h3>Limit number of upload slots to ___</h3>
This option allows you to limit the maxiumum number of files that can be uploaded at the same time.
<ul>
<li>By default it's unchecked</li>
<li>It's recommended to leave it unchecked because automatic upload slot control is more efficient. For example, if you only have one upload slot, and you have a user who is downloading from you very slowly, then your upload bandwidth will be unused when you may have other people waiting in your queue.</li>
<br />
<div class="note"><img src="Images/Conventions/Note.png" alt="Note" align="left" />One user CANNOT download 2 files from you at the same time. When you limit your upload slots to 2 files, then two different users can each download 1 file from you, for a total of 2 files uploaded. When 3 users are
trying to download from you, 2 users will download while the third user has to wait.</div>
</ul>
<h3>Limit upload speed</h3>
This allows you to choose at which speed file(s) gets uploaded and by which method to limit it: <b>per transfer</b> or <b>total transfers</b>
<ul>
<li>By default it's unchecked</li>
<li>You should definitely enable this, or your download bandwidth will likely saturated by your uploads. Limit this to a number slightly below your real maximum upload bandwidth if you use it with <b>total transfers</b>.</li>
</ul>
<br />

<h2>Each user may queue a maximum of ...</h2>
This allows you to set a maximum queue in Megabytes and number of files. These options are designed to limit leechers from abusing your upload queue.
<ul>
<li>By default the size limit is <i>100</i> Megabytes (approximately one album)</li>
<li>By default the number of files limit is <i>1000</i></li>
</ul>
<br />
<div class="explanation"><img src="Images/Conventions/Explain.png" alt="Explanation" align="left" />When a user downloads more than the allowed maximum file size or number of files they will not be placed in your upload queue and the user will see a message in their transfers list.</div>
The user gets to see the following message: <i>Remote: User limit of xx megabytes exceeded</i><br />
When a user clicks on a single video file (say 700MB) and then some other files, you will only have the see the video file in your upload queue. <br />
<h3><a name="SettingsTransfersAllowSend" id="SettingsTransfersAllowSend">Allow these users to send you files</a></h3>
Allows a specific group of users that you've selected to send you files.
<ul>
<li>By default it's <i>Users in list</i></li>
<li>The other options are: No one, Everyone, and Trusted Users</li>
<li>The files these users send you will be saved in the <b>Uploads directory</b></li>
</ul>

<h2>Privileges</h2>
<h3>Share to friends only</h3>
This allows only people who're in Buddy list to download your shares. If you have <b>buddy shares</b> enabled, they will obviously be getting them instead of your <b>normal shares</b>.
<ul>
<li>By default it's <i>unchecked</i></li>
</ul>

<div class="tip"><img src="Images/Conventions/Tip.png" alt="Tip" align="left" />If you're going to use this option, make sure you put this in your User info, since there's no obvious way to detect it otherwise.</div>
<br />
<h3>Privilege all my friends</h3>
This allows all users in your Buddy list to download before other non-privileged users. This effectively makes your buddies equal to privileged users.<br />

<div class="explanation"><img src="Images/Conventions/Explain.png" alt="Explanation" align="left" />If some users are downloading, and one Buddy queues some files, he/she gets to download first, always. Privileged users have a monopoly on your queue and alway get preferential treatment.</div>
<h2>Download Filters</h2>
<h3>Enable filters</h3>
This allows to <b>filter</b> out unwanted files in your download queue. This is useful for when you download a folder that has useless or unneeded metadata files.
<ul>
<li>By default it's <i>checked</i></li>
</ul>
<h3>Verify filters</h3>
This will check the filters' regular expression syntax for errors and display a message if there are problems.
<h3>Filters list</h3>
This is a list of regular expressions that downloads will be matched against. You can Add, Edit and Remove filters and also Load Defaults, which will reset filters.
<ul>
<li>Filters with escaping enabled will escape non-ascii characters (it's a lot simpler and prettier) and <b>*</b> will be replaced with <b>.*</b>, which is any length of any kinds of characters.
</li><li>Escaping non-ascii characters makes the regular-expression treat them as <b>real</b> characters instead of syntax.
</li><li>For example, the escaped filter <b>*.url</b> will be invisibly converted to <b>.*\.url</b>. Unescaping it will result in a regexp error, since <b>*</b> will need a character to preceed it.
</li><li>For more information, Google "python regular expressions" or read this <A href="http://www.amk.ca/python/howto/regex/regex.html">Regular Expression Howto</a>.
</li>
</ul>


<h3>Lock incoming files</h3>
This allows you to lock incomplete files, so these cannot be accessed by other processes. (Required for some filesystems)
<ul>
<li>By default it's <i>checked</i></li>
</ul>
<div class="tip"><img src="Images/Conventions/Tip.png" alt="Tip" align="left" />If you have the same Incomplete and Download directory (the default setting), it's a good idea to keep this option checked.</div>

</li>
<li>
<h2 class="underline"><a name="SettingsEvents" id="SettingsEvents">Settings: Events</a></h2>
<div style="float: right;">

<a href="Images/ScreenShots/transfers_events.png" ><img title="Transfer Events" src="Images/ScreenShots/thumb_transfers_events.jpg"></a>
</div>
Event settings allow you to configure which command or application is to be executed after a download is finished.
<h3>Show notification-popup in tray after download</h3>
This feature requires notification-daemon, notify-python, libnotify. You can get more information at the <a href="http://www.galago-project.org/downloads.php">website</a>.
<h2>Commands</h2>

<h3>Run command after download finishes</h3> 
This allows you to run a command or application after download of 1 file is finished.
<br />
Example: <b>xmms -e $</b>
<h3>Run command after folder finishes</h3> 
This allows you to run a command or application after download of 1 folder is finished.
<h3>File manager command</h3> 
This allows you to launch a filemanager to view a folder
<br />
Example: <b>rox $</b>

</li>
<li>
<h2 class="underline"><a name="SettingsGeoBlock" id="SettingsConnectionGeoBlock">Settings: Geo Block</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/transfers_geoblock.png" ><img title="GeoBlock Settings" src="Images/ScreenShots/thumb_transfers_geoblock.jpg"></a>
</div>
<div class="note"><img src="Images/Conventions/Note.png" alt="Note" align="left" />This option is NOT available for Nicotine+ Windows version. Geo Block allows you to block specific users from a country.</div>
<h2>Enable geographical blocker</h2>
When checked you can configure 2 options as explained below.
<h2>Geographical paranoia</h2>
Blocks users who possibly use proxy server to hide their real IP
<h2>Country codes</h2>
Use this option to block users from specific countries by typing country codes separated by comma (,)<br />
example: us,nl,pl,se,de blocks the USA, Netherlands, Poland, Sweden and Germany</li>
<li>

<h2 class="underline"><a name="SettingsInterface" id="SettingsInterface">Settings: Interface</a></h2>
<ul><li><a href="#SettingsColours">Colours</a></li>
<li><a href="#SettingsIcons">Icons</a></li>
<li><a href="#SettingsNotebookTabs">Notebook Tabs</a></li>
</ul>
<div style="float: right;">
<a href="Images/ScreenShots/interface_notranslation.png" ><img title="Interface" src="Images/ScreenShots/thumb_interface_notranslation.jpg"></a><br>
<a href="Images/ScreenShots/interface_translation.png" ><img title="Interface translation enabled" src="Images/ScreenShots/thumb_interface_translation.jpg"></a>
</div>
<br />
<i>Interface</i> allows you to enable the spellchecker, the translation override, tooltips and chat font, decimal separator and whether to show buttons at the bottom of the transfers tabs.<br />
<h3>Enable spell checker</h3>
This feature requires libsexy and sexy-python. You can get more information from their <A href=" http://www.chipx86.com/wiki/Libsexy">website</a>. This feature is for chat entry boxes. Right click on a red-underlined (a mispelled or unknown) word to see a list of possible correct ones.

<h3>Show buttons in transfer tabs</h3>
These buttons are duplicates of several items in your uploads and downloads popup menus. While redundant, leaving them visible will save you a few clicks.
<h3>Show tooltips</h3>
Scattered throughout the GUI, certain widgets - such as Buttons and ComboLists - have tooltips that popup when you hover the mouse over them. In some cases this can be annoying. Disable them with this option.
<h3>Chat font</h3>
All text in the textviews will use this font.
<ul>
<li>If no font is selected, the default font for your GTK theme will be used.</li>
<li>The clear button will reset the font to the default font of the GTK theme.</li>
</ul>
<h3>Decimal Seperator</h3>
This is the character used for seperating numbers, such as <b>1000</b> to <b>1,000</b>.
<h3>Translate to another language</h3>
Enabling this will cause an override of the system's language settings
<ul>
<li>The Language selector is blank by default.. it will use the English strings instead of the language set by your operating system's Locale.
<li>Select a language code to use after restarting. (Don't forget to save your settings first)</li>
<li>For an example of setting the translation to Polish see this <a href="Images/ScreenShots/interface_translation.png" >Screenshot</a></li>
</ul>

</li>
<li>
<h2 class="underline"><a name="SettingsColours" id="SettingsColours"></a>Settings: Colours</h2>
<div style="float: right;">
<a href="Images/ScreenShots/colours_chat.png" ><img title="Chat Colours" src="Images/ScreenShots/thumb_colours_chat.jpg"></a><br>
<a href="Images/ScreenShots/colours_list_and_tab.png" ><img title="List and Tab Colours" src="Images/ScreenShots/thumb_colours_list_and_tab.jpg"></a>
<br>
<a href="Images/ScreenShots/colours_transparent.png" ><img title="Transparent Logs" src="Images/ScreenShots/thumb_colours_transparent.jpg"></a>
</div>
<h2>Chat colours</h2>
Which colours the various text messages will get displayed as in Chat Rooms and Private Chat<br />
<br />
<div class="note"><img src="Images/Conventions/Note.png" alt="Note" align="left" />Chat color settings are only for you, other users will the colours they've selected.</div>
<h3>Remote text</h3> This the color of other users in the chat logs
<ul><li>By default, it's <b>unset</b></li></ul>

<h3>Local text</h3> These are your messages, you see them in Chat room and Private chat sessions
<ul><li>By default, it's <font style="color: #0000FF; font-weight: bold;">BLUE</font></li></ul>

<h3>/me text</h3> This is used to state what you're doing instead of talking</li>
<ul><li>By default, it's <font style="color:#228B22; font-weight: bold;">FORREST GREEN</font></li>
<li>"/me is going to eat something" shows up as "timestamp * user is going to eat something"</li>
<li><font style="color:#228B22">01:07:01 * user is testing</font></li>
<li><font style="color:#228B22">21:06:55 * user checks timestamps and stops expecting an answer</font></li></ul>

<h3>Highlighted text</h3> This is a message that includes your username</li>
<ul><li>By default, it's <font style="color: #FF0000; font-weight: bold;">red</font></li></ul>

<h3>URL Link text</h3> This is a http:// or other URL link</li>
<ul><li>By default, it's <font style="color: #3D2B7F; font-weight: bold;">#3D2B7F</font></li></ul>
<h2>Username colours and hotspots</h2>
Enable this for usernames in chat room logs can have popup menus and colours and font styles.
<h3>Display away colours</h3>
If this is disabled (as it is by default) usernames will not change colour when a user goes away.
<h3>Online</h3>
<ul><li>By default, it's <font style="color: BLACK; font-weight: bold;">BLACK</font></li></ul>
<h3>Offline</h3>
<ul><li>By default, it's <font style="color: #AA0000; font-weight: bold;">#AA0000</font></li></ul>
<h3>Away</h3>
<ul><li>By default, it's <font style="color: orange; font-weight: bold;">Orange</font></li></ul>
<h3>Username Font Style</h3>
The font style for usernames can be <b>bold</b>, <i>italic</i>, normal, or <u>underlined</u>.
<h2>List and Search colors</h2>
To make searching and downloading files easier, you can choose to color your search results
<h3>List text</h3>
<ul><li>By default, it's colour is unset</li>
</ul>

<h3>With queue</h3>
Search results that have a queue
<ul><li>By default, it's <font style="color: GREY; font-weight: bold;">GREY</font></li>
</ul>
<h3>Offline search</h3>
Search results of users who are now offline
<ul><li>By default, it's <font style="color: #AA0000; font-weight: bold;">#AA0000</font></li>
</ul>

<h3>Background</h3>
The background colour for lists and other widgets.
<ul><li>By default, it's unset</li>
</ul>

<h3>Input text</h3>
The foreground (text) colour for text entry widgets.
<ul><li>By default, it's unset</li>
</ul>

<h2>Tab colors</h2>
<h3>Default</h3>
The normal tab text colour.
<ul><li>By default, it's unset</li>
</ul>

<h3>Changed</h3>
The notification tab text colour.
<ul><li>By default, it's <font style="color: #0000FF; font-weight: bold;">#0000FF</font></li>
</ul>

<h3>Highlight</h3>
Higher priority notification tab text colour.
<ul><li>By default, it's <font style="color: red; font-weight: bold;">Red</font></li>
</ul>

<h2>Transparent Log Windows</h2>
This feature draws the root window in the background of the textviews (chat logs, etc) with configurable amount of colour and alpha (transparency).

</li>
<li>
<h2 class="underline"><a name="SettingsIcons" id="SettingsIcons">Settings: Icons<br /></a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/interface_icons.png" ><img title="Icons" src="Images/ScreenShots/thumb_interface_icons.jpg"></a>
</div>
<h2>Icon Theme Directory</h2>
<div class="note"><img src="Images/Conventions/Note.png" alt="Note" align="left" />This feature is available from Nicotine+ 1.2.4 and up.</div>
Select a directory with images and Nicotine+ will use for online/offline/away/hilite indication.</li>
<li>By default, it's <i>empty</i></li>
<li>
<h2 class="underline"><a name="SettingsNotebookTabs" id="SettingsNotebookTabs">Settings: Notebook Tabs<br /></a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/interface_notebook.png" ><img title="Notebook tabs" src="Images/ScreenShots/thumb_interface_notebook.jpg"></a>
</div>
<h2>Close button on tabs</h2>
If you want to have close buttons in tab labels
<ul><li>By default, it's <i>checked</i></li></ul>

<h2>Notification icons on tabs</h2>
If you want to have icons appear in tab labels
<ul><li>By default, it's <i>checked</i></li></ul>

<h2>Notification changes the tab's text colour</h2>
If you want to have coloured text in tab labels
<ul><li>By default, it's <i>unchecked</i></li>
<li>Set these colours in the Colours settings</li></ul>

<h2>Tab positions</h2>
You can align each notebook's tabs along the top, left, right and bottom and change the angle of the text plus or minus 90⁰ from level.
<ul><li>By default, they're all <i>Top</i> and 0⁰</li>
</ul>

</li><li>
<h2 class="underline"><a name="SettingsChat" id="SettingsChat"></a>Settings: Chat</h2>
<ul>
<li><a href="#SettingsAway">Away mode</a> allows you to configure your auto-way settings</li>
<li><a href="#SettingsLogging">Logging</a> allows you to configure what's logged and where to save the logs</li>
<li><a href="#SettingsCensorList">Censor List</a></li>
<li><a href="#SettingsAutoReplace">Auto-Replace</a></li>
<li><a href="#SettingsURLCatching">URL Catching</a> allows you to choose which application should start after you click a link</li>
<li><a href="#SettingsCompletion">Completion</a></li>
</ul>
</li>
<li>
<h2 class="underline"><a name="SettingsAwayMode" id="SettingsAwayMode">Settings: Away mode</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/chat_away.png" ><img title="Away" src="Images/ScreenShots/thumb_chat_away.jpg"></a>
</div>
<h2>Toggle away</h2>
If you're gone behind your PC after xx minutes then your status changes in "away".<br />
Your status icon in chat rooms and elsewhere will change to the <b>away</b> icon.
<ul>
<li>By default, it's <i>15</i> minutes</li>
</ul>
<h2 id="Autoreply">Auto reply</h2>
Here, you can configure a message that users get to see when they start a Private chat with you while you're set <b>away</b>. If no message is set, no message will be sent.
<ul>
<li>By default, it's <i>empty</i></li>
</ul>
</li>
<li>
<h2 class="underline"><a name="SettingsLogging" id="SettingsLogging">Settings: Logging</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/chat_logging.png" ><img title="Logging" src="Images/ScreenShots/thumb_chat_logging.jpg"></a>
</div>
Chat room and Private chats can be logged if you want to keep track of your (important) conversations
<h2>Log private chat by default</h2>
<ul>
<li>By default, it's <i>unchecked</i> (disabled)</li>
</ul>
<h2>Log chatrooms by default</h2>
<ul>
<li>By default, it's <i>unchecked</i> (disabled)</li>
</ul>
<h2>Log transfers</h2>
Keeps logs of you down/uploads
<ul>
<li>By default, it's <i>unchecked</i> (disabled)</li>
</ul>
<h2>Logs directory</h2>
Where logs are saved.
<ul>
<li>By default, it's <i>/root</i></li>
</ul>
<h3>How to change Logs directory</h3>
<ul>
<li>Click on <i>Choose</i></li>
<li>Navigate to your chosen folder</li>
<li>Click <i>OK</i></li>
<li>Click <i>Apply</i> or <i>OK</i></li>
</ul>
</li><li>
<h2 class="underline"><a name="SettingsCensorList" id="SettingsCensorList">Settings: Censor List</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/chat_censor.png" ><img title="Censor List" src="Images/ScreenShots/thumb_chat_censor.jpg"></a>
</div>
<ul>
<li>
This is a list of words that other people say in chat which will be replaced with some character (<b>*</b> by default). If you say these words, they will not be censored.
</li><li>
This feature is disabled by default, but can be enabled by the <b>Enable Censorship</b> checkbox.</li>
</li><li>You can <B>Add</B> and <b>Remove</b> individual words, or <b>Clear</b> to empty the list</li>
</ul>
</li><li>

<h2 class="underline"><a name="SettingsAutoReplace" id="SettingsAutoReplace">Settings: Auto-Replace</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/chat_replace.png" ><img title="Auto-Replace" src="Images/ScreenShots/thumb_chat_replace.jpg"></a>
</div>
<ul>
<li>This is a list of strings that will be replaced before they get sent in a chat message. This is good for common typos and the default list has of some of those.
</li><li>
This feature is disabled by default, but can be enabled by the checkbox.</li><li>
You can select any character to replace the letters in the censored words.
</li>
</ul>

</li><li>

<h2 class="underline"><a name="SettingsURLCatching" id="SettingsURLCatching">Settings: URL Catching</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/chat_url.png" ><img title="URL Catching" src="Images/ScreenShots/thumb_chat_url.jpg"></a>
</div>
When some user gives an URL in Chat room or Private chat, Nicotine+ is able to open a browser and go to the given homepage.<br />
This window allows you to choose which browser you want to use.<br />
<br />
<div class="note"><img src="Images/Conventions/Note.png" alt="Note" align="left" />URL Catching only works in not just in Chat rooms and Private chat, but in pretty much any TextView, including some of the about dialogs.</div>
<h2>Enable URL catching</h2>
<ul>
<li>By default, it's <i>checked</i></li>
<li>If disabled, URLs will not be underlined or clickable, and, even if you enable it later, old URLs will not be clickable.</li>
</ul>
<h2>Humanize slsk: // urls</h2>
This will replace the ugly characters, like %20, with human-readable stuff.
<ul>
<li>By default, it's <i>checked</i></li>
</ul>
<h2>Protocols handlers</h2>
allows you to choose which handler suppose to handle which protocol
<ul>
<li>By default, the protocol list contains <i>http</i> and <i>https</i></li>
<li>The default handler is <i>firefox "%s"</i></li>
</ul>
<div class="note"><img src="Images/Conventions/Note.png" alt="Note" align="left" />You can only have one handler for each protocol.</div>
<h3>Adding a new protocol &amp; handler</h3>
<ul>
<li>Fill in the <i>protocol</i> entry with your desired protocol.</li>
<li>Fill in the <i>handler</i> entry with your desired application command. <b>%s</b> is the URL, and should probably be surrounded by quotes. You can also choose from a set of predefined handlers in the combolist.</li>
<li>Click <b>Add</b></li>
</ul>
<h3>Remove a protocol handler</h3>
<ul>
<li>Click on specific handler, for example <i>http | firefox "%s"</i></li>
<li>Click <b>Remove</b></li>
</ul>
<div class="explanation"><img src="Images/Conventions/Explain.png" alt="Explanation" align="left" />"http" is for webpages, "ftp" is for FTP servers. Depending on what kind of protocol you and your buddies use all the time you can add new protocols.</div>


</li><li>
 
<h2 class="underline"><a name="SettingsCompletion" id="SettingsCompletion">Settings: Completion</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/chat_completion.png" ><img title="Tab Completion" src="Images/ScreenShots/thumb_chat_completion.jpg"></a>
</div>
There are a multitude of options for configuring tab completion and the dropdown completion list.
</li><li>

<h2 class="underline"><a name="SettingsMiscellaneous" id="SettingsMiscellaneous">Settings: Miscellaneous</a></h2>
<ul>
<li><a href="#SettingsBanIgnore">Ban / ignore</a> let's you manage your ban, ignore and IP blocking lists</li>
<li><a href="#SettingsSounds">Sounds</a> allows you to configure sound settings</li>
<li><a href="#SettingsSearches">Searches</a> allows you to configure search settings and set default filters</li>
<li><a href="#SettingsUserInfo">User info</a> allows you to add text and an image to your personal info</li>
<li><a href="#SettingsImportConfig">Import Config</a> allows you import config settings from the official windows clients. (I.E. versions 156, 157)</li>
</ul>

<h2 class="underline"><a name="SettingsBanIgnore" id="SettingsBanIgnore">Settings: Ban / ignore</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/misc_ban.png" ><img title="Ban / Ignore / Block" src="Images/ScreenShots/thumb_misc_ban.jpg"></a>
</div>
When you Ban or Ignore users via Chat room or Private chat they get listed here.
<h2>Banned Users</h2>
List of banned users. Banned users are blocked from downloading from you and from viewing your shares
<ul>
<li><i>Add</i> allows you to add a new user by typing their name</li>
<li><i>Remove</i> allows you to remove a banned user from the list (unbanning the user)</li>
<li><i>Clear</i> removes all users in ban list</li>
</ul>

<h2>Ignored Users</h2>
List of ignored users. Ignored users will disappear from chat rooms and private chat
<ul>
<li><i>Add</i> allows you to add a new user by typing their name</li>
<li><i>Remove</i> allows you to remove an ignored user from the list (new chats from them will appear in Chat room and Private chat)</li>
<li><i>Clear</i> removes all users in ignore list</li>
</ul>

<h2>Blocked IP Addresses</h2>
This is a list of blocked IP address. Both incoming and outgoing connections are blocked. Port ranges are allowed by using a <b>*</b> as a wildcard.
<ul>
<li><i>Add</i> allows you to add an IP</li>
<li><i>Remove</i> allows you to remove an IP from the list (you will be able to (attempt to) connect to this IP)</li>
<li><i>Clear</i> removes all users in block list</li>
</ul>

<h2>Use custom ban message</h2>
Enabling this will cause Nicotine to automatically send this message when a banned user tries to download a file from you. (It will appear in the transfer as an error message)
</li><li>

<h2 class="underline"><a name="SettingsSounds" id="SettingsSounds">Settings: Sounds</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/misc_sounds_effects.png" ><img title="Sounds" src="Images/ScreenShots/thumb_misc_sounds_effects.jpg"></a><br />
<a href="Images/ScreenShots/misc_sounds_tts.png" ><img title="Sounds" src="Images/ScreenShots/thumb_misc_sounds_tts.jpg"></a>
</div>
Sound effects are short ogg vorbis audio files.
<h3>Enable Sound effects</h3>
You will be able to select an OGG audio player to play the sound effects
<h3>Enable Text to Speech</h3>
You will be able to select a command to read strings and output them as synthesized speech.
<h3>Audio player command</h3>
Launch an external process to read a local file (a partial or completed download, an upload, or a file in your own shares).
</li><li>

<h2 class="underline"><a name="SettingsSearches" id="SettingsSearches">Settings: Searches</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/misc_searches.png" ><img title="Searches" src="Images/ScreenShots/thumb_misc_searches.jpg"></a>
</div>
<h2>Network searches</h2>
Sends out a maximum of xx results per search request
<ul>
<li>By default, it's <i>50</i></li>
</ul>
<div class="explanation"><img src="Images/Conventions/Explain.png" alt="Explanation" align="left" />Let's say you have 2898 wu family related files. When some user searches for "wu" or "wu tang" only the first 50 results are sent out to user whose searches match your files.</div>
<br />
<h2>Your searches</h2>
<ul>
<li><i>Use regular expressions for filter in &amp; out</i></li>
<li><i>Filter in</i></li>
<li><i>Filter out</i></li>
<li><i>Size</i></li>
<li><i>Bitrate</i> set bitrate of (mp3, OGG, xx) you only want, 128, 192, 320 for example</li>
<li><i>Country</i> set search results from countries you want, example: file has English title, but creator is from Netherlands.</li>
<li><i>Free slot</i> displays users who have xx slots open, for faster download start</li>
</ul>
</li>
<h2 class="underline"><a name="SettingsUserInfo" id="SettingsUserInfo">Settings: User info</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/misc_userinfo.png" ><img title="User info" src="Images/ScreenShots/thumb_misc_userinfo.jpg"></a>
</div>
When users request your User info, they get to see some info provided by you. You can provide that kind of info here.
<h2>Self description</h2>
Put here what you want others to know.<br />
<br />
<div class="note"><img src="Images/Conventions/Note.png" alt="Note" align="left" />You can only add plain text. HTML and BB tags won't work.</div>
<div class="tip"><img src="Images/Conventions/Tip.png" alt="Tip" align="left" />If you have a webpage or profile somewhere, add it here, instead of having a long self description</div>
<br />
<h2>Image</h2>
picture of yourself, pet, car, house, whatever you want others to see<br />
<br />
<div class="tip"><img src="Images/Conventions/Tip.png" alt="Tip" align="left" />Don't choose a high, big resolution picture. It takes time to load and you experience a slow Nicotine+ if everytime your User info is requested. Nicotine+ does not compress your images.</div>
</li>
<li>

<h2 class="underline"><a name="SettingsImportConfig" id="SettingsImportConfig">Settings: Import Config</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/misc_import_config.png" ><img title="Import config" src="Images/ScreenShots/thumb_misc_import_config.jpg"></a>
</div>
Set the directory to your Soulseek installation's directory. Choose the config options you wish to import and press the <b>Import config</b> button.
<br/><br/>
Some of these will overwrite config options (such as Login / password), so be careful.

<br/><br/>
</li>
</ul>
</li>
<li>
<h2>Getting Around</h2>
<ul>
<li>
<h2 class="underline"><a name="Basics" id="Basics">Nicotine+ Getting Around: Basics</a></h2>
Finally after going through (hopefully) not too much hassle, you can begin sharing your world with friends,<br />
family and interesting people around the world. Nicotine is not difficult to understand as most of it is self explanatory..<br />
Reading through the Basics you might discover something new and use it for your benefit.<br />
After downloading, installing and configuring you're now a part of Soulseek Network.<br />
Nicotine+ can become one of your most used and valuable application you run...<br />
Getting to know it better has it's benefits in making life somehow easier and troubleshooting when hitting a problem...<br />
<h2>Nicotine Tabs</h2>
As said before, Nicotine+ is pretty much self explanatory... At the top you see tabs, each for function you can use.
<h2>Commands</h2>
You can access a list of commands used in Nicotine by going to Help
<h2>Right mouse-click</h2>
Right mouse click is one of the most used feature in new generation OS. Almost every application uses them. In Nicotine+ right mouse-click is also use a lot. Windows having a right mouse-click menu are:
<ul>
<li>Chatroom
<ul>
<li>Log window</li>
<li>user-in-room-list</li>
<li>room-list</li>
</ul>
</li>
<li>Private chat</li>
<li>Downloads</li>
<li>Uploads</li>
<li>Userinfo</li>
<li>Userbrowse</li>
<li>Interests</li>
<li>Userlist</li>
</ul>
<ul>
<li>
<h2 class="underline"><a name="BasicsMenus" id="BasicsMenus">Nicotine+ Getting Around: Basics, Menus</a></h2>
Nicotine has menus other than menus which can be viewed with right-mouse-click. The menus are File and Help.
<h2>File menu</h2>
<ul>
<li><i>Connect</i> connects you with the Soulseek Network</li>
<li><i>Disconnect</i> breaks the connection with Soulseek Network (logs you out)</li>
<li><i>Away/Return</i> can be used to let other users know if you're behind the computer or not.</li>
<li><i>Check privileges</i></li>
<li><i>Show debug info</i> shows everything Nicotine is doing in the background. It will get boring very quickly, unless you're a python programmer. You can see it in Log window.</li>
<li><i>Hide log window</i> Hides the log window</li>
<li><i>Hide room list</i> Hides chatroom list</li>
<li><i>Hide tickers</i> Hides ticker in chatrooms, very useable in rooms with lots of users</li>
<li><i>Settings</i> Opens Nicotine+ configuration window</li>
<li>"Rescan shares" If you move files while Nicotine is open, you can better Rescan shares once in a while without restarting</li>
<li><i>Browse my shares</i> let's u see your own files as the way other user see it when they browse you</li>
<li><i>Exit</i> Do I really have to explain this? :)</li>
</ul>
<br />
<div class="tip"><img src="Images/Conventions/Tip.png" alt="Tip" align="left" />Most menu items can be used through shortcuts. Try to remember them, so you don't need to hunt and click with your mouse</div>
<br />
<h2>Mode menu</h2>
<ul>
<li><i>Chat Rooms</i> switches to Chat rooms window</li>
<li><i>Private Chat</i> switches to Private chat window</li>
<li><i>Downloads</i> switches to Downloads window</li>
<li><i>Uploads</i> switches to Uploads window</li>
<li><i>Search Files</i> switches to Search files window</li>
<li><i>User Info</i> switches to User info window</li>
<li><i>User Browse</i> switches to User browse window</li>
<li><i>Interests</i> switches to Interests window</li>
<li><i>Buddy List</i> switches to Buddy list window</li>
</ul>
<h2>Help menu</h2>
<ul>
<li><i>About chat room commands</i> shows you a list of all the commands you can use in Chat room</li>
<li><i>About private chat commands</i> shows you a list of all the commands you can use in Private chat</li>
<li><i>About search filters</i> shows tips on how to refine your searches</li>
<li><i>Check latest</i> shows you if there is a new Nicotine version available and where to download it</li>
<li><i>About Nicotine</i> shows Version and Credits</li>
</ul>
</li>
<li>
<h2 class="underline"><a name="BasicsTabs" id="BasicsTabs">Nicotine+ Getting Around, Basics, Tabs</a></h2>
Tabs are handy to separate all the things you can do, so everything is clear and self explanatory. At the top you see tabs, each for function you can use.
<ul>
<li><i>Chat rooms</i> lists all the rooms you're in</li>
<li><i>Private chat</i> lists all the chat-sessions you have with friends, family and other users</li>
<li><i>Downloads</i> lists all the files you're downloading, as well from who, download speed, progress or when it's your turn to download</li>
<li><i>Uploads</i> lists all the files you're uploading, as well to who, upload speed and progress</li>
<li><i>Search files</i> you can use to search for files as well how long you have to wait and what speed you can download from a user</li>
<li><i>User info</i> shows you info about a user that has provided more info about him/herself.</li>
<li><i>User browse</i> lists all the windows which shows what other user have shared</li>
<li><i>Interest</i> you can add your likes and dislikes, search for users with same like/dislikes. This option is handy if you are looking for rare files.</li>
<li><i>Buddy list</i> shows a list of users. You can add comments for each user like email or what he/she is sharing</li>
</ul>
</li>
<li>
<h2 class="underline"><a name="BasicsLogwindow" id="BasicsLogwindow">Nicotine+ Getting Around: Basics, Log window</a></h2>
Nicotine has a Log window, which stays there even if you switch Tabs.
<ul>
<li>Messages are send as follow: [time] message
<ul>
<li>[time] is when it happened</li>
<li>message can be anything, more info? see below</li>
</ul>
</li>
<li>First time you connect you see a message which is send to your Nicotine by Soulseek Network.</li>
<li>After a while you see "[time] XXXX privileged users" which means there're XXXX users who have donated and get priority if they download.</li>
<li>If you have "show debug info" checked, you see what nicotine is doing in background.</li>
<li>When some user Browses you files you see: <i>[time] [user] is making a Browseshares request</i></li>
<li>When some user wants your user info you see:<i>[time] [user] is making a Userinfo request</i></li>
<li>When download starts you see: <i>[time] Download started: path/to/download/folder - file_name.xxx</i></li>
<li>When download finishes you see: <i>[time] Download finished: path/to/download/folder/file_name.xxx</i></li>
</ul>
<div class="tip"><img src="Images/Conventions/Tip.png" alt="Tip" align="left" />You can turn on/off debug info by going to "File --&gt; Show debug info "<br />
You can hide Log window by using Hotkey "Alt + H" or going to "File --&gt; Hide log window"</div>
</li>
</ul>
</li>
<li>
<h2 class="underline"><a name="ChatRooms" id="ChatRooms">Nicotine+ Getting Around: Chatrooms</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/tab_chatroom.png" ><img title="Chatrooms" src="Images/ScreenShots/thumb_tab_chatroom.jpg"></a>
</div>
Chatroom is a big foundation which makes Soulseek network so different from other P2P.<br />
Soulseek really went back to the basic of sharing like it was meant to be. Nicotine+ has some extra<br />
features in Chat rooms window. We will discuss them here.<br />
<br />
<ul>
<li><i>Chat room log window</i>: Just under the tab which holds the name of the chatroom you're in you can see Chat room log window.</li>
<li><i>Chatroom</i>: Under the log window you see the chat room itself. You can talk to other people and read what they say</li>
<li><i>Message input</i>: Below the Chatroom you see the message input. There you just type and hit enter to send your message</li>
<li><i>Users-in-room-list</i>: On the right of Chat room you see users-in-room-list window, which lists all users who're in the room,<br />
online/away status, connection speed and number of shared files.</li>
<li><i>Room-list</i>: Placed far on the right, shows you most rooms that Soulseek network holds. Join room by double clicking or using right mouse-click menu.<br />
If you don't see the room you're looking for "right mouse-click --&gt; Refresh".<br />
<div class="apple"><img src="Images/Conventions/Apple.png" alt="Apple" align="left" />To access right click menu on, use &acirc;&OElig;&tilde; + mouse click</div>
</li>
<li><i>Log</i>: Below users-in-room-list you see a check button for saving Chat room's history as a log file.</li>
<li><i>Auto-join</i>: Next to Log you see Auto-join when selected, next time you start Nicotine+ you will join the room automatically.</li>
<li><i>Leave</i>: Button next to Log check field, exit the room you're in.</li>
<li><i>Create</i>: Allows you to create your own room! if the room already exist, then you simply join.</li>
</ul>
<ul>
<li>
<h2 class="underline"><a name="ChatRoomsMenu" id="ChatRoomsMenu">Nicotine+ Getting Around: Chatroom Roomlist Menus</a></h2>
In Chatroom window you can access all features used by Nicotine+ with right mouse click. Below you can see what each of the items do.<br />
<br />
<ul>
<li><i>Send Message</i> will start a private chat with the chosen user
<ul>
<li>nicotine 1.2.1 and below users have to click on private chat manually</li>
</ul>
</li>
<li><i>Show IP address</i> will print the IP address and port the user is connected to Soulseek with into the log window.
<ul>
<li>Optionally, if you have the GeoIP bindings installed, it'll show the user's country of origin.</li>
</ul>
</li>
<li><i>Get user info</i> will load the user's queue status, as well as the user's text and pictures, if any was added by that user.</li>
<li><i>Browse files</i> will load the user's files in the User browse tab, allowing you to view that user's shares.</li>
<li><i>Give Privileges</i> allowing you to give other users your Soulseek Privileges you received by sending a donation to www.slsknet.org</li>
<li><i>Add user to list</i> will drop that user into buddy list, where you can give them privileged status, add comments or even ban them, if you wish.</li>
<li><i>Ban this user</i> will block that user from downloading from you and from viewing your shares.</li>
<li><i>Ignore this user</i> will make that user disappear from chat rooms and private chat.</li>
</ul>
<br />
<div class="apple"><img src="Images/Conventions/Apple.png" alt="Apple" align="left" />Right-clicking on a username in the user list will provide you with a popup menu, but if you are using a Mac, you'll be forced to use one of the delightful mouse and keyboard combos to bring it up.
&acirc;&OElig;&tilde; + mouse click.</div>
</li>
<li>
<h2 class="underline"><a name="ChatRoomsCommands" id="ChatRoomsCommands">Nicotine+ Getting Around: Chatroom /Commands</a></h2>
There are quite a few commands in Nicotine that you may find useful. Commands save time otherwise wasted on lots of hunting and clicking.<br />
List of commands is available via "Help --&gt; About chat room commands"<br />
<br />
<ul>
<li><i>/join /j 'room'</i> Join room 'room'</li>
<li><i>/leave /l 'room'</i> Leave room 'room'</li>
<li><i>/part /p 'room'</i> Leave room 'room'</li>
<li><i>/clear /cl</i> Clear the chat window</li>
<li><i>/tick /t</i> Set your personal ticker</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/add /ad 'user'</i> Add user 'user' to your Buddy list</li>
<li><i>/browse /b</i> 'user' Browse files of user 'user'</li>
<li><i>/whois</i> /w 'usr' Request user info for user 'user'</li>
<li><i>/ip 'user'</i> Show IP for user 'user'</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/alias /al</i> 'command' 'definition' Add a new alias</li>
<li><i>/alias /al</i> 'command' 'definition' |(process) Add a new alias that runs a process</li>
<li><i>/unalias /un</i> 'command' Remove an alias</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/ban 'user'</i> Add user 'user' to your ban list</li>
<li><i>/unban 'user'</i> 'Remove user 'user' from your ban list</li>
<li><i>/ignore 'user'</i> Add user 'user' to your ignore list</li>
<li><i>/unignore</i> 'user' Remove user 'user' from your ignore list</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/msg 'user' 'message'</i> Send message 'message' to user 'user'</li>
<li><i>/pm 'user'</i> Open private chat window for user 'user'</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/search /s 'query'</i> Start a new search for 'query'</li>
<li><i>/rsearch /rs 'query'</i> Search the joined rooms for 'query'</li>
<li><i>/bsearch /bs 'query'</i> Search the buddy list for 'query'</li>
<li><i>/usearch /us 'user' 'query'</i> Search a user's shares for 'query'</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/rescan</i> Rescan shares</li>
<li><i>/away /a</i> Toggles your away status</li>
<li><i>/quit /q</i> Quit Nicotine</li>
</ul>
<br />
<div class="warning"><img src="Images/Conventions/Warning.png" alt="Warning" align="left" />There are endless possibilities and combinations of commands and scripts you can add with the /alias command, but be WARNED: You CAN lock up Nicotine if you run a program that doesn't exit immediately. This
is feature is designed for running scripts, getting text output and most definitely NOT for running GUI programs.</div>
</li>
</ul>
</li>
<li>
<h2 class="underline"><a name="PrivateChat" id="PrivateChat">Nicotine+ Getting Around: Private chat</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/tab_privatechat.png" ><img title="Private chat" src="Images/ScreenShots/thumb_tab_privatechat.jpg"></a>
</div>
Private chat window consist of a few parts.<br />
<br />
<ul>
<li><i>Username tabs</i>: Every user you having private chat with has a tab. When you chat with more than one user you<br />
can switch between them by clicking on the tab. Tabs are located far to right</li>
<li><i>Private chat itself</i>: The biggest window you can see. Your lines are colored in blue and the other persons coversation is black<br />
Every message is shown this way: day month date hour minutes seconds year [username] message (example: Thu Jun 15 17:13:46 2006 [user_name])</li>
<li><i>Message input</i>: Just under the private chat's biggest window. There you can type whatever you want to say and hit enter</li>
<li><i>Log</i>: Next to message input, checkbox for logging chatsession.</li>
<li><i>Close button</i>: Next to Log Log checkbox, Closes chat session</li>
</ul>
<ul>
<li>
<h2 class="underline"><a name="PrivateChatMenus" id="PrivateChatMenus">Nicotine+ Getting Around: Private chat Menus</a></h2>
Right mouse-click gives you access to several option you can use in a private chat session.<br />
<br />
<ul>
<li><i>Close</i> closes the parent chat session</li>
<li><i>Show IP address</i> will print the ip address and port the user is connected to Soulseek with into the log window</li>
<li><i>Get user info</i> will load the user's queue status, as well as the user's text and pictures, if any was added by that user</li>
<li><i>Browse files</i> will load the user's files in the User browse tab, allowing you to view that user's shares.</li>
<li><i>Give privileges</i> you can give a user priority for downloading files, which means he/she doesn't have to wait before downloads starts</li>
<li><i>Add user to list</i> will drop that user into buddy list, where you can give them privileged status, add comments or even ban them, if you wish</li>
<li><i>Ban this user</i> will block that user from downloading from you and from viewing your shares</li>
<li><i>Ignore this user</i> will make that user disappear from chat rooms and private chat</li>
<li><i>Client version</i> shows users Nicotine version</li>
</ul>
</li>
<li>
<h2 class="underline"><a name="PrivateChatCommands" id="PrivateChatCommands">Nicotine+ Getting Around: Private chat /Commands</a></h2>
Nicotine+ Getting Around: Private chat Commands<br />
There are quite a few commands in Nicotine that you may find useful. Commands save time otherwise wasted on lots of hunting and clicking.<br />
List of commands is available via "Help --&gt; About private chat commands "<br />
<br />
<ul>
<li><i>/close /c</i> Close the current private chat</li>
<li><i>/clear /cl</i> Clear the chat window</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/add /ad 'user'</i> Add user 'user' to your Buddy list</li>
<li><i>/browse /b</i> 'user' Browse files of user 'user'</li>
<li><i>/whois</i> /w 'usr' Request user info for user 'user'</li>
<li><i>/ip 'user'</i> Show IP for user 'user'</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/alias /al</i> 'command' 'definition' Add a new alias</li>
<li><i>/alias /al</i> 'command' 'definition' |(process) Add a new alias that runs a process</li>
<li><i>/unalias /un</i> 'command' Remove an alias</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/ban 'user'</i> Add user 'user' to your ban list</li>
<li><i>/unban 'user'</i> 'Remove user 'user' from your ban list</li>
<li><i>/ignore 'user'</i> Add user 'user' to your ignore list</li>
<li><i>/unignore</i> 'user' Remove user 'user' from your ignore list</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/msg 'user' 'message'</i> Send message 'message' to user 'user'</li>
<li><i>/pm 'user'</i> Open private chat window for user 'user'</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/search /s 'query'</i> Start a new search for 'query'</li>
<li><i>/rsearch /rs 'query'</i> Search the joined rooms for 'query'</li>
<li><i>/bsearch /bs 'query'</i> Search the buddy list for 'query'</li>
<li><i>/usearch /us 'user' 'query'</i> Search a user's shares for 'query'</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br /></li>
<li><i>/rescan</i> Rescan shares</li>
<li><i>/away /a</i> Toggles your away status</li>
<li><i>/quit /q</i> Quit Nicotine</li>
</ul>
<br />
<div class="warning"><img src="Images/Conventions/Warning.png" alt="Warning" align="left" />There are endless possibilities and combinations of commands and scripts you can add with the /alias command, but be WARNED: You CAN lock up Nicotine if you run a program that doesn't exit immediately. This
is feature is designed for running scripts, getting text output and most definitely NOT for running GUI programs.</div>
</li>
</ul>
</li>
<li>
<h2 class="underline"><a name="Downloads" id="Downloads">Nicotine+ Getting Around: Downloads/Uploads</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/tab_downloads.png" ><img title="Downloads" src="Images/ScreenShots/thumb_tab_downloads.jpg"></a>
<br />
<a href="Images/ScreenShots/tab_uploads.png" ><img title="Uploads" src="Images/ScreenShots/thumb_tab_uploads.jpg"></a>
</div>
All of the things you can do in Downloads/Uploads are accessable through right mouse-click. Upload window is<br />
the same, except for the fact that Download lists all files that you're DOWNLOADING and Upload for UPLOADING :)
<ul>
<li>
<h2 class="underline"><a name="DownloadsMenus" id="DownloadsMenus">Nicotine+ Getting Around: Dowloads/Uploads menu</a></h2>
In Download/Upload window you can access all features used by Nicotine+ with right mouse click. Below you can see what each of the items do.<br />
<br />
<ul>
<li><i>Get place in queue</i> send the number of files ahead of you in the queue to the Log Window</li>
<li><i>Copy URL</i> pastes a <a class="ext-link" href="slsk://">slsk://</a> link for the selected file in the copy buffer</li>
<li><i>Copy folder URL</i> pastes a <a class="ext-link" href="slsk://">slsk://</a> link for the selected file's folder in the copy buffer</li>
<li><i>Send to player</i></li>
<li><i>Send message</i> will start a private chat with the chosen user
<ul>
<li>nicotine 1.2.1 and below users have to click on private chat manually</li>
</ul>
</li>
<li><i>Show IP address</i> will print the ip address and port the user is connected to Soulseek with into the log window.
<ul>
<li>Optionally, if you have the GeoIP bindings installed, it'll show the user's country of origin</li>
</ul>
</li>
<li><i>Get user info</i> will load the user's queue status, as well as the user's text and pictures, if any was added by that user</li>
<li><i>Browse files</i> will load the user's files in the User browse tab, allowing you to view that user's shares</li>
<li><i>Give privileges</i></li>
<li><i>Add user to list</i> will drop that user into buddy list, where you can give them privileged status, add comments or even ban them</li>
<li><i>Ban this user</i> will block that user from downloading from you and from viewing your shares</li>
<li><i>Ignore this user</i> will make that user disappear from chat rooms and private chat</li>
</ul>
<ul>
<li><i>Abort</i> will simply cancel download(s)</li>
<li><i>Abort and remove file(s)</i> will cancel and delete the file(s) from the hard drive</li>
<li><i>Retry</i> will attempt to complete the file(s) from wherever they left off</li>
<li><i>Clear</i> will remove selected files from the list</li>
</ul>
<ul>
<li><i>Clear finished/aborted</i> will remove finished or aborted files from the list</li>
<li><i>Clear finished</i> will remove finished files from the list</li>
<li><i>Clear aborted</i> will remove aborted files from the list</li>
<li><i>Clear queued</i> will remove queued files from the list</li>
</ul>
<br />
<div class="tip"><img src="Images/Conventions/Tip.png" alt="Tip" align="left" />You can access most items by Letter Commands. (see next section)</div>
</li>
<li>
<h2 class="underline"><a name="DownloadsCommands" id="DownloadsCommands">Nicotine+ Getting Around: Download/Upload commands</a></h2>
In Download and Upload windows you can access all the features not only through the right mouse-click popup-menu but you can use Letter commands as well...
<h3>Popup Menu</h3>
First you hit the letter P -- or right-click -- and then other Letter commands.
<ul>
<li>P = opens the <strong>p</strong>opup menu, where more hotkeys are accessable
<ul>
<li>q = Get place in <strong>q</strong>ueue</li>
<li>u = Copy <strong>U</strong>RL</li>
<li>p = send to <strong>p</strong>layer</li>
<li>m = send <strong>m</strong>essage</li>
<li>d = Show IP a<strong>d</strong>dress</li>
<li>n = Show user i<strong>n</strong>fo</li>
<li>s = Brow<strong>s</strong>e files</li>
<li>v = Give Pri<strong>v</strong>ileges</li>
<li>a = <strong>A</strong>dd user to list</li>
<li>b = <strong>B</strong>an this user</li>
<li>i = <strong>I</strong>gnore this user</li>
<li>t = Abor<strong>t</strong></li>
<li>f = Abort and remove <strong>f</strong>ile(s)</li>
<li>r = <strong>R</strong>etry</li>
<li>c = <strong>C</strong>lear</li>
</ul>
</li>
</ul>
<h3>Transfer Panel</h3>
Select some files and then just type one of these letters.
<ul>
<li>t = Abor<strong>t</strong> Transfer(s)</li>
<li>r = <strong>R</strong>etry Transfer(s)</li>
<li>Del = Abort, Clear and <strong>Del</strong>ete download(s); Abort and Clear upload(s)</li>
</ul>
</li>
</ul>
</li>
<li>
<h2 class="underline"><a name="SearchFiles" id="SearchFiles">Nicotine+ Getting Around: Search files</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/search_filters.png" ><img title="Search Filters" src="Images/ScreenShots/thumb_search_filters.jpg"></a>
<br />
<a href="Images/ScreenShots/search_wishlist.png" ><img title="Search Wishlist" src="Images/ScreenShots/thumb_search_wishlist.jpg"></a>
</div>
Search files window consist of a few parts. It may seem too much but get to know it, so you can get the most out of it.<br />
<br />
<ul>
<li><i>Search field</i>: Just below Nicotine+ tabs, Type in what you're looking for and hit enter or click on Search button</li>
<li><i>Saved searches</i>: Next to search field (button with arrow), previous entered search queries are saved to make filling out and searching easier</li>
<li><i>Search location</i>: Next on the right of saved search button, allows you to choose where the file must be searched.<br />
<ul>
<li><i>Global</i> will search everyone connected to Soulseek Network</li>
<li><i>Rooms</i> will show you search result from everyone in rooms you're in</li>
<li><i>Buddies</i> will show you search results from everyone in you Buddy list</li>
<li><i>Search button</i>: Next to right of Search location, when clicked search query is performed.<br />
<div class="tip"><img src="Images/Conventions/Tip.png" alt="Tip" align="left" />Save time by hitting Enter after you fill out the search field.</div>
</li>
<li><i>Search query tab</i>: Every search query gets it's own tab. Each tab gets it's name from what you're looking for.</li>
</ul>
</li>
<li><i>Enable filters</i>: Located just below a search query tab. Check button allows you filter what you have set up in settings.
<ul>
<li>You can configure some filters for better search results.</li>
<li>Configure your own set of filters by going to "File ---&gt; Settings ---&gt; Searches"</li>
<li>Read more about Search filters by going to "Help ---&gt; About search filters"</li>
</ul>

</li>
<li><i>Search results</i>: The biggest window in Search tab. Shows you not only search results but also other info like:
<ul>
<li><i>Filename</i> shows the name of file and extension</li>
<li><i>User</i> shows which user is sharing</li>
<li><i>Size</i> shows size of file in bytes ( 1 megabyte = 1 048 576 bytes )</li>
<li><i>Speed</i> shows approximate download speed in kilobits p/sec.</li>
<li><i>In queue</i> shows how many files are ahead of you</li>
<li><i>Immediate Download</i> If you can begin downloading? <span class="underline">Y</span>es or <span class="underline">N</span>o</li>
<li><i>Bitrate</i> shows the files Bitrate, which is the quality... higher, the better and the bigger the file</li>
<li><i>Length</i> shows how long the files plays in min:sec</li>
<li><i>Directory</i> shows the path to file_name.xxx on users computer</li>
</ul>
</li>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;"><br />
<div class="note"><img src="Images/Conventions/Note.png" alt="Note" align="left" />Search results in the default theme colors are either black (for immediate download) or gray (queued, you have to wait)</div>
<br /></li>
<li><i>Ignore button</i>: located right, just below Search location buttons, If you get flooded by search results, which can happen with popular searches,<br />
you can use Ignore button to stop getting more search results. It doesn't stop searching!! You just don't get to see the results...</li>
<li><i>Close button</i>: Located next to Ignore button, Closes current search results tab.</li>
<li><i>Remember checkbox</i>: Located next too Close button, The remember check box will make your search run continuously and between sessions.<br />
If you don't close the search, every time you start Nicotine, it will start searching again. (This is the same as Wish list in the windows client)</li>
</ul>
<ul>
<li>
<h2 class="underline"><a name="SearchFilesMenus" id="SearchFilesMenus">Nicotine+ Getting Around: Search files menus</a></h2>
<ul>
<li><i>Download file(s)</i> adds the selected files to your download queue</li>
<li><i>Download file(s) to...</i> allows you to choose where to save downloads</li>
<li><i>Download containing folder(s)</i> allows you to download entire folders (and subfolders). Be careful with this option!</li>
<li><i>Copy URL</i> pastes a <a class="ext-link" href="slsk://">slsk://</a> link for the selected file in the copy buffer</li>
<li><i>Copy folder URL</i> <a class="ext-link" href="slsk://">slsk://</a> link for the selected file's folder in the copy buffer</li>
<li><i>Send message</i> will start a private chat with the chosen user
<ul>
<li>nicotine 1.2.1 and below users have to click on private chat manually</li>
</ul>
</li>
<li><i>Show IP address</i> will print the ip address and port the user is connected to Soulseek with into the log window</li>
<li><i>Get user info</i> will load the user's queue status, as well as the user's text and pictures, if any was added by that user</li>
<li><i>Browse files</i> will load the user's files in the User browse tab, allowing you to view that user's shares</li>
<li><i>Give privileges</i> allowing you to give other users your Soulseek Privileges you received by sending a donation to www.slsknet.org</li>
<li><i>Add user to list</i> will drop that user into buddy list, where you can give them privileged status, add comments or even ban them</li>
<li><i>Ban this user</i> will block that user from downloading from you and from viewing your shares</li>
<li><i>Ignore this user</i> will make that user disappear from chat rooms and private chat</li>
</ul>
</li>
</ul>
</li>
<li>
<h2 class="underline"><a name="UserInfo" id="UserInfo">Nicotine+ Getting Around: User info</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/tab_userinfo.png" ><img title="Userinfo" src="Images/ScreenShots/thumb_tab_userinfo.jpg"></a>
</div>
User info is a window which shows information provided by some user and you request it.
<ul>
<li><i>Tabs</i></li>
</ul>
<h3>1.</h3>
<ul>
<li>Every user from which you request info gets a tab with his/her name and status (Online/Offline/Away)</li>
</ul>
<h3>2. Self description</h3>
<ul>
<li>You can read what a user has to say about him/herself.</li>
</ul>
<h3>3. Image</h3>
<ul>
<li>An image the user wants to show you, it could be a wallpaper, avatar or any kind of picture</li>
</ul>
<h3>4. Buttons</h3>
<blockquote>User info doesn't have menus, instead you can use buttons</blockquote>
<ul>
<li><i>Private chat</i> will start a private chat with the chosen user.</li>
<li><i>Browse</i> will load the user's files in the User browse tab, allowing you to view that user's shares.</li>
<li><i>Show IP</i> will print the IP address and port that the user is connected to Soulseek with into the log window.</li>
<li><i>Add to list</i> will drop that user into buddy list, where you can give them privileged status, add comments or even ban them</li>
<li><i>Ban</i> will block that user from downloading from you and from viewing your shares</li>
<li><i>Ignore</i> will make that user disappear from chat rooms and private chat</li>
<li><i>Save pic</i> will save the user's picture</li>
<li><i>Refresh</i> will load info about current user again</li>
<li><i>Close</i> will close current user info window</li>
</ul>
<h3>5. Information</h3>
This window displays some info about:
<ul>
<li><i>Total uploads allowed</i> shows how many uploads at once the user allows.</li>
<li><i>Queue size</i> how many files are in line to get uploaded.</li>
<li><i>Slots available</i> shows how many upload slots are free.</li>
<li><i>Speed</i> shows speed in Bits/sec.</li>
<li><i>Files Shared</i> is the number of files shared.</li>
<li><i>Dirs Shared</i> is the number of dirs shared.</li>
</ul>
<ul>
<li>When you "Refresh" user info the progressbar begins with 0 and when 100% filled it has finished downloading.</li>
</ul>
</li>
<li>
<h2 class="underline"><a name="UserBrowse" id="UserBrowse">Nicotine+ Getting Around: User browse</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/tab_userbrowse.png" ><img title="Userbrowse" src="Images/ScreenShots/thumb_tab_userbrowse.jpg"></a>
</div>
When you successfully Browse a user's files you can see the results in User browse window<br />
<br />
<h3>1. Tabs</h3>
<ul>
<li>Every user which you Browse files gets a tab with his/her name and status (Online/Offline/Away)</li>
</ul>
<h3>2. Dirs</h3>
<ul>
<li>At the far left you can see all the dirs a user is sharing</li>
</ul>
<h3>3. Files</h3>
<ul>
<li>Next to "Dirs" you see files. When you click on a dir you see all the files that dir contains.</li>
</ul>
<h3>4. Refresh</h3>
<ul>
<li>Will try to load the user's shares again</li>
</ul>
<h3>5. Close</h3>
<ul>
<li>Closes current shared files window of user</li>
</ul>
<h3>6. Search</h3>
Some users have so many files shared that manually searching through each directory is too much work.
<ul>
<li>Type in the name of a file or keyword you want to search for and hit the <strong>Enter</strong> key.</li>
<li>After every search you can hit <strong>Enter</strong> again to find the next file with the same name</li>
</ul>
<br />
<div class="tip"><img src="Images/Conventions/Tip.png" alt="Tip" align="left" />Before you search, make sure you select the shared directory at the top of the folder tree. That way you'll search through every file shared.</div>
<ul>
<li>
<h2 class="underline"><a name="UserBrowseMenus" id="UserBrowseMenus">Nicotine+ Getting Around: User browse menus</a></h2>
User browse has two menus, one for directory tree and one for files list.<br />
<br />
The Files list has at two additional options under the Download submenu: "Download files" and "Download files to"<br />
<br />
<ul>
<li style="list-style-type: none; list-style-image: none; list-style-position: outside;">Both the directory tree and the files list menus have the following items</li>
<li><i>Download directory</i> adds the selected directory to your download queue.</li>
<li><i>Download directory to</i> allows you to choose where to save the directory</li>
<li><i>Download recursive</i> downloads all files and subdirectories</li>
<li><i>Download recursive to</i> allows you to choose where to save the contents of this directory</li>
</ul>
<ul>
<li><i>Copy URL</i> pastes a <a class="ext-link" href="slsk://">slsk://</a> link for the selected file in the copy buffer</li>
</ul>
<ul>
<li><i>Send Message</i> will start a private chat with the chosen user
<ul>
<li>nicotine 1.2.1 and below users have to click on private chat manually</li>
</ul>
</li>
<li><i>Show IP address</i> will print the ip address and port the user is connected to Soulseek with into the log window.
<ul>
<li>Optionally, if you have the GeoIP bindings installed, it'll show the user's country of origin.</li>
</ul>
</li>
<li><i>Get user info</i> will load the user's queue status, as well as the user's text and pictures, if any was added by that user.</li>
<li><i>Give Privileges</i> allowing you to give other users your Soulseek Privileges you received by sending a donation to www.slsknet.org</li>
<li><i>Add user to list</i> will drop that user into buddy list, where you can give them privileged status, add comments or even ban them, if you wish.</li>
<li><i>Ban this user</i> will block that user from downloading from you and from viewing your shares.</li>
<li><i>Ignore this user</i> will make that user disappear from chat rooms and private chat.</li>
</ul>
</li>
</ul>
</li>
<li>
<h2 class="underline"><a name="Interests" id="Interests">Nicotine+ Getting Around: Interests</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/tab_recommendations.png" ><img title="Recommendations" src="Images/ScreenShots/thumb_tab_recommendations.jpg"></a>
</div>
This one of the nicest features of Nicotine in my opinion. You can find people with similar interests, which can help you finding rare files more easily.<br />
<br />
<h3>1. Likes</h3>
<ul>
<li>You can add your likes there. Just click on + Add button.</li>
</ul>
<h3>2. Dislikes</h3>
<ul>
<li>You can add your likes there. Just click on + Add button.</li>
</ul>
<h3>3. Results</h3>
After you added your likes and dislikes you can click on:
<ul>
<li><i>Global recommendations</i> loads a list of</li>
<li><i>Recommendations</i> loads a list of</li>
<li><i>Similar useres</i> loads a list of users with likes/dislikes similar as yours</li>
</ul>
<h3>4. Recommendations</h3>
<ul>
<li>After you click on <i>Global recommendations</i> or <i>Recommendations</i> the list get loaded there</li>
</ul>
<h3>5. Similar users</h3>
<ul>
<li>A list of users with similar likes/dislikes loads there.</li>
</ul>
<ul>
<li>
<h2 class="underline"><a name="InterestsMenus" id="InterestsMenus">Nicotine+ Getting Around: Interests menus</a></h2>
Interests window has several menus. The use of interests can be quite confusing... But if you know it well, it can be one of the most usefull features of Nicotine+
<h3>Recommendation menu</h3>
When you click on "Global recommendation" or "Recommendation" button, you see a list in recommendation window (see item 4 of Interests)<br />
Right mouse-click for this window looks like:<br />
<ul>
<li><i>I like this</i> will put the item in "I like window"</li>
<li><i>I don't like this</i> will put the item in "I dislike window"</li>
<li><i>Recommendation for this item</i> will load a recommendation list for chosen item</li>
</ul>
<ul>
<li><i>Search for this item</i> will start a search for that item in Search window (you have to click manually on "search" button)</li>
</ul>
<br />
<h3>Similar users menu</h3>
When you click on "Similar users" button, you see a list in similar user window<br />
Right mouse-click for this window looks like:<br />
<ul>
<li><i>Send message</i> will start a private chat with the chosen user
<ul>
<li>nicotine 1.2.1 and below users have to click on private chat manually</li>
</ul>
</li>
<li><i>Show IP address</i> will print the ip address and port the user is connected to Soulseek with into the log window</li>
<li><i>Get user info</i> will load the user's queue status, as well as the user's text and pictures, if any was added by that user</li>
<li><i>Browse files</i> will load the user's files in the User browse tab, allowing you to view that user's shares</li>
<li><i>Give privileges</i> allowing you to give other users your Soulseek Privileges you received by sending a donation to www.slsknet.org</li>
<li><i>Add user to list</i> will drop that user into buddy list, where you can give them privileged status, add comments or even ban them</li>
<li><i>Ban this user</i> will block that user from downloading from you and from viewing your shares</li>
<li><i>Ignore this user</i> will make that user disappear from chat rooms and private chat</li>
</ul>
</li>
</ul>
</li>
<li>
<h2 class="underline"><a name="BuddyList" id="BuddyList">Nicotine+ Getting Around: Buddy list</a></h2>
<div style="float: right;">
<a href="Images/ScreenShots/tab_buddylist.png" ><img title="BuddyList" src="Images/ScreenShots/thumb_tab_buddylist.jpg"></a>
</div>
The last window in Nicotine+ is Buddy list. Altrough it's the last window it's as important as every other window.<br />
Not mainly for Nicotine+ but for users like you. You can keep a list of friends, family or just people<br />
who just made you happy with that one rare file you were looking for ages.<br />
<br />
<h3>1. List</h3>
<ul>
<li>When you add a user through any of various menus or commands, it gets listed in this window.</li>
</ul>
<h3>2. Add</h3>
<ul>
<li>Add field you can use to add users manually to your Buddy list</li>
<li>Type a name and hit Enter</li>
</ul>
<h3>3. Statistics &amp; Comments</h3>
<ul>
<li>The first column is a Status icon signifying if the user is <i>online</i>, <i>offline</i>, or <i>away</i>.</li>
<li><i>User</i> shows the user's nickname.</li>
<li><i>Speed</i> shows their average speed in Bits per second.</li>
<li><i>Files</i> shows the number of shared files.</li>
<li><i>Comments</i> shows comments like real name, email-address, name of a file you want... it can be anything you want.</li>
</ul>

<h2 class="underline"><a name="BuddyListMenus" id="BuddyListMenus">Buddy list menus</a></h2>
<ul>
<li><i>Send message</i> will start a private chat with the chosen user
<ul>
<li>Double-click on a user to switch to a private chat with that user.</li>
</ul>
</li>
<li><i>Show IP address</i> will print the ip address and port the user is connected to Soulseek with into the log window. The flag of the country this user is in may appear, if the user's IP is in the GeoIP database.</li>
<li><i>Get user info</i> will load the user's queue details, as well as the user's text and pictures, if any were set by this user.</li>
<li><i>Browse files</i> will load the user's files in the User browse tab, allowing you to view that user's shares.</li>
<li><i>Give privileges</i> allows you to give this user a number of days of global Soulseek Privileges you received after sending a donation to www.slsknet.org. (You will lose days of privileges and this user will gain them)</li>
<li><i>Add user to list</i> will drop this user into buddy list, where you can give them privileged status, add comments or even ban them</li>
<li><i>Ban this user</i> will block this user from downloading from you and from viewing your shares</li>
<li><i>Ignore this user</i> will make this user disappear from chat rooms and private chat</li>
</ul>
<ul>
<li><i>Online notify</i> notifies you when this user is online, you see the notify in Log window or status bar or, if you have notify-python and its dependencies installed, a popup dialog with the user's status.</li>
<li><i>Privileged</i> allows this user to download without waiting</li>
<li><i>Trusted</i> allows this user to upload files to you, if you only <A href="#SettingsTransfersAllowSend">allow trusted buddies to send you files</a>.</li>
<li><i>Edit comments</i> allows you to add or modify comments</li>
<li><i>Remove</i> removes this user from your Buddy list</li>
</ul>
</li>
</ul>

</li>
</ul>
</li>
<li><h2><a name="AliasNowPlaying">Now Playing</a></h2>

NowPlaying is a feature that works with players that provide metadata to the standard output (STDOUT).<br/><br/>
XMMS, Audacious, Amarok (1.x), MPD (via mpc), Rhythmbox, and Exaile are supported.
<br/><br/>
When creating a NowPlaying message, the entry dialog will turn red if an unsupported variable is detected. The different players have support for different metadata, so follow the legend when configuring your message.


</li>
<li><h2>Customization</a></h2>
<ul>
<li><h2 class="underline"><a name="IconThemes">Icon Themes</a></h2>
<p>
Icon themes refer only to the 16x16 pixel .png and images that display in the trayicon, the user status column in user lists, and the notebook tabs.
</p>
<p>
The files in the img/ subdirectory are stored in the imagedata.py file as data strings and loaded at runtime.
</p>
<h3 id="Files">Files</h3>
<ul><li>hilite.png
</li><li>online.png
</li><li>away.png
</li><li>offline.png
</li></ul><ul><li>hilite2.png
</li><li>away2.png
</li><li>connect.png
</li><li>disconnect.png
</li></ul><h2 id="StatusTrayHiliteIcons">Status, Tray, Hilite Icons</h2>

<p>
To update imagedata.py, edit the .png files and then, from the root nicotine+ source directory run:
</p>
<pre class="wiki">./encode_bitmaps.py
</pre>
The images will be stored in the pynicotine/gtkgui/imagedata.py file.

</li>
<li><h2 class="underline"><a name="SoundThemes">Sound Themes</a></h2>
Any directory with private.ogg and room_nick.ogg works as a sound theme directory.
</li>
<li><h2 class="underline"><a name="GtkTheme">How To Change GTK+ Theme</a></h2>
There's a file named <b>.gtkrc-2.0</b> in the home directory. You edit this file in a text editor, or use a theme selector. A nice stand-alone theme switcher is <a href="http://www.muhri.net/nav.php3?node=gts">gtk-theme-switch2</a>. Other theme selectors are provided by Gnome and XFCE's configuration tools. KDE also has a GTK theme configuration tool.
</li>
<li><h2 class="underline"><a name="SoulseekPorts">Understanding Soulseek Ports</a></h2>
First, use daelstorm's <a href="http://thegraveyard.org/daelstorm/slsktest.php">Soulseek Port Test</a> with the <b>client connection port</b> Nicotine+ is currently using (you'll find it under Settings-&lt;Server).

<h3>Who should read this document?</h3>
<ul>
<li>Just started using Nicotine+ and/or Soulseek network</li>
<li>Having connection problems</li>
<li>Can't browse majority of users</li>
<li>Majority of users cannot browse you</li>
<li>Down/Uploads almost always fail</li>
<li>Requesting User Shares or User Info usually fails</li>
</ul>

<h3>Don't bother to reading this...</h3>
<ul>
<li>If you have no idea what a network, firewall, router, or port is and don't want to know.</li>
<li>If you have no control over your internet connection.</li>

</ul>
<h2>What are Ports?</h2>
Almost all software that sends and receives data over internet uses specific<br />
ports to be able to communicate with other computers which have the data. You can think of IP addresses as street addresses and ports as apartment numbers in a tower housing building with 65,536 apartments.
<ul>
<li>Web browser<ul><li>example: Internet Explorer, Mozilla Firefox</li><li>Use port 80 and port 8080 and others</ul></li>
<li>FTP client<ul><li>example: filezilla, gFTP, WS_FTP</li><li>Use port 21</li></ul></li>

<li>email client<ul><li>example: outlook, Thunderbird, SeaMonkey</li><li>Use port 110</ul></li>
<li>Instant Messaging<ul><li>example: MSN, GAIM, Gajim, ICQ</li><li>port: each of these have their own specific ports.</ul></li>
</ul>
<br />
<h2>Soulseek ports</h2>
By default, Nicotine-Plus uses ports 2234 as a 'listen port'.<br />

Other Soulseek clients also use this port by default.<br />If you have more than one client running, the next port, 2235, will be tried, and so on.<br />If you wish, you can change the default port in Settings-&gt;Server.<br /><br />
This means that the listen port needs to be open on your system, forwarded from your router and/or allowed through your firewall if you have either of them.<br />

<h2>Local &amp; Remote Misconfigured Firewall or Router</h2>
<img src="Images/AdditionalDocuments/soulseekports_misconfiguredfirewallboth.png"><br />
<b>problem</b>: A significant number of users fail browsing, downloading, uploading, or getting userinfo and many search results are never recieved. Remote users with misconfigured network settings will always fail to connect to you. A small number of users will connect with you flawlessly because their network settings are correctly configured.<br />
<b>solution</b>: You need to fix your own system, whether it's your router or firewall.

<h2>Remote Misconfigured Firewall or Router</h2>
<img src="Images/AdditionalDocuments/soulseekports_misconfiguredrouterremote.png"><br />
<b>problem</b>: You know your port is accessible, but a some users still are not be able to download or upload to you, connections lag and fail quite often, connections timeout.<br />
<b>solution</b>: The users' own ports are probably not accessible. Send the user a message and see if he/she is able to fix the issue. (and help! if you can)

<h2>Local Misconfigured Firewall or Router</h2>
<img src="Images/AdditionalDocuments/soulseekports_misconfiguredrouter.png"><br />
<b>problem</b>: Not being able to upload to many other Soulseek users.<br />
<b>solution</b>: Either put Nicotine+'s listen port in the list of <b>allowed</b> ports, and/or forward the proper port(s) (I.E. 2234) from your router to your system running Nicotine+.



<h2>Ideal Configuration</h2>

<img src="Images/AdditionalDocuments/soulseekports_ideal.png"><br />
On the left, your system (local), then internet, and at the right the other users system (remote).<br />
The best situation would be if both systems are configured properly, <br />
so a bidirectional communication is possible. As long as you both have accessible listen ports, and bandwidth everything should work.
<br /><br /><br /><br />

</p>
External links:
<ul><li><A href="http://portforward.com">Port Forward</a> Router guides
</li></ul>


</li>
</ul>
</li>

</ol>
<hr /></div>
</body>
</html>