Dependencies

Required

• python3 >= 3.5 for interpreter;
• python3-gi for using GObject introspection with Python 3;
• gobject-introspection for GObject introspection;
• gir1.2-gtk-3.0 for GObject introspection bindings for GTK;
• python3-miniupnpc >= 1.9 for opening ports on your router or upnpc(1) if not available;
• python3-taglib for metadata parsing;
• robotframework for CI testing.

Optional

• gir1.2-appindicator3-0.1 or gir1.2-ayatanaappindicator3-0.1 for tray icon;
• gir1.2-gspell-1 for spell checking in chat;
• gir1.2-notify-0.7 for popup notifications and sounds;

Installing dependencies

GNU/Linux

Installing the required dependencies

• On Redhat/Fedora based distributions:

  sudo dnf install gobject-introspection gtk3 python3-dbus python3-gobject python3-miniupnpc python3-pytaglib
  

• On Debian/Ubuntu based distributions:

  sudo apt install gobject-introspection gir1.2-gtk-3.0 python3-dbus python3-gi python3-miniupnpc python3-taglib
  

Installing the optional dependencies

• On Redhat/Fedora based distributions:

  sudo dnf install gspell libappindicator-gtk3 libnotify
  

• On Debian/Ubuntu based distributions:

  sudo apt install gir1.2-appindicator3-0.1 gir1.2-gspell-1 gir1.2-notify-0.7
  

Check the Python version.

To check that the Python version you are using is 3.5 or newer use python -V. On lots of systems this will return something like this:

% python -V
Python 2.7.16

Not to worry, python version 3 is often installed alongside and can be used like this:

% python3 -V
Python 3.7.3

Windows

See PACKAGING.md