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

README.md

Headset

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: https://tinyurl.com/y7m8y5x4

Want to start contributing? Check out our contributing doc.

Installation

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: https://chocolatey.org/packages/headset

Linux

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

Debian

wget -q http://headsetapp.co/headset-electron/debian/headset.asc -O- | sudo apt-key add -
echo "deb [arch=amd64] http://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

Redhat

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

--- Or ---

sudo yum-config-manager --add-repo http://headsetapp.co/headset-electron/redhat/headset.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 https://github.com/headsetapp/headset-electron.git
  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 \
  --arch=x64
  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.