This project is currently not being actively maintained and is not accepting new pull requests or issues. Thank you for your understanding.

ATTENTION: Headset no longer uses a shared YouTube API Key. Please create your own key by Following this quick guide and make sure you are running the latest version.

Headset is a simple music player for Mac, Windows and Linux with integrated YouTube search, a home screen with popularity list by genres and eras, and best of all, a radio powered by Reddit. Headset takes the songs that are shared in over 80 music subreddits, categorizes them and plays them automatically. It's a great and pretty unique way to find new music as it is chosen by other humans like you and not by algorithms.

Have a question? Join our Slack workspace: https://tinyurl.com/8ejkcdac

Want to start contributing? Check out our contributing doc.

Update Homebrew and install headset using Homebrew Cask

brew update
brew install --cask headset

To install, run the following command from the command line or from PowerShell:

C:\> choco install headset

To upgrade, run the following command from the command line or from PowerShell:

C:\> choco upgrade headset

More details in the chocolatey page: https://chocolatey.org/packages/headset

As an alternative to .deb and .rpm packages on the website, you can also install it directly from the command-line:

wget -q https://headsetapp.co/headset-electron/headset.gpg -O- | sudo tee /usr/share/keyrings/headset-archive-keyring.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/headset-archive-keyring.gpg] https://headsetapp.co/headset-electron/debian stable non-free" | sudo tee /etc/apt/sources.list.d/headset.list
sudo apt-get update
sudo apt-get install headset

sudo dnf config-manager --add-repo https://headsetapp.co/headset-electron/redhat/headset.repo
sudo dnf install headset

--- Or ---

sudo yum-config-manager --add-repo https://headsetapp.co/headset-electron/redhat/headset.repo
sudo yum install headset

If you would like to create a build for a different environment (e.g Manjaro or Aur, etc.) please follow these steps:

1. Install NodeJs 8 or later

2. Clone the Repo

$ git clone https://github.com/headsetapp/headset-electron.git

3. Install dependencies

$ cd headset-electron
$ npm ci

4. Create your build:

electron-packager . \
  --executable-name headset \
  --ignore "(^/bin$|^/sig$|^/gh-pages$|^/player$|^/test$|Procfile|\.md$|^\.|^\/\.)" \
  --prune true \
  --out build/ \
  --overwrite \
  --asar \
  --platform=linux \
  --arch=x64

5. [Optional] For the Ubuntu build, we're using electron-installer-debian and for the Fedora build, we're using electron-installer-redhat. There might be an installer for your specific version, just have to google it.

App Design by Hélène Giraud www.girographe.com