Nicotine+

Dependencies

Runtime

Required

• python3 >= 3.6 for runtime language;
• gtk4 >= 4.6.9 or gtk3 >= 3.22.30 for graphical interface;
• pygobject for Python bindings for GTK;

Recommended

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

Building

• build for building;
• gettext for generating translations;
• setuptools for packaging.

Testing

• pycodestyle for code style checks;
• pylint for linting.

Installing Dependencies

GNU/Linux

Installing Runtime Dependencies

• On Debian/Ubuntu-based distributions:

  sudo apt install gir1.2-gspell-1 gir1.2-gtk-4.0 gir1.2-adw-1
  python3-gi python3-gi-cairo
  

• On Redhat/Fedora-based distributions:

  sudo dnf install gspell gtk4 libadwaita python3-gobject
  

• On SUSE-based distributions:

  sudo zypper install typelib-1_0-Gspell-1 typelib-1_0-Gtk-4_0
  typelib-1_0-Adw-1 python312-gobject python312-gobject-cairo
  python312-gobject-Gdk
  

Installing Build Dependencies

• On Debian/Ubuntu-based distributions:

  sudo apt install gettext python3-build python3-setuptools
  

• On Redhat/Fedora-based distributions:

  sudo dnf install gettext python3-build python3-setuptools
  

• On SUSE-based distributions:

  sudo zypper install gettext-tools python312-build python312-setuptools
  

Installing Test Dependencies

• On Debian/Ubuntu-based distributions:

  sudo apt install pylint3 python3-pycodestyle
  

• On Redhat/Fedora-based distributions:

  sudo dnf install pylint python3-pycodestyle
  

• On SUSE-based distributions:

  sudo zypper install python312-pylint python312-pycodestyle
  

Windows and macOS

All required dependencies are included in the Nicotine+ Windows Installer and Nicotine+ macOS Installer official release packages, no additional steps are required by a regular user in order to install stable versions of Nicotine+.

For developers who need to build packages with dependencies in a development environment, see PACKAGING.md.