Installation

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