Installation - rembo10/headphones GitHub Wiki

Windows

This part assumes you have Python 3.6+ installed already.

Screenshot Guide including Git, Python and Startup Script

  1. Download Headphones from GitHub: https://github.com/rembo10/headphones/zipball/master
  2. Extract the ZIP file.
  3. Double click Headphones.py.
  4. Headphones will be loaded in your browser or listening @ http://localhost:8181.
  5. Create a shortcut to Headphones.py and copy that to your startup folder (C:\Documents and Settings\<Username>\Start Menu\Programs\Startup) to startup Headphones when Windows starts.

Linux

Headphones will be installed to /opt/headphones.

  • Open a terminal
  • Install Git
    • Ubuntu/Debian: sudo apt-get install git-core
    • Fedora: sudo yum install git
  • Type: cd /opt.
  • Type: git clone https://github.com/rembo10/headphones.git
  • Type: cd headphones
  • Type: python3 Headphones.py
  • Headphones will be loaded in your browser or listening @ http://localhost:8181
  • To start Headphones on startup, refer to Install as a daemon

FreeBSD

Headphones will be installed to /usr/local/headphones.

  • Open a terminal
  • Install Git: sudo pkg install git
  • Install Python 3.6+: sudo pkg install python3
  • Install SQLite3: sudo pkg install sqlite3
  • Move to install directory, cd /usr/local
  • Clone the repository, git clone https://github.com/rembo10/headphones.git
  • cd to the repository, cd headphones
  • Run the server, python2.7 Headphones.py
  • Headphones will be loaded in your browser or listening on port 8181.

MacOS

Screenshot Guide

Headphones will be installed to /Applications/Headphones You'll need to have python3, which can be installed, e.g., through the homebrew package manager, or directly from https://python.org

  • Method 1 (easy):
    • Download Headphones from GitHub: https://github.com/rembo10/headphones/zipball/master
    • Extract the zip to /Applications/Headphones. Make sure you extract the files directly in the root.
    • Open a terminal
    • Type: cd /Applications/Headphones
    • Type: python3 Headphones.py
  • Method 2 (preferred):
    • Open a terminal
    • Install Git. This can be done via xcode-select --install
    • Type: cd /Applications
    • Type: git clone https://github.com/rembo10/headphones.git Headphones
    • Type: cd /Applications/Headphones
    • Type: python3 Headphones.py

Headphones will be loaded in your browser or listening @ http://localhost:8181.
To start Headphones on startup, refer to Install as a daemon

Synology NAS

  1. Add the SynoCommunity package repository
  2. Download and install HeadPhones from the package center
  3. Headphones can be accessed at http://ipadress_synology:8181

Docker

There is a Docker image available at https://hub.docker.com/r/linuxserver/headphones/

Raspberry Pi

Full Guide including Startup Script

⚠️ **GitHub.com Fallback** ⚠️