Installation

Windows

This part assumes you have Python 2.6 or 2.7 installed already. Python 3.x is not supported.

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: python 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 2.7: sudo pkg install python27
• Install SQLite3 from Python2.7: sudo pkg install py27-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.

Mac OSX

Screenshot Guide

Headphones will be installed to /Applications/Headphones

• 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: python 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: python 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 container available at https://hub.docker.com/r/linuxserver/headphones/

Raspberry Pi

Full Guide including Startup Script