Download Nicotine+

Download the current stable version of Nicotine+ for your operating system

The current stable version is Nicotine+ 3.3.10, released on March 10, 2025. See the release notes for details.

For the latest unstable builds and testing instructions, see the testing documentation.

Windows

Official Release

Stable installers and standalone packages are available for Windows 10 or later.

Windows Installer

Recommended for most users

• Download Windows Installer (SHA256)
• For Windows 10 or later
• Includes automatic updates

Standalone Package

No installation required

• Download Windows Standalone (SHA256)
• Run from any folder
• For Windows 10 or later

Upgrading from Nicotine+ 3.1.1 or earlier? The installer format changed in version 3.2.0. Please uninstall the old version first (this will not remove your existing settings).

Configuration files are stored in C:\Users\<USERNAME>\AppData\Roaming\nicotine for both installer and standalone versions.

Package Managers

Alternatively, install using your preferred Windows package manager:

Package Manager	Installation Command
Chocolatey	choco install nicotine-plus
Scoop	scoop install extras/nicotine-plus
Winget	winget install nicotine+.nicotine+

macOS

Official Release

First-time users: You must follow these instructions the first time you start Nicotine+.

macOS Intel

For Intel-based Macs

• Download macOS Intel Installer (SHA256)
• For macOS 13 Ventura or later

macOS Apple Silicon

For M1/M2/M3 Macs

• Download macOS Apple Silicon Installer (SHA256)
• For macOS 14 Sonoma or later

Package Managers

Package Manager	Installation Command
Homebrew	brew install nicotine-plus
PowerPC Ports	For legacy PowerPC Macs

GNU/Linux, BSD, Haiku, Solaris

Operating System Packages

If you are using any of the operating systems listed below, install Nicotine+ using your package manager:

Arch Linux

sudo pacman -S nicotine+

Package: nicotine+

Debian/Ubuntu

sudo apt install nicotine

Package: nicotine (Debian Unstable/Testing)

For stable Debian/Ubuntu releases, see the PPA instructions below.

Fedora

sudo dnf install nicotine+

Package: nicotine+

Gentoo

sudo emerge net-p2p/nicotine+

Package: net-p2p/nicotine+

openSUSE

Available in various openSUSE repositories

Complete Distribution List

Operating System	Package Name
Alpine Linux Edge	nicotine-plus
Arch Linux	nicotine+
Chimera Linux	nicotine-plus
Debian Unstable/Testing	nicotine
Fedora	nicotine+
FreeBSD Ports	net-p2p/py-nicotine-plus
Gentoo	net-p2p/nicotine+
GNU Guix	nicotine+
Haiku Ports	nicotineplus
Mageia	nicotine+
Manjaro	nicotine+
NixOS	nicotine-plus
OpenBSD Ports	net/nicotine-plus
OpenMandriva	nicotine+
Parabola	nicotine+
PLD Linux	nicotine
Solus	nicotine-plus
T2 SDE	nicotine-plus
Void Linux	nicotine+

Universal Packages (GNU/Linux)

These packages work across different GNU/Linux distributions:

Flatpak

flatpak install flathub org.nicotine_plus.Nicotine

Available on Flathub

Snap

sudo snap install nicotine-plus

Available on Snapcraft

PPA (Ubuntu/Debian)

For stable packages on Ubuntu and Debian-based distributions:

Ubuntu

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

Works on Ubuntu and distributions based on it (Linux Mint, elementary OS, Pop!_OS, Ubuntu flavors).

Debian

sudo apt update
sudo apt install python3-launchpadlib software-properties-common
sudo add-apt-repository 'deb https://ppa.launchpadcontent.net/nicotine-team/stable/ubuntu jammy main'
sudo apt update
sudo apt install nicotine

Works on Debian and distributions based on it (Devuan, Peppermint OS).

Manual .deb

If you prefer to install a .deb package manually:

1. Download the .deb package
2. Install with sudo dpkg -i nicotine_*.deb

When installing manually, Nicotine+ will not update automatically. Download and install the latest version after every update.

PyPI (Universal)

If no package is available for your operating system, install from PyPI:

1. Install runtime dependencies

   Ensure the runtime dependencies are installed for your system.

   For example, on Debian/Ubuntu:

   sudo apt install gir1.2-gtk-4.0 gir1.2-adw-1 python3-gi python3-gi-cairo
   
2. Install Nicotine+ from PyPI

   pip3 install nicotine-plus
   
3. Update when needed

   Nicotine+ will not update automatically. When a new release is available:

   pip3 install --upgrade nicotine-plus
   

System Requirements

Required Dependencies

• Python 3.9 or newer - Runtime language
• GTK 4.6.9+ or GTK 3.24.24+ - Graphical interface
• PyGObject - Python bindings for GTK

Recommended Dependencies

• libadwaita - For Adwaita theme on GNOME (GTK 4)
• gspell - For spell checking in chat (GTK 3)

Windows and macOS installers include all required dependencies - no additional setup needed!

Next Steps

Quick Start

Get started with Nicotine+ in minutes

Configuration

Customize your installation