Nicotine+

Dependencies

Runtime

Required

• python3 >= 3.9 for runtime language;
• gtk4 >= 4.6.9 or gtk3 >= 3.24.24 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

• python3-setuptools for build backend;
• python3-build for building;
• python3-wheel for packaging;
• gettext for generating translations.

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 python313-gobject python313-gobject-cairo python313-gobject-Gdk
  

• On Alpine-based distributions:

  sudo apk add gspell gtk4.0 libadwaita py3-gobject3
  

Installing Build Dependencies

• On Debian/Ubuntu-based distributions:

  sudo apt install gettext python3-build python3-setuptools python3-wheel
  

• On Redhat/Fedora-based distributions:

  sudo dnf install gettext python3-build python3-setuptools python3-wheel
  

• On SUSE-based distributions:

  sudo zypper install gettext-tools python313-build python313-setuptools python313-wheel
  

• On Alpine-based distributions:

  sudo apk add gettext py3-build py3-setuptools py3-wheel
  

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 python313-pylint python313-pycodestyle
  

• On Alpine-based distributions:

  sudo apk add py3-pylint py3-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.