nicotine man page

Nicotine+ is a graphical client for the SoulSeek peer-to-peer network.


nicotine [options]


Nicotine+ is a GTK-based client for the SoulSeek peer-to-peer network written in Python.


-c <file>, --config=<file>

Use <file> as configuration file. If <file> does not exists a new empty configuration file will be created.

-t, --enable-trayicon

Enable the tray icon.

-d, --disable-trayicon

Disable the tray icon.

-h, --help

Show help and exit.

-s, --hidden

Start the program hidden so only the tray icon is shown.

-b <ip>, --bindip=<ip>

Bind sockets to the given <ip> (useful for VPN).

-v, --version

Show version number and exit.

Exit Status

Normally the exit status of the program will be 0.
If required dependencies are not present it returns 1.
If the given list of arguments cannot be parsed it returns 2.


All personal files are stored in the folder ~/.nicotine/


This manual page was initially written by Adam Cecile <> for the Nicotine+ project.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or any later version published by the Free Software Foundation.


February 2017 Version 1.4.1