thismachine/nicotine-debug repository overview

⁠Nicotine+

⁠Notes porting to Python 3

• sudo apt install libcairo2-dev libgirepository1.0-dev
• pip install pygobject
• pip install mutagen

⁠Intro

A graphical client for the SoulSeek peer-to-peer system.

Nicotine+ is a graphical client for the SoulSeek peer-to-peer system. It is an attempt to keep Nicotine working with the latest libraries, kill bugs, keep current with the SoulSeek protocol, and add some new features that users want and/or need.

⁠License

Nicotine+ released under the terms of the GNU Public License v3⁠ or later.

⁠Getting Involved

Please come and join us in the #nicotine+ channel on Freenode!

If you'd like to contribute, you have a couple of options to get started. You can open an issue ticket on GitHub, discuss in #nicotine+, or post to the project mailing list⁠. Developers are also encouraged to join the Launchpad Team⁠ or subscribe to the mailing list so that they are automatically notified of failed commits.

There is a current list of things TODO⁠. If you'd like to translate Nicotine+ into another language it has not been already, see TRANSLATIONS⁠.

You want to contact someone? See: MAINTAINERS⁠

⁠Precompiled Packages

If you have no need to modify the Nicotine+ source, you are strongly recommended to use precompiled packages for your distribution. This will save you time.

⁠Ubuntu PPA (Unstable)

The project builds daily unstable snapshots⁠ in a separate unstable PPA⁠. To use it, run the following:

$ sudo add-apt-repository ppa:nicotine-team/unstable
$ sudo apt update
$ sudo apt install nicotine

⁠Ubuntu PPA (Stable)

To use stable packages⁠, run the following:

$ sudo add-apt-repository ppa:nicotine-team/stable
$ sudo apt update
$ sudo apt install nicotine

⁠Other Distributions

Package maintainers, please insert instructions for users to install pre-compiled packages from your respective repositories here. For packaging instructions please see PACKAGING⁠. For downstream packages patches DISTRO_PATCHES⁠.

⁠Versioning scheme

Nicotine+ uses a versioning scheme similar to what gnome does:

• Stable releases have an even minor version number, ex: 1.4.x, 1.6.x, ...

• Unstable releases have an odd minor version number, ex: 1.3.x, 1.5.x, ...

⁠Run it from git

To run it from git master see: RUNFROMGIT⁠

A Debian/Ubuntu repository containing the latest git master-based packages is also available: GITDEB⁠

⁠Dependencies

⁠Required

• Python 2.7.X⁠
• Gtk+ 2.24.X⁠
• PyGTK 2.24.X⁠
• mutagen⁠

⁠Optional

• GeoIP python bindings⁠ for Country lookup: need an alternative (unmaintained).
• python-notify⁠ for notification support: need an alternative (unmaintained).
• MiniUPnPc python module or binary⁠ for opening ports on your router.
• Python for Windows Extensions⁠ for hiding directories from your shares (Windows only).