Introduction

Here is how you install the Python version of Remix from source on Mac, Windows, or Linux. This method is either for Linux users, "experts" or developers, people that may have their own versions of Python already installed, or people want to contribute to Remix in some way. If you want to install remix for development, you should read these notes too. If you're not one of those people, you most likely want one of the install packages on the main Python page , not this stuff. (A note for serious / crazy people: it is possible to install Remix on a Raspberry Pi. You can't use the dirac library though, so you'll have to remove any mention of it.) )

Requirements

Installing Remix from source requires:

• python2.5-dev -- Python 2.5, 2.6, or 2.7 with the headers
• ffmpeg (only if you are on Linux)
• python-numpy
• A build environment, either XCode (mac), build-essential (gcc, Linux), Visual Studio Express or higher (Windows)

Steps

• Install Numpy using the package manager of your choice, or from the web.
Install python2.5-dev using the package manager of your choice
• Install build-essential using the package manager of your choice, get XCode, or get Visual Studio Express
• If you are on Linux, you need to get ffmpeg if you don't already have it. Our distribution has builds for Mac and Windows, but not Linux. The best place to get a good build of ffmpeg with all the good codecs in it is the Debian Multimedia Repository. All you need to do is add the correct lines to your /etc/apt/sources.list file and then apt-get install ffmpeg. After installing ffmpeg, you need to make a symbolic link to it so that Remix knows where to find it:

  sudo ln -s `which ffmpeg` /usr/local/bin/en-ffmpeg

• Note that the setup.py script also installs a version of ffmpeg on Mac and Windows called "en-ffmpeg" as well as the youtube-dl script. The pysoundtouch and pydirac libraries are also compiled and copied over. The version of ffmpeg we install is not modified in any way but includes various useful codecs and is confirmed to work well with Remix. If you have your own version of ffmpeg, feel free to use it but it needs to be symlinked to en-ffmpeg (we do this to not trample on existing versions of ffmpeg a user may have installed.)

Test It

To test Python and Numpy, try the following:

python
import numpy

To test ffmpeg, try:

en-ffmpeg

Install

If those give no errors, you're ready to get remix installed. The easiest way to do it is with pip:

sudo pip install remix --allow-external remix

or easy_install:

sudo easy_install remix

(If you're installing into a virtualenv, you don't need to use sudo for pip or easy_install. Note that this will also install the examples into the virtualenv folder, rather than to the usual path.)

If you want to download and build the source yourself, you can get a tarball here.

Or, to make sure you've got the latest thing, get it with git:

• Clone the source code:

  git clone https://github.com/echonest/remix.git

• Initialize and update the pyechonest submodule:

  git submodule update --init

• Install remix using setup.py:

  sudo python setup.py install

Once that's done, you can return to the main Python page, get an API key, and run some examples!