Official Headset repo
JavaScript Shell PowerShell HTML CSS
Clone or download
fcastilloec Merge pull request #185 from headsetapp/windows-debugging
Log windows debug messages to file
Latest commit 6e7e58a Jul 13, 2018


Linux: 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. Go into your specific OS folder and install dependencies
$ cd headset-electron/linux
$ npm install

On Linux, the dbus module also has it's own dependencies that need to be installed.

  1. Create your build:
electron-packager . \
  --executable-name headset \
  --ignore "(bin|Procfile|sig|gh-pages)" \
  --prune true \
  --out build/ \
  --overwrite \
  --asar \
  --platform=linux \

For Linux, a 32bit system is required in order to package Headset for arch=ia32 due to dbus module own dependencies.

  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.