# Install nicotine-plus with Homebrew, apk, MacPorts, Nix, scoop, apt, dnf, pacman, winget

Graphical client for the Soulseek peer-to-peer network. Version 3.3.10 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:nicotine-plus
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install nicotine-plus
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install nicotine-plus
```

  Evidence: MacPorts ports tree: www/nicotine-plus/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add nicotine-plus
```

  Evidence: Alpine Linux edge package indexes: nicotine-plus from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#nicotine-plus
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ni/nicotine-plus/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- Debian apt (92%):

```sh
sudo apt install nicotine
```

  Evidence: Debian stable package indexes: nicotine from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install nicotine+
```

  Evidence: Fedora Rawhide package metadata: nicotine+ from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- pacman (92%):

```sh
sudo pacman -S nicotine+
```

  Evidence: Arch Linux sync databases: nicotine+ from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

### Windows

- Scoop (92%):

```sh
scoop install extras/nicotine-plus
```

  Evidence: Scoop official bucket manifest trees: bucket/nicotine-plus.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id Nicotine+.Nicotine+ -e
```

  Evidence: Windows Package Manager source index: Nicotine+.Nicotine+ from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:nicotine-plus
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/nicotine-plus>
- **Version:** 3.3.10
- **Source summary:** Graphical client for the Soulseek peer-to-peer network
- **Homepage:** <https://nicotine-plus.org>
- **Repository:** <https://github.com/nicotine-plus/nicotine-plus>
- **Upstream docs:** <https://nicotine-plus.org/doc/DEVELOPING.html>
- **License:** GPL-3.0-or-later
- **Source archive:** <https://files.pythonhosted.org/packages/bb/91/b7d2f353828d1bc57bb43cfe9006b0fde4d6ffe1458d5045c58f567ed33a/nicotine_plus-3.3.10.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- nicotine (cli)
- nicotine (alias)

## Dependencies

- adwaita-icon-theme
- gtk4
- libadwaita
- py3cairo
- pygobject3
- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 3.3.10
- Local data: ok
- Upstream repository: https://nicotine-plus.org
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Nicotine+ is a graphical GTK client for the Soulseek peer-to-peer network. The project presents itself as a free, open source, Python-based client for sharing files, chatting, and interoperating with other Soulseek clients.

### Project history

The project lineage reaches back to PySoulSeek and Nicotine: the official development notes say Nicotine+ was originally based on backend code from PySoulSeek, which started in 2001, and that Nicotine chose GTK after PySoulSeek had used wxPython. The Nicotine+ homepage credits Nicotine+, Nicotine, and PySoulSeek contributors across 2001-2026, and also preserves the former Nicotine maintainer's 2003 explanation of the name.

Nicotine+ has stayed alive largely by being conservative about portability and dependencies. Its development guide says the client aims to run on almost any system, prefers standard-library functionality where possible, and maintains an unofficial Soulseek protocol document because the Soulseek protocol is proprietary and undocumented by the official service.

### Adoption history

Adoption is strongest in the package-manager sense rather than the commercial ecosystem sense. The official downloads page lists packages for Alpine, Arch, Debian, Fedora, FreeBSD, Gentoo, Guix, Haiku, NixOS, OpenBSD, Void, Flatpak, Snap, Chocolatey, Scoop, Winget, Homebrew, and others. GitHub showed roughly 3,000 stars and 183 forks when researched on July 1, 2026.

Homebrew's formula API reported 1,363 installs over 365 days, 322 over 90 days, and 113 over 30 days when queried on July 1, 2026. That makes it a modest but real desktop-app formula, especially for a P2P client with official macOS installers outside Homebrew.

### How it is used

Users install Nicotine+ when they want a native open-source Soulseek client instead of the official SoulseekQt client. Practical usage is GUI-driven: search the Soulseek network, browse users, manage shares and downloads, chat, and tune connection/transfer behavior.

Package nerd usage is mostly about distribution fit: Nicotine+ is a Python/GTK desktop app with many downstream packages, release assets for Windows and macOS, Flatpak/Snap builds, PyPI fallback installation, and distro-sensitive dependency choices.

### Why package nerds care

Nicotine+ is notable because it is one of the long-lived open-source clients for a proprietary P2P protocol. Its packaging footprint is broad, and the project explicitly designs for packagers and older platforms instead of treating source builds as an afterthought.

### Timeline

- 2001: PySoulSeek project lineage begins, according to Nicotine+ development documentation.
- 2003: Former Nicotine maintainer Hyriand gives the naming story preserved on the official homepage.
- March 10, 2025: Nicotine+ 3.3.10 is listed on the official homepage as the stable release.
- June 2026: The homepage points testers to the second 3.3.11 release candidate.

### Related projects

- Soulseek, PySoulSeek, Nicotine, SoulseekQt, GTK, Flatpak, Snap, PyPI

### Sources

- <https://formulae.brew.sh/api/formula/nicotine-plus.json>
- <https://github.com/nicotine-plus/nicotine-plus>
- <https://nicotine-plus.org/>
- <https://nicotine-plus.org/doc/DEVELOPING.html>
- <https://nicotine-plus.org/doc/DOWNLOADS.html>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Windows: C:\Users\<USERNAME>\AppData\Roaming\nicotine
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** nicotine-plus
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Conflicts With:** httm
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - nicotine-plus: normalized package name match | nixpkgs package indexes: pkgs/by-name/ni/nicotine-plus/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - nicotine-plus - 3.3.10-r1: normalized package name match | Alpine Linux edge package indexes: nicotine-plus from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Graphical client for the SoulSeek peer-to-peer system | https://nicotine-plus.github.io/nicotine-plus
- apk - nicotine-plus-doc - 3.3.10-r1: normalized package name match | Alpine Linux edge package indexes: nicotine-plus-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Graphical client for the SoulSeek peer-to-peer system (documentation) | https://nicotine-plus.github.io/nicotine-plus
- apk - nicotine-plus-lang - 3.3.10-r1: normalized package name match | Alpine Linux edge package indexes: nicotine-plus-lang from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Languages for package nicotine-plus | https://nicotine-plus.github.io/nicotine-plus
- apk - nicotine-plus-pyc - 3.3.10-r1: normalized package name match | Alpine Linux edge package indexes: nicotine-plus-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for nicotine-plus | https://nicotine-plus.github.io/nicotine-plus
- MacPorts - nicotine-plus: normalized package name match | MacPorts ports tree: www/nicotine-plus/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - extras/nicotine-plus: normalized package name match | Scoop official bucket manifest trees: bucket/nicotine-plus.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1
- Debian apt - nicotine - 3.3.10-1: installed executable or alias match | Debian stable package indexes: nicotine from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | graphical client for the Soulseek peer-to-peer network | https://nicotine-plus.org/
- Ubuntu apt - nicotine - 3.2.9-2: installed executable or alias match | Ubuntu 24.04 LTS package indexes: nicotine from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | graphical client for the Soulseek peer-to-peer network | https://nicotine-plus.org/
- dnf - nicotine+ - 3.3.10-7.fc45: installed executable or alias match | Fedora Rawhide package metadata: nicotine+ from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A graphical client for Soulseek | https://nicotine-plus.github.io/nicotine-plus/
- pacman - nicotine+ - 3.3.10-2: installed executable or alias match | Arch Linux sync databases: nicotine+ from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Soulseek music-sharing client, written in python | https://github.com/Nicotine-Plus/nicotine-plus
- winget - Nicotine+.Nicotine+: installed executable or alias match | Windows Package Manager source index: Nicotine+.Nicotine+ from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [gtk4](https://www.automicvault.com/pkg/brew/gtk4/) - Runtime dependency declared by Homebrew.
- [libadwaita](https://www.automicvault.com/pkg/brew/libadwaita/) - Runtime dependency declared by Homebrew.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [gtk-gnutella](https://www.automicvault.com/pkg/brew/gtk-gnutella/) - Shares av.db curated category or tags: cli, file-sharing, gtk, networking, peer-to-peer.
- [dumbpipe](https://www.automicvault.com/pkg/brew/dumbpipe/) - Shares av.db curated category or tags: cli, networking, peer-to-peer.
- [ncdc](https://www.automicvault.com/pkg/brew/ncdc/) - Shares av.db curated category or tags: cli, file-sharing, networking.
- [rqbit](https://www.automicvault.com/pkg/brew/rqbit/) - Shares av.db curated category or tags: cli, file-sharing, networking.
- [samba](https://www.automicvault.com/pkg/brew/samba/) - Shares av.db curated category or tags: cli, file-sharing, networking.
- [sendme](https://www.automicvault.com/pkg/brew/sendme/) - Shares av.db curated category or tags: cli, networking, peer-to-peer.
- [superseedr](https://www.automicvault.com/pkg/brew/superseedr/) - Shares av.db curated category or tags: cli, file-sharing, networking.
- [wush](https://www.automicvault.com/pkg/brew/wush/) - Shares av.db curated category or tags: cli, networking, peer-to-peer.
- [copyparty](https://www.automicvault.com/pkg/brew/copyparty/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, file, file-sharing, networking, python.
- [airshare](https://www.automicvault.com/pkg/brew/airshare/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, file, network, networking, python.

## Combined YAML source

View the package source record on GitHub. [combined/nicotine-plus.yml](https://github.com/automic-vault/db/blob/main/combined/nicotine-plus.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
