# Nicotine+ Guide

### by Vandy Omall and daelstorm

view online version

## Table of Contents

1. Conventions Used in This Guide
2. Frequently Asked Questions
3. Installation
   - Dependencies
   - Linux
   - Windows
   - Apple
4. Settings
   - Before you connect
   - Server
   - Shares
   - Transfers
     - Events
     - Geo Block
   - Interface
     - Colours
     - Icons
     - Notebook Tabs
   - Chat
     - Away mode
     - Logging
     - Censor List
     - Auto-Replace
     - URL Catching
     - Completion
   - Miscellaneous
     - Ban/ignore
     - Sounds
     - Searches
     - User info
     - Import Config
5. Getting Around
   - Basics
     - Menus
     - Tabs
     - Log window
   - Chat rooms
     - Menus
     - /Commands
   - Private chat
     - Menus
     - /Commands
   - Downloads & Uploads
     - Menus
     - /Commands
   - Search Files
     - Menus
   - User info
   - User browse
     - Menus
   - Interests
     - Menus
   - Buddy list
     - Menus
6. Aliases
   - Now Playing (use the NowPlaying dialog for versions >= 1.2.6)
7. Customization
   - Icon Themes
   - Sound Themes
   - How To Change GTK+ Theme
   - Understanding Soulseek Ports

1. ## Conventions Used in This Guide

   Grey background with dark-grey border and black font-color (Used for commands, command output, and switches)

       ./nicotine

   ### Icons

   ### Mac users

   This icon designates a Mac note relating to the surrounding text.

   ### Windows users

   This icon designates a Windows note relating to the surrounding text.

   ### Warning

   This icon designates a warning relating to the surrounding text.

   ### Explanation

   This icon shows a situations for better understanding relating to the surrounding text.

   ### Tip

   This icon designates a tip relating to the surrounding text.

   ### Note

   This icon designates a note relating to the surrounding text.

2. ## Frequently Asked Questions

   - Where do I download Nicotine-Plus?
     You can download Nicotine-Plus from Trac / Wiki, via the Website, or directly from Sourceforge project file mirrors.
   - Where did Nicotine-Plus originate from?
     Nicotine-Plus is a fork by daelstorm of Nicotine, hyriand's fork of PySoulSeek, Alex Kanavin's original Python/WxGTK client. Several other programmers have contributed to Nicotine-Plus' development. Check the credits for more information.
   - How do I initiate uploads to my buddies or trusted users?
     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.
   - Where's the Mac OS X version?
     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.
   - What are privileges?
     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 your 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.
     - The first kind of priority is global privileges. You get global privileges after donating real money to the official soulseek website.
     - The second kind of privileges is per-user privileges. Depending upon each user's configuration, all or some of their buddies may get privileges.

3. ## Installation

   - ## Dependencies

     On Linux, the BSDs and Mac OS X, a X-Server is required.
     If you want to use a Windows installer you only need to install GTK+.

     ### Required Dependencies

     - GTK2 Gimp Tool Kit Version 2 (requires 2.6.x, preferably 2.10.x)
     - PyGTK2 Python Bindings for GTK2 (requires 2.6.x, preferably 2.10.x)
     - Python Python 2.x or greater

     ## Optional Dependencies

     - PyOGG & PyVorbis ( OGG metadata support )
     - GeoIP Python API (Country lookup / blocking support )
     - Psyco (Speeds up Python Code execution)
     - Sound Effects
       - ogg123
       - soX ( >= 1.2.5 )
       - GStreamer-Python ( > 1.2.7.1 )
     - The TrayIcon is a Python module the requires the development packages of PyGTK, GTK2 and Python as well as GCC.
       Nicotine+ > 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.
     - Spell Checking requires libsexy and sexy-python. Libsexy uses Enchant.
     - Download Notifications requires notification-daemon & notify-python & libnotify

   - ## Nicotine+ Installation: Linux

     The easiest way of running Nicotine+ is to download source, untar the tarball and run nicotine straight from the source directory.
     To install Nicotine+, you should get a package from your distribution, if possible.
     1. Download the latest release from nicotine-plus.sf.net.
     2. Extract the tarball

            tar jxvf nicotine+-X.X.X.tar.bz2

        or

            tar zxvf nicotine+-X.X.X.tar.gz

     3. Change to the nicotine directory

            cd nicotine+-X.X.X

     4. Run nicotine

            ./nicotine

   - ## Nicotine+ Installation: Windows

     To get Nicotine working under windows you need to download and install:

     - A new GTK+ 2.10 / Win32 installer
     - A Nicotine+ windows installer
       - Past versions of nicotine sometimes had Bundle installers.
         Bundles usually contained mp3's, application or an ebook. Always provided by the author with permission
       - Normal, or 'Lite' installer is the Nicotine+ Application, its dependencies, and Source.
     Installer always allows you to choose what you want to be installed.

     ### How to install for 1.2.7.1 and greater

     - download & install gtk+-win32-runtime version 2.10 or greater
     - download & nicotine+-x.x.x-win32.exe (x.x.x is current version number, choose the latest)

   - ## Nicotine+ Installation: Apple

     - Install X11
     - Get DarwinPorts
     - Open a Terminal (Finder->Applications->Utilities)
     - Install all dependencies required by PyGTK2 (This will take a very long time)

           sudo port install py-gtk2

     - You have two options: Download and extract a release tarball, or checkout the latest development code from the Subversion repository.
     - - Subversion:
         First, install subversion with DarwinPorts

             sudo port install subversion

         Then, download the latest source code.

             svn checkout http://nicotine-plus.org/svn/trunk/nicotine+ nicotine+

             cd nicotine+/

             ./nicotine

       - A release tarball:
         Follow these instructions
   - You can also use the ancient nicotine.app for Nicotine 1.0.8 (it's a PPC build)

4. ## Settings

   - ## Settings: Index

     When you click on settings name, in this case Connection, you get to see a short explanation of what you can configure.
     Connection settings has 3 items. Each can be use to configure settings which suit you the best.
     - Server allows you to configure login/password info.
     - Shares allows you to add files/directories for share
     - Transfers allows you to configure upload limits and download filters.
     - Interface allows you to configure many and varied GUI customizations.

   - ## Settings: Before you connect

     These settings are needed to connect to Soulseek Network or a Soulfind server.
     The first time you run Nicotine+, the settings dialog will appear and you should enter the following:
     In Server settings:
     - A username.
     - A password.
     In Shares settings:
     - The download directory.
     - One or more shared directories (or share your download directory).
     Now press OK to close the settings window and through the Main Menu select: File->Connect.
     If all goes well, you will be connected to the Soulseek server and automatically join the nicotine chat room.

   - ## Settings: Server

     Server settings allows you to choose the server you wish to connect to and configure your username, password and connection ports.

     ### Server

     This combo entry allows you to choose which server and port you want connect to
     - The default server is: server.slsknet.org:2242
     - Unless you know what you doing, leave this option default!

     ### Login

     Fill this entry with your username.
     - If it's the first time you're connecting to Soulseek Network, you may have chosen a username that is already in use.
     - Look in Log window to see if your username is in use. If it's already used by someone else you'll see an INVALID PASS message, and the settings dialog should reappear with the password entry colored red.
     - If it's not in use, well, you'll just connect and enjoy Nicotine+, Soulseek Network and the whole experience :)

     ### Password

     Fill this entry with your password. It will be hidden while you type it.
     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.

     ### Network Character Encoding

     This allows you to choose the default encoding for all strings (such as transfer filenames, shares, and chat messages)
     - By default, it's UTF-8
     - 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).

     ### Client connection ports

     This is a range of possible ports that is used by Nicotine+ to connect to peers, and for peers to connect to you.
     - By default, the range is 2234 - 2239. 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. :)
     - There's a short guide on Soulseek Ports by daelstorm

     ### I can receive direct connections

     - If ports are open and can receive direct connection, check that box

     ### CTCP VERSION

     This allows other users to check which version Nicotine+ you have.
     - By default, it's checked
     - If other users have this option checked, you can check their version.
     - You do this in Private chat session with the Client Version item in the popup menu or the /ctcpversion command.

   - ## Settings: Shares

     Shares allows you to configure your Download and Shared files directories
     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 Ok or Apply buttons.
     You can manually rescan from the Edit menu or /rescan. Rebuilding shares does not use mtime to determine whether to rescan a directory. Rebuilding instead of rescanning is neccessary with FAT filesystems.
     One or more progress bars (depending whether you have Buddy-only Shares enabled) will show you the shares scanning progress.
     In Log window you can see messages:
     - Rescanning started shows that scanning of your shared folders is started
     - Rescanning finished shows when scanning is finished

     ### Incomplete directory

     - 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.
     - After a file is finished downloading, it is then moved to your chosen Download directory (see below)

     ### Download directory

     - 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.
     - For example: /home/your_username/Soulseek Downloads

     ### Share download directory

     This allows you to share your download directory, which will also add new completed downloads to you shares immediately.
     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)

     ### Upload directory

     - Choose where finished remotely-initiated downloads should be stored (Your buddies will manually upload files to subdirectories (of their usernames) to this directory.
     - It's a good idea to place this directory separate from your downloads, or in a special uploads subdirectory to avoid confusion.
     - For example: /home/your_username/Soulseek Uploads

     ### Rescan shares on startup

     This will automatically rescan your shares every time you start Nicotine+. If you often move or rename files and directories, enable this.
     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.

     ### Shares list

     - This is a list of shared directories. Use the Add and Remove buttons to select directories you wish to share.
     - 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.

     ### Buddy-only shares

     - 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.
     - Buddy-only shares includes normal shares, so there's no need to add the same directories to Buddy-only shares.

   ## Settings: Transfers

   Transfer settings allows you to configure how uploads are queued and what privileges you give to Buddies

   ## Upload queue

   ### Upload queue type

   Set the queue method here.
   - Round-robin uploads one file to each user and the changes to another user.
   - First in, First out will upload in the order of oldest-queued to newest queued.

   ### Queue Uploads if total transfer speed reaches __ KBytes/sec

   - By default it's 10
   - When transfer speeds go over this limit new transfers will be queued.

   ### Limit number of upload slots to ___

   This option allows you to limit the maxiumum number of files that can be uploaded at the same time.
   - By default it's unchecked
   - 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.
   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.

   ### Limit upload speed

   This allows you to choose at which speed file(s) gets uploaded and by which method to limit it: per transfer or total transfers
   - By default it's unchecked
   - 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 total transfers.

   ## Each user may queue a maximum of ...

   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.
   - By default the size limit is 100 Megabytes (approximately one album)
   - By default the number of files limit is 1000
   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.
   The user gets to see the following message: Remote: User limit of xx megabytes exceeded
   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.

   ### Allow these users to send you files

   Allows a specific group of users that you've selected to send you files.
   - By default it's Users in list
   - The other options are: No one, Everyone, and Trusted Users
   - The files these users send you will be saved in the Uploads directory

   ## Privileges

   ### Share to friends only

   This allows only people who're in Buddy list to download your shares. If you have buddy shares enabled, they will obviously be getting them instead of your normal shares.
   - By default it's unchecked
   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.

   ### Privilege all my friends

   This allows all users in your Buddy list to download before other non-privileged users. This effectively makes your buddies equal to privileged users.
   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.

   ## Download Filters

   ### Enable filters

   This allows to filter out unwanted files in your download queue. This is useful for when you download a folder that has useless or unneeded metadata files.
   - By default it's checked

   ### Verify filters

   This will check the filters' regular expression syntax for errors and display a message if there are problems.

   ### Filters list

   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.
   - Filters with escaping enabled will escape non-ascii characters (it's a lot simpler and prettier) and * will be replaced with .*, which is any length of any kinds of characters.
   - Escaping non-ascii characters makes the regular-expression treat them as real characters instead of syntax.
   - For example, the escaped filter *.url will be invisibly converted to .*\.url. Unescaping it will result in a regexp error, since * will need a character to preceed it.
   - For more information, Google "python regular expressions" or read this Regular Expression Howto.

   ### Lock incoming files

   This allows you to lock incomplete files, so these cannot be accessed by other processes. (Required for some filesystems)
   - By default it's checked
   If you have the same Incomplete and Download directory (the default setting), it's a good idea to keep this option checked.

5. ## Settings: Events

   Event settings allow you to configure which command or application is to be executed after a download is finished.

   ### Show notification-popup in tray after download

   This feature requires notification-daemon, notify-python, libnotify. You can get more information at the website.

   ## Commands

   ### Run command after download finishes

   This allows you to run a command or application after download of 1 file is finished.
   Example: xmms -e $

   ### Run command after folder finishes

   This allows you to run a command or application after download of 1 folder is finished.

   ### File manager command

   This allows you to launch a filemanager to view a folder
   Example: rox $

6. ## Settings: Geo Block

   This option is NOT available for Nicotine+ Windows version. Geo Block allows you to block specific users from a country.

   ## Enable geographical blocker

   When checked you can configure 2 options as explained below.

   ## Geographical paranoia

   Blocks users who possibly use proxy server to hide their real IP

   ## Country codes

   Use this option to block users from specific countries by typing country codes separated by comma (,)
   example: us,nl,pl,se,de blocks the USA, Netherlands, Poland, Sweden and Germany

7. ## Settings: Interface

   - Colours
   - Icons
   - Notebook Tabs
   Interface 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.

   ### Enable spell checker

   This feature requires libsexy and sexy-python. You can get more information from their website. 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.

   ### Show buttons in transfer tabs

   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.

   ### Show tooltips

   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.

   ### Chat font

   All text in the textviews will use this font.
   - If no font is selected, the default font for your GTK theme will be used.
   - The clear button will reset the font to the default font of the GTK theme.

   ### Decimal Seperator

   This is the character used for seperating numbers, such as 1000 to 1,000.

   ### Translate to another language

   Enabling this will cause an override of the system's language settings
   - The Language selector is blank by default.. it will use the English strings instead of the language set by your operating system's Locale.
   - Select a language code to use after restarting. (Don't forget to save your settings first)
   - For an example of setting the translation to Polish see this Screenshot

8. ## Settings: Colours

   ## Chat colours

   Which colours the various text messages will get displayed as in Chat Rooms and Private Chat
   Chat color settings are only for you, other users will the colours they've selected.

   ### Remote text

   This the color of other users in the chat logs
   - By default, it's unset

   ### Local text

   These are your messages, you see them in Chat room and Private chat sessions
   - By default, it's BLUE

   ### /me text

   This is used to state what you're doing instead of talking

- By default, it's FORREST GREEN
- "/me is going to eat something" shows up as "timestamp * user is going to eat something"
- 01:07:01 * user is testing
- 21:06:55 * user checks timestamps and stops expecting an answer

### Highlighted text

This is a message that includes your username

- By default, it's red

### URL Link text

This is a http:// or other URL link

- By default, it's #3D2B7F

## Username colours and hotspots

Enable this for usernames in chat room logs can have popup menus and colours and font styles.

### Display away colours

If this is disabled (as it is by default) usernames will not change colour when a user goes away.

### Online

- By default, it's BLACK

### Offline

- By default, it's #AA0000

### Away

- By default, it's Orange

### Username Font Style

The font style for usernames can be bold, italic, normal, or underlined.

## List and Search colors

To make searching and downloading files easier, you can choose to color your search results

### List text

- By default, it's colour is unset

### With queue

Search results that have a queue

- By default, it's GREY

### Offline search

Search results of users who are now offline

- By default, it's #AA0000

### Background

The background colour for lists and other widgets.

- By default, it's unset

### Input text

The foreground (text) colour for text entry widgets.

- By default, it's unset

## Tab colors

### Default

The normal tab text colour.

- By default, it's unset

### Changed

The notification tab text colour.

- By default, it's #0000FF

### Highlight

Higher priority notification tab text colour.

- By default, it's Red

## Transparent Log Windows

This feature draws the root window in the background of the textviews (chat logs, etc) with configurable amount of colour and alpha (transparency).

9. ## Settings: Icons

   ## Icon Theme Directory

   This feature is available from Nicotine+ 1.2.4 and up.
   Select a directory with images and Nicotine+ will use for online/offline/away/hilite indication.
10. By default, it's empty

11. ## Settings: Notebook Tabs

    ## Close button on tabs

    If you want to have close buttons in tab labels
    - By default, it's checked

    ## Notification icons on tabs

    If you want to have icons appear in tab labels
    - By default, it's checked

    ## Notification changes the tab's text colour

    If you want to have coloured text in tab labels
    - By default, it's unchecked
    - Set these colours in the Colours settings

    ## Tab positions

    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.
    - By default, they're all Top and 0⁰

12. ## Settings: Chat

    - Away mode allows you to configure your auto-way settings
    - Logging allows you to configure what's logged and where to save the logs
    - Censor List
    - Auto-Replace
    - URL Catching allows you to choose which application should start after you click a link
    - Completion

13. ## Settings: Away mode

    ## Toggle away

    If you're gone behind your PC after xx minutes then your status changes in "away".
    Your status icon in chat rooms and elsewhere will change to the away icon.
    - By default, it's 15 minutes

    ## Auto reply

    Here, you can configure a message that users get to see when they start a Private chat with you while you're set away. If no message is set, no message will be sent.
    - By default, it's empty

14. ## Settings: Logging

    Chat room and Private chats can be logged if you want to keep track of your (important) conversations

    ## Log private chat by default

    - By default, it's unchecked (disabled)

    ## Log chatrooms by default

    - By default, it's unchecked (disabled)

    ## Log transfers

    Keeps logs of you down/uploads
    - By default, it's unchecked (disabled)

    ## Logs directory

    Where logs are saved.
    - By default, it's /root

    ### How to change Logs directory

    - Click on Choose
    - Navigate to your chosen folder
    - Click OK
    - Click Apply or OK

15. ## Settings: Censor List

    - This is a list of words that other people say in chat which will be replaced with some character (* by default). If you say these words, they will not be censored.
    - This feature is disabled by default, but can be enabled by the Enable Censorship checkbox.
16. You can Add and Remove individual words, or Clear to empty the list

17. ## Settings: Auto-Replace

    - 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.
    - This feature is disabled by default, but can be enabled by the checkbox.
    - You can select any character to replace the letters in the censored words.

18. ## Settings: URL Catching

    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.
    This window allows you to choose which browser you want to use.
    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.

    ## Enable URL catching

    - By default, it's checked
    - If disabled, URLs will not be underlined or clickable, and, even if you enable it later, old URLs will not be clickable.

    ## Humanize slsk: // urls

    This will replace the ugly characters, like %20, with human-readable stuff.
    - By default, it's checked

    ## Protocols handlers

    allows you to choose which handler suppose to handle which protocol
    - By default, the protocol list contains http and https
    - The default handler is firefox "%s"
    You can only have one handler for each protocol.

    ### Adding a new protocol & handler

    - Fill in the protocol entry with your desired protocol.
    - Fill in the handler entry with your desired application command. %s is the URL, and should probably be surrounded by quotes. You can also choose from a set of predefined handlers in the combolist.
    - Click Add

    ### Remove a protocol handler

    - Click on specific handler, for example http | firefox "%s"
    - Click Remove
    "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.

19. ## Settings: Completion

    There are a multitude of options for configuring tab completion and the dropdown completion list.

20. ## Settings: Miscellaneous

    - Ban / ignore let's you manage your ban, ignore and IP blocking lists
    - Sounds allows you to configure sound settings
    - Searches allows you to configure search settings and set default filters
    - User info allows you to add text and an image to your personal info
    - Import Config allows you import config settings from the official windows clients. (I.E. versions 156, 157)

    ## Settings: Ban / ignore

    When you Ban or Ignore users via Chat room or Private chat they get listed here.

    ## Banned Users

    List of banned users. Banned users are blocked from downloading from you and from viewing your shares
    - Add allows you to add a new user by typing their name
    - Remove allows you to remove a banned user from the list (unbanning the user)
    - Clear removes all users in ban list

    ## Ignored Users

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

    ## Blocked IP Addresses

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

    ## Use custom ban message

    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)

21. ## Settings: Sounds

    Sound effects are short ogg vorbis audio files.

    ### Enable Sound effects

    You will be able to select an OGG audio player to play the sound effects

    ### Enable Text to Speech

    You will be able to select a command to read strings and output them as synthesized speech.

    ### Audio player command

    Launch an external process to read a local file (a partial or completed download, an upload, or a file in your own shares).

22. ## Settings: Searches

    ## Network searches

    Sends out a maximum of xx results per search request
    - By default, it's 50
    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.

    ## Your searches

    - Use regular expressions for filter in & out
    - Filter in
    - Filter out
    - Size
    - Bitrate set bitrate of (mp3, OGG, xx) you only want, 128, 192, 320 for example
    - Country set search results from countries you want, example: file has English title, but creator is from Netherlands.
    - Free slot displays users who have xx slots open, for faster download start

## Settings: User info

When users request your User info, they get to see some info provided by you. You can provide that kind of info here.

## Self description

Put here what you want others to know.
You can only add plain text. HTML and BB tags won't work.
If you have a webpage or profile somewhere, add it here, instead of having a long self description

## Image

picture of yourself, pet, car, house, whatever you want others to see
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.

23. ## Settings: Import Config

    Set the directory to your Soulseek installation's directory. Choose the config options you wish to import and press the Import config button.
    Some of these will overwrite config options (such as Login / password), so be careful.

24. ## Getting Around

    - ## Nicotine+ Getting Around: Basics

      Finally after going through (hopefully) not too much hassle, you can begin sharing your world with friends,
      family and interesting people around the world. Nicotine is not difficult to understand as most of it is self explanatory..
      Reading through the Basics you might discover something new and use it for your benefit.
      After downloading, installing and configuring you're now a part of Soulseek Network.
      Nicotine+ can become one of your most used and valuable application you run...
      Getting to know it better has it's benefits in making life somehow easier and troubleshooting when hitting a problem...

      ## Nicotine Tabs

      As said before, Nicotine+ is pretty much self explanatory... At the top you see tabs, each for function you can use.

      ## Commands

      You can access a list of commands used in Nicotine by going to Help

      ## Right mouse-click

      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:
      - Chatroom
        - Log window
        - user-in-room-list
        - room-list
      - Private chat
      - Downloads
      - Uploads
      - Userinfo
      - Userbrowse
      - Interests
      - Userlist

      - ## Nicotine+ Getting Around: Basics, Menus

        Nicotine has menus other than menus which can be viewed with right-mouse-click. The menus are File and Help.

        ## File menu

        - Connect connects you with the Soulseek Network
        - Disconnect breaks the connection with Soulseek Network (logs you out)
        - Away/Return can be used to let other users know if you're behind the computer or not.
        - Check privileges
        - Show debug info 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.
        - Hide log window Hides the log window
        - Hide room list Hides chatroom list
        - Hide tickers Hides ticker in chatrooms, very useable in rooms with lots of users
        - Settings Opens Nicotine+ configuration window
        - "Rescan shares" If you move files while Nicotine is open, you can better Rescan shares once in a while without restarting
        - Browse my shares let's u see your own files as the way other user see it when they browse you
        - Exit Do I really have to explain this? :)
        Most menu items can be used through shortcuts. Try to remember them, so you don't need to hunt and click with your mouse

        ## Mode menu

        - Chat Rooms switches to Chat rooms window
        - Private Chat switches to Private chat window
        - Downloads switches to Downloads window
        - Uploads switches to Uploads window
        - Search Files switches to Search files window
        - User Info switches to User info window
        - User Browse switches to User browse window
        - Interests switches to Interests window
        - Buddy List switches to Buddy list window

        ## Help menu

        - About chat room commands shows you a list of all the commands you can use in Chat room
        - About private chat commands shows you a list of all the commands you can use in Private chat
        - About search filters shows tips on how to refine your searches
        - Check latest shows you if there is a new Nicotine version available and where to download it
        - About Nicotine shows Version and Credits

      - ## Nicotine+ Getting Around, Basics, Tabs

        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.
        - Chat rooms lists all the rooms you're in
        - Private chat lists all the chat-sessions you have with friends, family and other users
        - Downloads lists all the files you're downloading, as well from who, download speed, progress or when it's your turn to download
        - Uploads lists all the files you're uploading, as well to who, upload speed and progress
        - Search files you can use to search for files as well how long you have to wait and what speed you can download from a user
        - User info shows you info about a user that has provided more info about him/herself.
        - User browse lists all the windows which shows what other user have shared
        - Interest 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.
        - Buddy list shows a list of users. You can add comments for each user like email or what he/she is sharing

      - ## Nicotine+ Getting Around: Basics, Log window

        Nicotine has a Log window, which stays there even if you switch Tabs.
        - Messages are send as follow: [time] message
          - [time] is when it happened
          - message can be anything, more info? see below
        - First time you connect you see a message which is send to your Nicotine by Soulseek Network.
        - After a while you see "[time] XXXX privileged users" which means there're XXXX users who have donated and get priority if they download.
        - If you have "show debug info" checked, you see what nicotine is doing in background.
        - When some user Browses you files you see: [time] [user] is making a Browseshares request
        - When some user wants your user info you see:[time] [user] is making a Userinfo request
        - When download starts you see: [time] Download started: path/to/download/folder - file_name.xxx
        - When download finishes you see: [time] Download finished: path/to/download/folder/file_name.xxx
        You can turn on/off debug info by going to "File --> Show debug info "
        You can hide Log window by using Hotkey "Alt + H" or going to "File --> Hide log window"

    - ## Nicotine+ Getting Around: Chatrooms

      Chatroom is a big foundation which makes Soulseek network so different from other P2P.
      Soulseek really went back to the basic of sharing like it was meant to be. Nicotine+ has some extra
      features in Chat rooms window. We will discuss them here.
      - Chat room log window: Just under the tab which holds the name of the chatroom you're in you can see Chat room log window.
      - Chatroom: Under the log window you see the chat room itself. You can talk to other people and read what they say
      - Message input: Below the Chatroom you see the message input. There you just type and hit enter to send your message
      - Users-in-room-list: On the right of Chat room you see users-in-room-list window, which lists all users who're in the room,
        online/away status, connection speed and number of shared files.
      - Room-list: Placed far on the right, shows you most rooms that Soulseek network holds. Join room by double clicking or using right mouse-click menu.
        If you don't see the room you're looking for "right mouse-click --> Refresh".
        To access right click menu on, use âŒ˜ + mouse click
      - Log: Below users-in-room-list you see a check button for saving Chat room's history as a log file.
      - Auto-join: Next to Log you see Auto-join when selected, next time you start Nicotine+ you will join the room automatically.
      - Leave: Button next to Log check field, exit the room you're in.
      - Create: Allows you to create your own room! if the room already exist, then you simply join.

      - ## Nicotine+ Getting Around: Chatroom Roomlist Menus

        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.
        - Send Message will start a private chat with the chosen user
          - nicotine 1.2.1 and below users have to click on private chat manually
        - Show IP address will print the IP address and port the user is connected to Soulseek with into the log window.
          - Optionally, if you have the GeoIP bindings installed, it'll show the user's country of origin.
        - Get user info will load the user's queue status, as well as the user's text and pictures, if any was added by that user.
        - Browse files will load the user's files in the User browse tab, allowing you to view that user's shares.
        - Give Privileges allowing you to give other users your Soulseek Privileges you received by sending a donation to www.slsknet.org
        - Add user to list will drop that user into buddy list, where you can give them privileged status, add comments or even ban them, if you wish.
        - Ban this user will block that user from downloading from you and from viewing your shares.
        - Ignore this user will make that user disappear from chat rooms and private chat.
        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. âŒ˜ + mouse click.

      - ## Nicotine+ Getting Around: Chatroom /Commands

        There are quite a few commands in Nicotine that you may find useful. Commands save time otherwise wasted on lots of hunting and clicking.
        List of commands is available via "Help --> About chat room commands"
        - /join /j 'room' Join room 'room'
        - /leave /l 'room' Leave room 'room'
        - /part /p 'room' Leave room 'room'
        - /clear /cl Clear the chat window
        - /tick /t Set your personal ticker
        - /add /ad 'user' Add user 'user' to your Buddy list
        - /browse /b 'user' Browse files of user 'user'
        - /whois /w 'usr' Request user info for user 'user'
        - /ip 'user' Show IP for user 'user'
        - /alias /al 'command' 'definition' Add a new alias
        - /alias /al 'command' 'definition' |(process) Add a new alias that runs a process
        - /unalias /un 'command' Remove an alias
        - /ban 'user' Add user 'user' to your ban list
        - /unban 'user' 'Remove user 'user' from your ban list
        - /ignore 'user' Add user 'user' to your ignore list
        - /unignore 'user' Remove user 'user' from your ignore list
        - /msg 'user' 'message' Send message 'message' to user 'user'
        - /pm 'user' Open private chat window for user 'user'
        - /search /s 'query' Start a new search for 'query'
        - /rsearch /rs 'query' Search the joined rooms for 'query'
        - /bsearch /bs 'query' Search the buddy list for 'query'
        - /usearch /us 'user' 'query' Search a user's shares for 'query'
        - /rescan Rescan shares
        - /away /a Toggles your away status
        - /quit /q Quit Nicotine
        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.

    - ## Nicotine+ Getting Around: Private chat

      Private chat window consist of a few parts.
      - Username tabs: Every user you having private chat with has a tab. When you chat with more than one user you
        can switch between them by clicking on the tab. Tabs are located far to right
      - Private chat itself: The biggest window you can see. Your lines are colored in blue and the other persons coversation is black
        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])
      - Message input: Just under the private chat's biggest window. There you can type whatever you want to say and hit enter
      - Log: Next to message input, checkbox for logging chatsession.
      - Close button: Next to Log Log checkbox, Closes chat session

      - ## Nicotine+ Getting Around: Private chat Menus

        Right mouse-click gives you access to several option you can use in a private chat session.
        - Close closes the parent chat session
        - Show IP address will print the ip address and port the user is connected to Soulseek with into the log window
        - Get user info will load the user's queue status, as well as the user's text and pictures, if any was added by that user
        - Browse files will load the user's files in the User browse tab, allowing you to view that user's shares.
        - Give privileges you can give a user priority for downloading files, which means he/she doesn't have to wait before downloads starts
        - Add user to list will drop that user into buddy list, where you can give them privileged status, add comments or even ban them, if you wish
        - Ban this user will block that user from downloading from you and from viewing your shares
        - Ignore this user will make that user disappear from chat rooms and private chat
        - Client version shows users Nicotine version

      - ## Nicotine+ Getting Around: Private chat /Commands

        Nicotine+ Getting Around: Private chat Commands
        There are quite a few commands in Nicotine that you may find useful. Commands save time otherwise wasted on lots of hunting and clicking.
        List of commands is available via "Help --> About private chat commands "
        - /close /c Close the current private chat
        - /clear /cl Clear the chat window
        - /add /ad 'user' Add user 'user' to your Buddy list
        - /browse /b 'user' Browse files of user 'user'
        - /whois /w 'usr' Request user info for user 'user'
        - /ip 'user' Show IP for user 'user'
        - /alias /al 'command' 'definition' Add a new alias
        - /alias /al 'command' 'definition' |(process) Add a new alias that runs a process
        - /unalias /un 'command' Remove an alias
        - /ban 'user' Add user 'user' to your ban list
        - /unban 'user' 'Remove user 'user' from your ban list
        - /ignore 'user' Add user 'user' to your ignore list
        - /unignore 'user' Remove user 'user' from your ignore list
        - /msg 'user' 'message' Send message 'message' to user 'user'
        - /pm 'user' Open private chat window for user 'user'
        - /search /s 'query' Start a new search for 'query'
        - /rsearch /rs 'query' Search the joined rooms for 'query'
        - /bsearch /bs 'query' Search the buddy list for 'query'
        - /usearch /us 'user' 'query' Search a user's shares for 'query'
        - /rescan Rescan shares
        - /away /a Toggles your away status
        - /quit /q Quit Nicotine
        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.

    - ## Nicotine+ Getting Around: Downloads/Uploads

      All of the things you can do in Downloads/Uploads are accessible through right mouse-click. Upload window is
      the same, except for the fact that Download lists all files that you're DOWNLOADING and Upload for UPLOADING :)

      - ## Nicotine+ Getting Around: Dowloads/Uploads menu

        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.
        - Get place in queue send the number of files ahead of you in the queue to the Log Window
        - Copy URL pastes a slsk:// link for the selected file in the copy buffer
        - Copy folder URL pastes a slsk:// link for the selected file's folder in the copy buffer
        - Send to player
        - Send message will start a private chat with the chosen user
          - nicotine 1.2.1 and below users have to click on private chat manually
        - Show IP address will print the ip address and port the user is connected to Soulseek with into the log window.
          - Optionally, if you have the GeoIP bindings installed, it'll show the user's country of origin
        - Get user info will load the user's queue status, as well as the user's text and pictures, if any was added by that user
        - Browse files will load the user's files in the User browse tab, allowing you to view that user's shares
        - Give privileges
        - Add user to list will drop that user into buddy list, where you can give them privileged status, add comments or even ban them
        - Ban this user will block that user from downloading from you and from viewing your shares
        - Ignore this user will make that user disappear from chat rooms and private chat
        - Abort will simply cancel download(s)
        - Abort and remove file(s) will cancel and delete the file(s) from the hard drive
        - Retry will attempt to complete the file(s) from wherever they left off
        - Clear will remove selected files from the list
        - Clear finished/aborted will remove finished or aborted files from the list
        - Clear finished will remove finished files from the list
        - Clear aborted will remove aborted files from the list
        - Clear queued will remove queued files from the list
        You can access most items by Letter Commands. (see next section)

      - ## Nicotine+ Getting Around: Download/Upload commands

        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...

        ### Popup Menu

        First you hit the letter P -- or right-click -- and then other Letter commands.
        - P = opens the popup menu, where more hotkeys are accessible
          - q = Get place in queue
          - u = Copy URL
          - p = send to player
          - m = send message
          - d = Show IP address
          - n = Show user info
          - s = Browse files
          - v = Give Privileges
          - a = Add user to list
          - b = Ban this user
          - i = Ignore this user
          - t = Abort
          - f = Abort and remove file(s)
          - r = Retry
          - c = Clear

        ### Transfer Panel

        Select some files and then just type one of these letters.
        - t = Abort Transfer(s)
        - r = Retry Transfer(s)
        - Del = Abort, Clear and Delete download(s); Abort and Clear upload(s)

    - ## Nicotine+ Getting Around: Search files

      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.
      - Search field: Just below Nicotine+ tabs, Type in what you're looking for and hit enter or click on Search button
      - Saved searches: Next to search field (button with arrow), previous entered search queries are saved to make filling out and searching easier
      - Search location: Next on the right of saved search button, allows you to choose where the file must be searched.
        - Global will search everyone connected to Soulseek Network
        - Rooms will show you search result from everyone in rooms you're in
        - Buddies will show you search results from everyone in you Buddy list
        - Search button: Next to right of Search location, when clicked search query is performed.
          Save time by hitting Enter after you fill out the search field.
        - Search query tab: Every search query gets it's own tab. Each tab gets it's name from what you're looking for.
      - Enable filters: Located just below a search query tab. Check button allows you filter what you have set up in settings.
        - You can configure some filters for better search results.
        - Configure your own set of filters by going to "File ---> Settings ---> Searches"
        - Read more about Search filters by going to "Help ---> About search filters"
      - Search results: The biggest window in Search tab. Shows you not only search results but also other info like:
        - Filename shows the name of file and extension
        - User shows which user is sharing
        - Size shows size of file in bytes ( 1 megabyte = 1 048 576 bytes )
        - Speed shows approximate download speed in kilobits p/sec.
        - In queue shows how many files are ahead of you
        - Immediate Download If you can begin downloading? Yes or No
        - Bitrate shows the files Bitrate, which is the quality... higher, the better and the bigger the file
        - Length shows how long the files plays in min:sec
        - Directory shows the path to file_name.xxx on users computer
      - Search results in the default theme colors are either black (for immediate download) or gray (queued, you have to wait)
      - Ignore button: located right, just below Search location buttons, If you get flooded by search results, which can happen with popular searches,
        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...
      - Close button: Located next to Ignore button, Closes current search results tab.
      - Remember checkbox: Located next too Close button, The remember check box will make your search run continuously and between sessions.
        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)

      - ## Nicotine+ Getting Around: Search files menus

        - Download file(s) adds the selected files to your download queue
        - Download file(s) to... allows you to choose where to save downloads
        - Download containing folder(s) allows you to download entire folders (and subfolders). Be careful with this option!
        - Copy URL pastes a slsk:// link for the selected file in the copy buffer
        - Copy folder URL slsk:// link for the selected file's folder in the copy buffer
        - Send message will start a private chat with the chosen user
          - nicotine 1.2.1 and below users have to click on private chat manually
        - Show IP address will print the ip address and port the user is connected to Soulseek with into the log window
        - Get user info will load the user's queue status, as well as the user's text and pictures, if any was added by that user
        - Browse files will load the user's files in the User browse tab, allowing you to view that user's shares
        - Give privileges allowing you to give other users your Soulseek Privileges you received by sending a donation to www.slsknet.org
        - Add user to list will drop that user into buddy list, where you can give them privileged status, add comments or even ban them
        - Ban this user will block that user from downloading from you and from viewing your shares
        - Ignore this user will make that user disappear from chat rooms and private chat

    - ## Nicotine+ Getting Around: User info

      User info is a window which shows information provided by some user and you request it.
      - Tabs

      ### 1.

      - Every user from which you request info gets a tab with his/her name and status (Online/Offline/Away)

      ### 2. Self description

      - You can read what a user has to say about him/herself.

      ### 3. Image

      - An image the user wants to show you, it could be a wallpaper, avatar or any kind of picture

      ### 4. Buttons

      > User info doesn't have menus, instead you can use buttons

      - Private chat will start a private chat with the chosen user.
      - Browse will load the user's files in the User browse tab, allowing you to view that user's shares.
      - Show IP will print the IP address and port that the user is connected to Soulseek with into the log window.
      - Add to list will drop that user into buddy list, where you can give them privileged status, add comments or even ban them
      - Ban will block that user from downloading from you and from viewing your shares
      - Ignore will make that user disappear from chat rooms and private chat
      - Save pic will save the user's picture
      - Refresh will load info about current user again
      - Close will close current user info window

      ### 5. Information

      This window displays some info about:
      - Total uploads allowed shows how many uploads at once the user allows.
      - Queue size how many files are in line to get uploaded.
      - Slots available shows how many upload slots are free.
      - Speed shows speed in Bits/sec.
      - Files Shared is the number of files shared.
      - Dirs Shared is the number of dirs shared.
      - When you "Refresh" user info the progressbar begins with 0 and when 100% filled it has finished downloading.

    - ## Nicotine+ Getting Around: User browse

      When you successfully Browse a user's files you can see the results in User browse window

      ### 1. Tabs

      - Every user which you Browse files gets a tab with his/her name and status (Online/Offline/Away)

      ### 2. Dirs

      - At the far left you can see all the dirs a user is sharing

      ### 3. Files

      - Next to "Dirs" you see files. When you click on a dir you see all the files that dir contains.

      ### 4. Refresh

      - Will try to load the user's shares again

      ### 5. Close

      - Closes current shared files window of user

      ### 6. Search

      Some users have so many files shared that manually searching through each directory is too much work.
      - Type in the name of a file or keyword you want to search for and hit the Enter key.
      - After every search you can hit Enter again to find the next file with the same name
      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.

      - ## Nicotine+ Getting Around: User browse menus

        User browse has two menus, one for directory tree and one for files list.
        The Files list has at two additional options under the Download submenu: "Download files" and "Download files to"
        - Both the directory tree and the files list menus have the following items
        - Download directory adds the selected directory to your download queue.
        - Download directory to allows you to choose where to save the directory
        - Download recursive downloads all files and subdirectories
        - Download recursive to allows you to choose where to save the contents of this directory
        - Copy URL pastes a slsk:// link for the selected file in the copy buffer
        - Send Message will start a private chat with the chosen user
          - nicotine 1.2.1 and below users have to click on private chat manually
        - Show IP address will print the ip address and port the user is connected to Soulseek with into the log window.
          - Optionally, if you have the GeoIP bindings installed, it'll show the user's country of origin.
        - Get user info will load the user's queue status, as well as the user's text and pictures, if any was added by that user.
        - Give Privileges allowing you to give other users your Soulseek Privileges you received by sending a donation to www.slsknet.org
        - Add user to list will drop that user into buddy list, where you can give them privileged status, add comments or even ban them, if you wish.
        - Ban this user will block that user from downloading from you and from viewing your shares.
        - Ignore this user will make that user disappear from chat rooms and private chat.

    - ## Nicotine+ Getting Around: Interests

      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.

      ### 1. Likes

      - You can add your likes there. Just click on + Add button.

      ### 2. Dislikes

      - You can add your likes there. Just click on + Add button.

      ### 3. Results

      After you added your likes and dislikes you can click on:
      - Global recommendations loads a list of
      - Recommendations loads a list of
      - Similar useres loads a list of users with likes/dislikes similar as yours

      ### 4. Recommendations

      - After you click on Global recommendations or Recommendations the list get loaded there

      ### 5. Similar users

      - A list of users with similar likes/dislikes loads there.

      - ## Nicotine+ Getting Around: Interests menus

        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+

        ### Recommendation menu

        When you click on "Global recommendation" or "Recommendation" button, you see a list in recommendation window (see item 4 of Interests)
        Right mouse-click for this window looks like:
        - I like this will put the item in "I like window"
        - I don't like this will put the item in "I dislike window"
        - Recommendation for this item will load a recommendation list for chosen item
        - Search for this item will start a search for that item in Search window (you have to click manually on "search" button)

        ### Similar users menu

        When you click on "Similar users" button, you see a list in similar user window
        Right mouse-click for this window looks like:
        - Send message will start a private chat with the chosen user
          - nicotine 1.2.1 and below users have to click on private chat manually
        - Show IP address will print the ip address and port the user is connected to Soulseek with into the log window
        - Get user info will load the user's queue status, as well as the user's text and pictures, if any was added by that user
        - Browse files will load the user's files in the User browse tab, allowing you to view that user's shares
        - Give privileges allowing you to give other users your Soulseek Privileges you received by sending a donation to www.slsknet.org
        - Add user to list will drop that user into buddy list, where you can give them privileged status, add comments or even ban them
        - Ban this user will block that user from downloading from you and from viewing your shares
        - Ignore this user will make that user disappear from chat rooms and private chat

    - ## Nicotine+ Getting Around: Buddy list

      The last window in Nicotine+ is Buddy list. Altrough it's the last window it's as important as every other window.
      Not mainly for Nicotine+ but for users like you. You can keep a list of friends, family or just people
      who just made you happy with that one rare file you were looking for ages.

      ### 1. List

      - When you add a user through any of various menus or commands, it gets listed in this window.

      ### 2. Add

      - Add field you can use to add users manually to your Buddy list
      - Type a name and hit Enter

      ### 3. Statistics & Comments

      - The first column is a Status icon signifying if the user is online, offline, or away.
      - User shows the user's nickname.
      - Speed shows their average speed in Bits per second.
      - Files shows the number of shared files.
      - Comments shows comments like real name, email-address, name of a file you want... it can be anything you want.

      ## Buddy list menus

      - Send message will start a private chat with the chosen user
        - Double-click on a user to switch to a private chat with that user.
      - Show IP address 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.
      - Get user info will load the user's queue details, as well as the user's text and pictures, if any were set by this user.
      - Browse files will load the user's files in the User browse tab, allowing you to view that user's shares.
      - Give privileges 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)
      - Add user to list will drop this user into buddy list, where you can give them privileged status, add comments or even ban them
      - Ban this user will block this user from downloading from you and from viewing your shares
      - Ignore this user will make this user disappear from chat rooms and private chat
      - Online notify 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.
      - Privileged allows this user to download without waiting
      - Trusted allows this user to upload files to you, if you only allow trusted buddies to send you files.
      - Edit comments allows you to add or modify comments
      - Remove removes this user from your Buddy list

25. ## Now Playing

    NowPlaying is a feature that works with players that provide metadata to the standard output (STDOUT).
    XMMS, Audacious, Amarok (1.x), MPD (via mpc), Rhythmbox, and Exaile are supported.
    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.

26. ## Customization

    - ## Icon Themes

      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.

      The files in the img/ subdirectory are stored in the imagedata.py file as data strings and loaded at runtime.

      ### Files

      - hilite.png
      - online.png
      - away.png
      - offline.png
      - hilite2.png
      - away2.png
      - connect.png
      - disconnect.png

      ## Status, Tray, Hilite Icons

      To update imagedata.py, edit the .png files and then, from the root nicotine+ source directory run:

          ./encode_bitmaps.py

      The images will be stored in the pynicotine/gtkgui/imagedata.py file.

    - ## Sound Themes

      Any directory with private.ogg and room_nick.ogg works as a sound theme directory.

    - ## How To Change GTK+ Theme

      There's a file named .gtkrc-2.0 in the home directory. You edit this file in a text editor, or use a theme selector. A nice stand-alone theme switcher is gtk-theme-switch2. Other theme selectors are provided by Gnome and XFCE's configuration tools. KDE also has a GTK theme configuration tool.

    - ## Understanding Soulseek Ports

      First, use daelstorm's Soulseek Port Test with the client connection port Nicotine+ is currently using (you'll find it under Settings-<Server).

      ### Who should read this document?

      - Just started using Nicotine+ and/or Soulseek network
      - Having connection problems
      - Can't browse majority of users
      - Majority of users cannot browse you
      - Down/Uploads almost always fail
      - Requesting User Shares or User Info usually fails

      ### Don't bother to reading this...

      - If you have no idea what a network, firewall, router, or port is and don't want to know.
      - If you have no control over your internet connection.

      ## What are Ports?

      Almost all software that sends and receives data over internet uses specific
      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.
      - Web browser
        - example: Internet Explorer, Mozilla Firefox
        - Use port 80 and port 8080 and others
      - FTP client
        - example: filezilla, gFTP, WS_FTP
        - Use port 21
      - email client
        - example: outlook, Thunderbird, SeaMonkey
        - Use port 110
      - Instant Messaging
        - example: MSN, GAIM, Gajim, ICQ
        - port: each of these have their own specific ports.

      ## Soulseek ports

      By default, Nicotine-Plus uses ports 2234 as a 'listen port'.
      Other Soulseek clients also use this port by default.
      If you have more than one client running, the next port, 2235, will be tried, and so on.
      If you wish, you can change the default port in Settings->Server.
      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.

      ## Local & Remote Misconfigured Firewall or Router

      problem: 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.
      solution: You need to fix your own system, whether it's your router or firewall.

      ## Remote Misconfigured Firewall or Router

      problem: 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.
      solution: 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)

      ## Local Misconfigured Firewall or Router

      problem: Not being able to upload to many other Soulseek users.
      solution: Either put Nicotine+'s listen port in the list of allowed ports, and/or forward the proper port(s) (I.E. 2234) from your router to your system running Nicotine+.

      ## Ideal Configuration

      On the left, your system (local), then internet, and at the right the other users system (remote).
      The best situation would be if both systems are configured properly,
      so a bidirectional communication is possible. As long as you both have accessible listen ports, and bandwidth everything should work.
      External links:
      - Port Forward Router guides