Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


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.

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 Homebrew Cask

brew update
brew install --cask 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:


Download on Flathub Get it from the Snap Store

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 tee /usr/share/keyrings/headset-archive-keyring.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/headset-archive-keyring.gpg] 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.


App Design by Hélène Giraud