Giter VIP home page Giter VIP logo

nicotine-plus's Introduction

Nicotine+

Nicotine+ is a graphical client for the Soulseek peer-to-peer file sharing network.

Nicotine+ aims to be a pleasant, Free and Open Source (FOSS) alternative to the official Soulseek client, providing additional functionality while keeping current with the Soulseek protocol.

Check out the screenshots and source code.

Download Nicotine+

The current stable version of Nicotine+ is 3.0.2, released on March 1, 2021. See the release notes.

GNU/Linux, *BSD

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

Ubuntu PPA/Debian (Stable)

To use stable packages on Ubuntu and Debian, run the following:

sudo apt install software-properties-common
sudo add-apt-repository ppa:nicotine-team/stable
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6CEB6050A30E5769
sudo apt update
sudo apt install nicotine

Ubuntu PPA/Debian (Unstable)

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

sudo apt install software-properties-common
sudo add-apt-repository ppa:nicotine-team/unstable
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6CEB6050A30E5769
sudo apt update
sudo apt install nicotine

Arch Linux/Manjaro/Parabola (Stable)

Nicotine+ is available in the community repository of Arch Linux, Manjaro and Parabola. To install, run the following:

sudo pacman -S nicotine+

Void Linux (Stable)

To install Nicotine+ on Void Linux, run the following:

sudo xbps-install -S nicotine+

Fedora (Stable)

To install Nicotine+ on Fedora, run the following:

sudo dnf install nicotine+

Guix (Stable)

To install Nicotine+ on Guix, run the following:

guix install nicotine+

Other Distributions

If Nicotine+ isn't packaged for your distribution/operating system yet, there are other recommended ways of installing Nicotine+.

pip (Stable)

Nicotine+ can be installed using pip. Ensure the dependencies are installed, and run the following:

pip3 install nicotine-plus

Flathub (Stable)

If your distribution supports Flatpak, you can install Nicotine+ from Flathub.

Download Nicotine+ on Flathub

Windows

Stable

Stable Windows installers for Nicotine+ are available to download. Installing Nicotine+ requires administrator privileges.

If you don't want to, or you aren't able to install Nicotine+ on your system, portable packages are also available. These can be run from your home directory.

Unstable

Unstable Windows packages are generated after every commit to the master branch, and should only be used for testing. You need to be signed into a GitHub account to download the packages.

macOS

Stable (Catalina/10.15 and newer)

A stable macOS installer for Nicotine+ is available on macOS version 10.15 (Catalina) and newer.

Stable (Mojave/10.14)

On macOS version 10.14 (Mojave), the recommended approach is to install Nicotine+ using Homebrew.

Once Homebrew is set up, run the following:

brew install nicotine-plus

Unstable (Catalina/10.15 or newer)

Unstable macOS installers are generated after every commit to the master branch, and should only be used for testing. You need to be signed into a GitHub account to download the installers.

Building from git (Unstable)

For more experienced users and developers who want to test the latest and greatest changes in Nicotine+, building from git is described in RUNFROMGIT.md. Also read the next section about getting involved.

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:

  • If you'd like to translate Nicotine+ into another language it has not been already, see TRANSLATIONS.md.
  • If you find a problem or have a feature request you can
  • If you're packaging Nicotine+ for a distribution or operating system, see DEPENDENCIES.md for a list of dependencies.
  • Code contributors, developers and maintainers should read DEVELOPING.md for important information about various aspects of Nicotine+ development. Developers are also encouraged to join the Launchpad Team or subscribe to the mailing list so that they are automatically notified of failed commits.
  • For (unofficial) documentation of the Soulseek protocol, see SLSKPROTOCOL.md
  • For a current list of things to do, see the issue tracker.
  • For a list of contributors to Nicotine+ and its predecessors, see AUTHORS.md.

Where did the name Nicotine come from?

I was in a geeky mood and was browsing http://www.bash.org's QDB.
I stumbled across this quote:

<etc> so tempting to release a product called 'nicotine' and wait for the patches.
<etc> then i would have a reason to only apply one patch a day. otherwise, i'm going against medical advise.

So I thought what the hell and bluntly stole etc's idea.

Hyriand, founder of the Nicotine project

Legal and Privacy

  • By using Nicotine+, you agree to abide by the Soulseek rules and terms of service, as long as you are using the official Soulseek server.
  • While Nicotine+ does not collect any user data, the official Soulseek server or a user-configured third-party server may potentially do so.

License

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

nicotine-plus's People

Contributors

baloo79 avatar chzchzchz avatar droserasprout avatar elverde avatar emilazy avatar gahag avatar gall0ws avatar gfarmerfr avatar hattshire avatar hboetes avatar josepanguera avatar kiplingw avatar kristopolous avatar lene avatar m0rf30 avatar mariachini avatar mathiascode avatar melmorabity avatar mendelgusmao avatar mutnick avatar redactedscribe avatar seeschloss avatar toofar avatar vsedach avatar zniavre avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.