Nicotine+ Review: A GTK Soulseek Client Written in Python

What Nicotine+ Is and Who It Is For

Nicotine+ is a graphical client for the Soulseek peer-to-peer network. The README describes it as a way to share files, chat, and find people with similar interests, and says it aims to be user-friendly while remaining fully compatible with other Soulseek clients. That compatibility claim matters: Soulseek is a network with more than one client implementation, and a client that diverges from the protocol would be cut off from the peers it needs.

The target user is someone who wants a desktop application rather than a command-line tool. The interface is built with GTK, and the project topics list both gtk3 and gtk4, so the toolkit choice is part of the project's identity rather than an implementation detail. The code is Python, which makes the client approachable for contributors who already know the language, and it also means the runtime depends on a Python environment plus the GTK stack.

The README's feature description is deliberately short. It does not enumerate search filters, transfer queues, or chat rooms in any detail, so anyone evaluating the client for a specific workflow should look at the screenshots directory and the release notes rather than the front page. What the README does state clearly is the legal position: the Nicotine+ Team collects no data used or stored by the client, but different policies apply to data sent to the default Soulseek server, which the team does not operate.

How the Client Talks to Soulseek

The repository layout shows the split between the launcher and the application code. A top-level entry named nicotine sits alongside a pynicotine package directory. The launcher is the entry point a user invokes, and pynicotine holds the modules that implement the client. This is a conventional Python application shape, and it means the client can be packaged by distributions without patching the application logic.

The build configuration in pyproject.toml declares setuptools as the build backend and targets Python 3.10 through the pylint py-version setting. The setup.py file handles translation building: it reads the po/LINGUAS file for the list of languages, then for each language runs msgfmt to compile the .po catalog into a .mo file under pynicotine/locale, and it also merges translations into the .desktop and metainfo files under data. That is a build-time step, not a runtime one, and it explains why the packaging documentation is a separate document in the repository.

What the README does not describe is the wire protocol itself. There is no architecture diagram, no description of how search results are routed, and no explanation of how transfers are scheduled. The protocol is Soulseek's, and the README points readers to the Soulseek site for the network's rules and terms rather than restating them. If you need to understand the protocol, the client source is the place to read it, not the README.

Installing Nicotine+ and Connecting for the First Time

The README does not give a single install command. Instead it points to doc/DOWNLOADS.md, which has separate sections for GNU/Linux, BSD, Haiku and illumos, for Windows, and for macOS. Start there and pick the section for your platform, because the packaging differs by operating system and the README treats that document as the source of truth.

On a distribution that packages the client, the install is a normal package manager operation. The exact package name depends on the distribution, so check your distribution's package index rather than copying a name from here:

# Debian and Ubuntu family
sudo apt install nicotine

If your distribution does not package it, the downloads document lists the alternatives for your platform. The stable version named in the README is 3.3.11, released on September 16, 2026, and the release notes live in NEWS.md.

After installing, launch the client from your desktop menu or from a terminal. The README does not document a command-line flag set, so the launcher name is the thing to run. On first start the client will need a Soulseek account and a connection to the default Soulseek server. The README states that connecting to that server means agreeing to abide by the Soulseek rules and terms of service, and it links both documents. Read them before you share anything, because they are the network's terms, not the client's.

Once connected, the three activities the README names are sharing files, chatting, and finding people with similar interests. The client is graphical, so these are menu and panel operations rather than commands, and the screenshots document in data/screenshots/SCREENSHOTS.md is the fastest way to see what each view looks like before you install.

The Unencrypted Protocol Is the Main Limitation

The README is unusually direct about this: Soulseek is an unencrypted protocol not intended for secure communication. That single sentence rules out a set of use cases. Do not send credentials, private documents, or anything you would not want observed on the wire. The client does not add a security layer on top of the protocol, and the README does not claim it does.

The privacy statement is narrower than it first appears. The Nicotine+ Team does not collect data used or stored by the client, but the README explicitly notes that different policies may apply for data sent to the default Soulseek server, which the team does not operate. So the no-collection promise covers the client, not the network. Anyone reading that paragraph as a blanket privacy guarantee is reading it wrong.

There is a second limitation that is easy to miss: the client is a desktop GTK application. The related searches include people looking for an Android client, and nothing in the README or the repository layout describes a mobile build. The downloads document covers GNU/Linux, BSD, Haiku, illumos, Windows, and macOS. If you need Soulseek on a phone, this project as documented is not the answer.

Nicotine+ Compared with the Official Soulseek Client

The obvious alternative is the official Soulseek client, and the difference is not in the network but in the implementation. Both connect to the same servers and speak the same protocol, which is why the README can claim full compatibility with other Soulseek clients. The choice is about the client, not about which network you reach.

Nicotine+ is Python and GTK, and the repository shows a conventional Python packaging story: pyproject.toml with setuptools, a setup.py that compiles translations with msgfmt, a po directory for translators, and a debian directory for Debian packaging. That structure makes the client easy to build from source and easy for a distribution to carry. It also means the runtime footprint includes Python and the GTK libraries, which is a real cost on minimal systems.

The project's development model is visible in the README too. It lists an issue tracker, a testing document for unstable builds, a translations workflow through Weblate, packaging and development guides, and an IRC channel on Libera.Chat. That is a community-maintained client with documented contribution paths, not a one-person fork. The trade-off is the usual one for community clients: features and fixes move at the pace of the contributors, and the release history shows that pace. Version 3.3.10 and 3.3.9 both landed on March 10, 2025, and 3.3.11 followed on September 16, 2026.

Maintenance, Licence and Upgrade Cost

The repository is not archived, and the last push was on 2026-09-23. That is a recent commit date, and the release cadence backs it up: 3.3.11 shipped on 2026-09-16, a week before that push. Whatever else is true about the project, the codebase is being touched.

Upgrade cost depends on how you installed it. If your distribution packages Nicotine+, upgrades arrive through the normal package manager flow and you get whatever version your distribution ships, which may lag the 3.3.11 release. If you build from source, you follow the packaging and development documents in the repository, and you need the build tooling that setup.py expects, including msgfmt from gettext for the translation step. The release notes in NEWS.md are where to check what changed between versions before you upgrade.

The licence is GPL-3.0-or-later, stated in the README and reflected in the SPDX headers at the top of pyproject.toml and setup.py. That is a copyleft licence. It does not restrict private use, but if you redistribute a modified client or ship it as part of a product, the licence terms apply to the whole work in the way the GPL describes. This is a description of what the repository states, not legal advice; read COPYING and the LICENSES directory before you redistribute anything.

Editorial conclusion

Nicotine+ suits desktop users who want a graphical Soulseek client and are comfortable installing from their distribution's package manager or the downloads listed in doc/DOWNLOADS.md. It is the wrong tool for anyone who needs encrypted communication, since the README states Soulseek is an unencrypted protocol not intended for secure communication, and it is not a mobile client. Before adopting it, check that your platform appears in doc/DOWNLOADS.md and read the Soulseek terms of service that the README links to, because those terms govern the network the client connects to.

Frequently asked questions

Official sources

1. License: GPL-3.0
2. nicotine-plus/nicotine-plus on GitHub
3. Project website
4. README
5. Releases