Nicotine+

Testing

For those who like living on the bleeding edge, you can run the latest unstable build of Nicotine+ to test recent changes and bug fixes.

For information about Nicotine+ development procedures for maintainers, developers and code contributors, see DEVELOPING.md.

If you want to download the current stable version of Nicotine+, see DOWNLOADS.md.

GNU/Linux

Ubuntu/Debian

Daily unstable snapshots are built in a separate unstable PPA repository. To install the latest unstable build of Nicotine+, run the following:

sudo apt install software-properties-common
sudo add-apt-repository ppa:nicotine-team/unstable
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6CEB6050A30E5769
sudo apt update
sudo apt install nicotine

If you prefer to install a .deb package directly, you can download one here.

Unlike the repository installation method, you need to download and install Nicotine+ from the link above every time you want to update to the latest unstable build.

Flatpak

Unstable Flatpak packages are built after every commit to the master branch.

Other

See All Platforms for installing the unstable version of Nicotine+ on other distributions.

Windows

Unstable Windows packages are built after every commit to the master branch.

Portable packages are also available. They can be run from any folder and do not require installation or administrator privileges.

macOS

Unstable installers for macOS Catalina 10.15 and newer are built after every commit to the master branch.

All Platforms

The following installation methods work out of the box on GNU/Linux, *BSD and Solaris. On Windows, a MinGW development environment is required. On macOS, Homebrew is required. Consider using the Windows and macOS packages above if you do not need to modify the source code.

pip

The latest unstable build of Nicotine+ can be installed using pip. Ensure the runtime dependencies are installed, and run the following:

pip3 install git+https://github.com/nicotine-plus/nicotine-plus.git

To start Nicotine+:

nicotine

To update to the latest unstable build of Nicotine+, run the following:

pip3 install --upgrade git+https://github.com/nicotine-plus/nicotine-plus.git

To uninstall Nicotine+, run:

pip3 uninstall nicotine-plus

Git

To run Nicotine+ directly from a local Git folder, ensure the runtime dependencies are installed, and run the following:

git clone https://github.com/nicotine-plus/nicotine-plus.git
cd nicotine-plus
./nicotine

To update to the latest unstable build of Nicotine+, run the following:

cd nicotine-plus
git pull