Getting started

Iris is a frontend for the Mopidy music server. The purpose of Iris is to pull together a variety of music sources and present them in an extremely functional and user-friendly experience. The primary music source (at this time) is Spotify, provided by the Mopidy-Spotify backend.

Installing

Requirements

• Mopidy
• Mopidy-Spotify
• Mopidy-Local-SQLite (recommended)

Installation

1. Install Iris sudo pip install Mopidy-Iris
2. Start Mopidy mopidy
3. Open your Mopidy URL (eg http://localhost:6680) and click Iris
4. For the best experience, login to Spotify in the Settings page
5. Welcome to Iris!

Configuration

These values are defined in your mopidy.conf file (typically ~/.config/mopidy/mopidy.conf).

• country Spotify-based country code (defaults to nz)
• locale Spotify-based locale code (defaults to en_NZ)
• authorization_url URL to use as Spotify authentication proxy (defaults to https://jamesbarnsley.co.nz/auth2.php)

Upgrading

You can upgrade from Iris under Settings > Upgrade. This is in beta, and you will need to restart Mopidy for the upgrade to complete. Alternatively run sudo pip install --upgrade Mopidy-Iris.

If you're experiencing dependency issues, try installing without dependencies sudo pip install --upgrade --no-deps Mopidy-Iris.