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

PPA (Ubuntu/Debian)

To use unstable packages on Ubuntu and Debian, add the nicotine-team/unstable PPA repository.

On Ubuntu and distributions based on it (e.g. Linux Mint, elementary OS, Pop!_OS, various Ubuntu flavors), run the following:

sudo add-apt-repository ppa:nicotine-team/unstable
sudo apt update; sudo apt install nicotine

On Debian and distributions based on it (e.g. Devuan, Peppermint OS), run the following:

sudo apt update; sudo apt install python3-launchpadlib software-properties-common
sudo add-apt-repository 'deb https://ppa.launchpadcontent.net/nicotine-team/unstable/ubuntu jammy main'
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.

• Download Unstable Flatpak Package — INFO

Snap

Unstable Snap packages are published in the Snap Store, and can be installed by running the following:

sudo snap install nicotine-plus --edge

Other

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

Windows

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

• Download Unstable Windows Installer — INFO
  for Windows 10 or later

Standalone executables are also available. They can be run from any folder and do not require installation.

• Download Unstable Windows Standalone Package — INFO
  for Windows 10 or later

NOTE: Configuration files are always stored in
C:\Users\<USERNAME>\AppData\Roaming\nicotine

macOS

Unstable installers are built after every commit to the master branch.

IMPORTANT: You must follow these instructions the first time you start Nicotine+.

• Download Unstable macOS Intel Installer — INFO
  for macOS 13 Ventura or later

• Download Unstable macOS Apple Silicon Installer — INFO
  for macOS 14 Sonoma or later

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