Table of Content

  1. Conventions Used in This Guide
  2. Installation
  3. Startup
    • 3.1 Linux
    • 3.2 Windows
    • 3.3 Apple
  4. Settings
  5. Getting Around

  1. Conventions Used in This Guide

    #~Command: commands, command output, and switches
    #~Mac: designates a Mac note relating to the surrounding text.
    #~Windows: designates a Windows note relating to the surrounding text.
    #~WARNING!: designates a warning relating to the surrounding text.
    #~Explanation: shows a situations for better understanding relating to the surrounding text.
    #~Tip: designates a tip relating to the surrounding text.
    #~Note: designates a note relating to the surrounding text.

  2. Installation

  3. Startup

  4. Settings

    • 4.1 Nicotine+ Settings: Before you connect

      These settings are needed to connect to Soulseek Network.
      The first time you run Nicotine+, the settings dialog will appear and you should enter the following:

      Under Connection » Server
      • A username.
      • A password.
      Under Connection » Shares:
      • The download directory.
      • One or more shared directories (or share your download directory).

      Now press OK.
      If all goes well, you will be connected to the Soulseek server and automatically join the nicotine chat room.
      Your shares will automatically be scanned.

      In Log window you can see:
      • Rescanning Started shows that scanning of your shared folders is started
      • Rescanning is finished shows when scanning is finished
      • Or, if you didn't configure your settings correctly, you'll get a short warning to remind you of what needs to be configured.

    • 4.2 Nicotine+ Settings: Connection

      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/dirs for share
      • Transfers allows you to configure upload settings

      • 4.2.1 Nicotine+ Settings: Server

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

        Server

        allows you to choose which server you want connect to
        • default is: server.slsknet.net:2240
        • unless you know what you doing, leave this option default!

        Login

        field to fill in your username
        • if it's the first time you're connecting to Soulseek Network, it can happen that your chosen username is already in use
        • Look in Log window to see if your username is in use. If it's in use you see: INVALID PASS
        • If it's not in use, well, you just connect and enjoy Nicotine+, Soulseek Network and the whole experience :)

        Password

        field for your password
        #~WARNING!: Choose proper password. You can't recover password the easy way!

        Network Character Encoding

        Allows you to choose what your default language encoding is. UTF-8 works well, except that many other users do not use it. The Windows client is still using ISO8859-X type encodings.
        • The default is UTF-8
        • Unless you're using a non-Latin language, there's no need to change this.

        Client connection ports

        ports needed by Nicotine+ to function well.
        • default is 2234 - 2239
        • Excellent guide on Soulseek Ports by daelstorm
        • If ports are open and can receive direct connection, check that box

        CTCP VERSION

        users are allowed to check which version of Nicotine+ you have.
        • default is checked
        • If other users have this option checked, you can check their version.
        • You can do this in Private chat session via the popup menu, or /ctcpversion

      • 4.2.2 Nicotine+ Settings: Shares

        Shares allows you to configure your Download and Shared files directories

        Incomplete directory

        Choose where the incoming files should be stored
        • After a file is finished downloading, it is then moved to by your chosen Download directory (see below)

        Download directory

        Choose where the finished files should be stored
        • Share download directory allows you to share your download directory
        #~ Windows: 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)
        • Rescan shares on startup allows you to scan your shares everytime you start Nicotine+
        • If you move your files all the time, check it
        #~ Tip: While moving files and leaving this option unchecked, you may get loads
        of messages from users asking where the file went? 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.

        Buddy-only shares

        Enable this option if you have files which people from your Buddy list only are allowed to download

      • 4.2.3 Nicotine+ Settings: Transfers

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

        Upload queue

        If Uploads are sends at xx KBytes/sec then other uploads will be queued.
        • default is 10

        Limit number upload

        This option allows you to choose how many files are uploaded at the same time
        • default is unchecked (recommended)

        #~Note: 1 user CANNOT download 2 files at the same time. When you limit uploads to 2 What happens is: Each of the 2 users can download one file, so a total of 2 files are uploaded at the same time. When 3 users are attempting to download, only 2 users can download while the third user has to wait in the queue.

        Limit upload speed

        allows you to choose at which speed file(s) gets uploaded
        • default is unchecked

        #~Note: Unless you have some 10Mbit upload connection, there's no need for touching this option. Default option works fine.
        The case is that internet upload speeds are always cut down 2/3, if not even more.

        Maximum queue

        allows you to set a maximum queue in Megabytes.
        • default is 100 Megabytes (equals one album)

        #~Explanation: when a user downloads 2 albums, 1 album shows up in your upload list while the other doesn't.
        The user gets to see the following message: Remote: User limit of xx megabytes exceeded
        When a user clicks on a single movie file (700MB) and one album, you see both of file(s) in your upload queue.

        Share friends only

        enables only people who're in Buddy list to download your shares.
        • default is unchecked

        #~Tip: If you're going to use this option, make sure you put this in your User info.

        Privilege all my friends

        allows all users in Buddy list to download before everyone else.
        #~Note: Limit number uploads counts for this too.
        #~Explanation: If some users are downloading, and one Buddy starts downloading, he/she gets to download first.
        If you have limit uploads to 3 files, 3 users/buddies can download, while the 4th buddy has to wait.

        Lock incoming files

        allows you to lock incomplete files, so these cannot be downloaded
        • default is checked
        #~Tip: If you have the same Incomplete and Download directory, it's a good idea to keep this option checked.

        Allow Buddies to send files

        allows users in your Buddy list to send you files
        • default is checked

      • 4.2.4 Nicotine+ Settings: Geo Block

        #~ Note: This option is NOT available for Nicotine+ Windows version. PyGeoIP is required for this feature to become available. Geo Block allows you to block all users from a country whose IP addresses are in the GeoIP database.

        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 to block the U.S.A, Netherlands, Poland, Sweden and German

    • 4.3 Nicotine+ Settings: User interface

      User Interface settings has 2 items. Each can be used to configure settings which suit you the best.

      Interface allows you to configure text color, font, sound effects and other related settings.
      URL Catching allows you to choose which application(s) should start after you click a link.

      • 4.3.1 Nicotine+ Settings: Interface

        Interface settings allows you to change the appearance of Nicotine-Plus.

        Icon Theme Directory

        #~Note: This feature is available from Nicotine+ 1.2.4 and up.
        Select a directory with images and Nicotine+ will attempt to use it for online/offline/away/hilite notification icons.
        • The default setting is empty, which means the built-in icons are used.

        Close button on tabs

        If you want to have close buttons on tabs

        • default is checked

        Chat colors

        The colors chat and status messages get displayed as in Chat rooms or Private chats

        #~Note: Chat color settings only effect you, other users won't see it differently.
        • Remote text is the messages you get to see, when something is wrong with files you're downloading
        • default is empty
          • It shows up like Remote: [message]
            • Remote: User limit of xx megabytes exceeded
            • Remote: File error
        • Local text are your messages, you see them in Chat room and Private chat sessions
        • default is BLUE
        • /me text is used to state what you're doing instead of talking
        • default is FORREST GREEN
          • "/me is going to eat something" shows up as "[time][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 is a message that includes your username
        • default is red
          • this occurs when somebody is talking to you only, in a busy chatroom

        Search colors

        To make searching and downloading files easier, you can choose the colors of your search results.
        • Immediate downloads show up as black or the default color of your theme.
        • default is empty
        • Downloads with a queue show up as grey
        • default is GREY

      • 4.3.2 Nicotine+ Settings: URL Catching

        When some user enters an URL in a Chat room or Private chat, Nicotine+ is able to open a browser and go to the given webpage.
        This window allows you to choose which browser you want to use.

        #~Note: URL Catching only works in Chat room and Private chat, not in User info. Instead you can copy the URL given in User info by using CTRL + C and paste it in your favorite browser by using CTRL + V

        Enable URL catching

        • default is checked

        Humanize slsk: // urls

        • default is checked

        Protocols handlers

        allows you to choose which handler suppose to handle which protocol
        • default protocol is http
        • default handler is firefox "%s" &
        • The characters "%s" is the URL, %s, enclosed in quotes to protect non-alphanumeric characters from causing trouble during execution of the handler command.
        #~Note: You can NEVER have twice the same protocol because of obvious reasons.

        Add new protocols & handler

        • fill in field protocol your desired protocol
        • fill in field handler your desired application
        • click update

        Remove protocol & handler

        • click on specific action, for example http mozilla "%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 other protocols, such as "https".

        List of protocols & handlers

        #~Note: This list isn't complete, it's just to give you an example of how you can add your own protocol & handler

        http protocols

      • firefox "%s" &

      • ftp protocols

        • kasablanca "%s" &
        • firefox "%s" &

    • 4.4 Nicotine+ Settings: Miscellaneous

      • Away mode allows you to configure your auto-way settings
      • User info allows you to add text and an image to your personal info
      • Ban/ignore let's you manage your ban and ignore list
      • Logging allows you to configure what's logged and where to save the logs
      • Searches allows you to configure search settings and default filters
      • Events allows what commands, apps are executed/launched after a download is finished

      • 4.4.1 Nicotine+ Settings: Away mode

        Toggle away

        If you're gone behind your PC after xx minutes then your status changes in "away".
        This means the slsk-bird infront of your name closes it's wings.
        • default is 15 minutes

        Auto reply

        While you're away you can configure a message that users get to see when they start a Private chat with you
        • default is empty

      • 4.4.2 Nicotine+ 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.

        #~Note: You can only add text. HTML tags won't work, instead you see the syntax.
        #~Tip: 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

        #~Tip: 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.

      • 4.4.3 Nicotine+ 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 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 list (you appear back in Chat room and Private chat)
        • Clear removes all users in ignore list

        use custom ban message

        Allows you to send a message

      • 4.4.4 Nicotine+ 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

        • default is unchecked (disabled)

        Log chatrooms by default

        • default is unchecked (disabled)

        Log transfers

        Keeps logs of you down/uploads
        • default is unchecked (disabled)

        Logs directory

        Where logs are saved.
        • default is /root

        How to change Logs directory

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

      • 4.4.5 Nicotine+ Settings: Searches

        Network searches

        Sends out a maximum of xx results per search request
        • default is 50
        #~Explanation: Let'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

      • 4.4.6 Nicotine+ Settings: Events

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

        Run Command

        • after download finishes allows you to run a command or application after download of 1 file is finished
        • after folder finishes allows you to run a command or application after download of 1 folder is finished
          • example: a folder is useally one complete album

  5. Getting Around

    • 5.1 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 sad 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

      • 5.1.1 Nicotine+ Getting Around: Basics, Menu's

        Nicotine has menu's other than menu's which can be viewed with right-mouse-click. The menu's 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? :)

        #~Tip: 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

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

      • 5.1.3 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
        #~Tip: You can turn on/off debug info by going to "File --> Show debug info "
        #~Tip: You can hide Log window by using Hotkey "Alt + H" or going to "File --> Hide log window"

    • 5.2 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".
        #~Apple: 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.

      • 5.2.1 Nicotine+ Getting Around: Chatroom Roomlist Menu's

        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.

        #~Apple: 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.

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

        #~WARNING! There are endless possibilities and combinations of commands and scripts you can add, 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.

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

      • 5.3.1 Nicotine+ Getting Around: Private chat Menu's

        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

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

        #~WARNING! There are endless possibilities and combinations of commands and scripts you can add, 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.

    • 5.4 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 :)

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

        #~Note: The only difference between Download and Upload menu is that ''Get place in queue'' is not a part of Upload menu.
        #~Tip: You can access most items by Letter Commands. (see next section)

      • 5.4.2 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)

    • 5.5 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.
          #~Tip: 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

    • #~Note: 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)

    • 5.5.1 Nicotine+ Getting Around: Search files menu's

      • 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

  6. 5.6 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 menu's, 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.

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

    #~Tip: 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.

    • 5.7.1 Nicotine+ Getting Around: User browse menu's

      User browse has 2 menu's, one for directory window and one for files window.

      #~Note: The difference between the 2 menu's is that the first 4 options of the menu are
      not available in files window since it only can be done with directory instead of files.

      File window has at the top 2 options: "Download files" and "Download files to"

      • Download directory adds the selected directory to your download queue.
      • Download directory to allows you to choose where to save the directory
      • Download recursive
      • Download recursive to
      • 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.

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

    • 5.8.1 Nicotine+ Getting Around: Interests menu's

      Interests window has several menu's. 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

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

    • 5.9.1 Nicotine+ Getting Around: Buddy list menu's

      • 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
      • Online notify notifies you when user is online, you see the notify in Log window or status bar
      • Privileged allows user to download without waiting
      • Edit comments allows you to add or modify comments
      • Remove removes user from Buddy list