Skip to content
Official Headset repo
JavaScript Shell PowerShell HTML CSS
Branch: master
Clone or download


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.

Linux/macOS Build Status Windows Build status

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:

Want to start contributing? Check out our contributing doc.


macOS (Homebrew)

Update Homebrew and install headset using Hombrew Cask

brew update
brew cask install headset

Windows (Chocolatey)

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:


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


wget -q -O- | sudo apt-key add -
echo "deb [arch=amd64] 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
sudo dnf install headset

--- Or ---

sudo yum-config-manager --add-repo
sudo yum install headset

Build from source

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
  1. Install dependencies
$ cd headset-electron
$ npm ci
  1. 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 \
  1. [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.
You can’t perform that action at this time.