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.
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.
Unstable Flatpak packages are built after every commit to the master branch.
Unstable Snap packages are published in the Snap Store, and can be installed by running the following:
sudo snap install nicotine-plus --edge
See All Platforms for installing the unstable version of Nicotine+ on other distributions.
Unstable packages are built after every commit to the master branch.
Standalone executables are also available. They can be run from any folder and do not require installation or administrator privileges. Configuration files are stored in C:\Users\USERNAME\AppData\Roaming\nicotine.
Unstable installers are built after every commit to the master branch.
NOTE: You have to follow these instructions the first time you open Nicotine+ on macOS.
Download Unstable macOS Intel Installer [Info]
for macOS 12 Monterey or later
Download Unstable macOS Apple Silicon Installer [Info]
for macOS 14 Sonoma or later
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.
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
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