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
  4. Settings
  5. Getting Around
  6. Aliases
    • Now Playing (use the NowPlaying dialog for versions >= 1.2.6)
  7. Customization

  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

    Apple

    Mac users

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


    Windows

    Windows users

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


    Warning

    Warning

    This icon designates a warning relating to the surrounding text.


    Explanation

    Explanation

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


    Tip

    Tip

    This icon designates a tip relating to the surrounding text.


    Note

    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

      NoteOn 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

    • 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.net:2240
      • 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.
      WarningChoose 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.
      WindowsIf 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.
      TipIf 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.

      • NoteOne 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

      ExplanationWhen 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
      TipIf 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.
      ExplanationIf 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
      TipIf you have the same Incomplete and Download directory (the default setting), it's a good idea to keep this option checked.
    • 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 $
    • Settings: Geo Block

      NoteThis 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
    • Settings: Interface



      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
    • Settings: Colours



      Chat colours

      Which colours the various text messages will get displayed as in Chat Rooms and Private Chat

      NoteChat 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).
    • Settings: Icons

      Icon Theme Directory

      NoteThis 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.
    • By default, it's empty
    • 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⁰
    • Settings: Chat

    • 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
    • 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
    • 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.
      • You can Add and Remove individual words, or Clear to empty the list
    • 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.
    • 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.

      NoteURL 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"
      NoteYou 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
      Explanation"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.
    • Settings: Completion

      There are a multitude of options for configuring tab completion and the dropdown completion list.
    • 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)
    • 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).
    • Settings: Searches

      Network searches

      Sends out a maximum of xx results per search request
      • By default, it's 50
      ExplanationLet's say you have 2898 wu family related files. When some user searches for "wu" or "wu tang" only the first 50 are send out to user who searches.

      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.

      NoteYou can only add plain text. HTML and BB tags won't work.
      TipIf 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

      TipDon'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.
    • 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.

  5. 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? :)

        TipMost 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
        TipYou 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".
        AppleTo 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.

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

        WarningThere 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

        WarningThere 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 accessable 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

        TipYou 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 accessable
          • 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.
          TipSave 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

      • NoteSearch 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

      TipBefore 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
  6. 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.
  7. 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: