1# Download Nicotine+ 2 3Download stable builds of Nicotine+ for your operating system. 4 5## GNU/Linux, *BSD, Solaris 6 7If you have no need to modify the Nicotine+ source, you are strongly recommended to use packages for your distribution/operating system. This will save you time. 8 9### Ubuntu/Debian 10 11To use [stable packages](https://launchpad.net/~nicotine-team/+archive/ubuntu/stable) on Ubuntu and Debian, add the stable Nicotine+ apt repository (PPA) by running the following: 12 13```sh 14sudo apt install software-properties-common 15sudo add-apt-repository ppa:nicotine-team/stable 16sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6CEB6050A30E5769 17sudo apt update 18sudo apt install nicotine 19``` 20 21If you prefer to install a .deb package directly, you can download one [here](http://ppa.launchpad.net/nicotine-team/stable/ubuntu/pool/main/n/nicotine/). Unlike the repository installation method, Nicotine+ will not update automatically; you need to download a .deb package each time a new release is available. 22 23### Fedora 24 25To install Nicotine+ on Fedora, run the following: 26 27```sh 28sudo dnf install nicotine+ 29``` 30 31### Flatpak 32 33If your distribution supports Flatpak, you can install Nicotine+ from Flathub. 34 35- [Download Nicotine+ on Flathub](https://flathub.org/apps/details/org.nicotine_plus.Nicotine) 36 37### Arch Linux/Manjaro/Parabola 38 39Nicotine+ is available in the community repository of Arch Linux, Manjaro and Parabola. To install, run the following: 40 41```sh 42sudo pacman -S nicotine+ 43``` 44 45### Void Linux 46 47To install Nicotine+ on Void Linux, run the following: 48 49```sh 50sudo xbps-install -S nicotine+ 51``` 52 53### FreeBSD 54 55To install Nicotine+ on FreeBSD, run the following: 56 57```sh 58pkg install py-nicotine-plus 59``` 60 61### pip 62 63If Nicotine+ is not available for your system, it can be installed using [pip](https://pip.pypa.io/en/stable/). Ensure the [runtime dependencies](DEPENDENCIES.md) are installed, and run the following: 64 65```sh 66pip3 install nicotine-plus 67``` 68 69Keep in mind that Nicotine+ will not auto-update. When a new release is available, run the following: 70 71```sh 72pip3 install --upgrade nicotine-plus 73``` 74 75## Windows 76 77### Official Builds 78 79Stable Windows installers for Nicotine+ are available for download. Installing Nicotine+ requires administrator privileges. 80 81NOTE: The installer format has changed in Nicotine+ 3.2.0. If you are upgrading from Nicotine+ 3.1.1 or earlier, please uninstall Nicotine+ first (this will not remove your existing settings). 82 83- [64-bit Installer](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-x86_64-installer.zip) [[SHA256](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-x86_64-installer.zip.sha256)] 84- [32-bit Installer](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-i686-installer.zip) [[SHA256](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-i686-installer.zip.sha256)] 85 86Portable packages are also available. They can be run from your home directory, and do not require installation or administrator privileges. 87 88- [64-bit Portable Package](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-x86_64-package.zip) [[SHA256](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-x86_64-package.zip.sha256)] 89- [32-bit Portable Package](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-i686-package.zip) [[SHA256](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-i686-package.zip.sha256)] 90 91### Chocolatey 92 93Nicotine+ can be installed using [Chocolatey](https://community.chocolatey.org/packages/nicotine-plus). Run the following: 94 95```sh 96choco install nicotine-plus 97``` 98 99## macOS 100 101### Official Builds (Catalina/10.15 and newer) 102 103A stable macOS installer for Nicotine+ is available on macOS version 10.15 (Catalina) and newer. 104 105- [Download Installer](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/macos-installer.zip) [[SHA256](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/macos-installer.zip.sha256)] 106 107### Homebrew (Mojave/10.14 and newer) 108 109NOTE: If your Mac has an Apple M1 chip, please use the [official installer](#official-builds-catalina1015-and-newer) instead. Nicotine+ installed from Homebrew will currently not work on these devices due to issues in upstream dependencies. 110 111On macOS version 10.14 (Mojave), the recommended approach is to install Nicotine+ using [Homebrew](https://brew.sh). 112 113Once Homebrew is set up, run the following: 114 115```sh 116brew install nicotine-plus 117``` 118