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

To install using PIP

1. Run sudo pip install Mopidy-Iris
2. Run sudo echo "mopidy ALL=NOPASSWD: /usr/local/lib/python2.7/dist-packages/mopidy_iris/system.sh" >> /etc/sudoers to allow mopidy user sudo permission to run the Iris installer. If you've customised your install location, make sure you change the path to Iris' system.sh file.

To install manually

1. Pull code base git clone [email protected]:jaedb/Iris.git
2. Install package python setup.py install
3. Run sudo echo "mopidy ALL=NOPASSWD: XXX/mopidy_iris/system.sh" >> /etc/sudoers to allow mopidy user sudo permission to run the Iris installer, where XXX is your path to Iris (eg /var/www/iris/).

To install using Docker

1. Clone this repository or create an empty directory iris and refer to this repository for sample files.
2. Create ./docker-compose.yml (sample) and update as required.
3. Create file ./docker/mopidy.conf (sample) and update as required
4. Run docker-compose up

Configuration

Iris will work for most users out-of-the-box. You can customise some of the configuration settings if you wish.

These optional values are defined in your mopidy.conf file (typically ~/.config/mopidy/mopidy.conf). They can be set in the [iris] section.

• country Spotify-based country code (defaults to nz)
• locale Spotify-based locale code (defaults to en_NZ)
• spotify_authorization_url URL to use as Spotify authentication proxy (defaults to https://jamesbarnsley.co.nz/auth_spotify.php)
• lastfm_authorization_url URL to use as LastFM authentication proxy (defaults to https://jamesbarnsley.co.nz/auth_lastfm.php)
• snapcast_enabled (defaults to false)
• snapcast_host Hostname to your Snapcast server (defaults to localhost)
• snapcast_port Port to your Snapcast server (defaults to 1705)

Running

1. Start the Mopidy server: service mopidy start (or mopidy if you haven't setup Mopidy as a service).
2. Open your browser at http://localhost:6680/iris/ (or http://hostname:6680/iris/, where hostname is your server's hostname or IP address).

Upgrading

To upgrade within Iris (Beta)

1. Ensure you're running Mopidy as a service
2. Run sudo echo "mopidy ALL=NOPASSWD: /usr/local/lib/python2.7/dist-packages/mopidy_iris/system.sh" >> /etc/sudoers to allow mopidy user sudo permission to run the Iris installer. If you've customised your install location, make sure you change the path to Iris' system.sh file. You may have already done this during installation.
3. You can now upgrade using the Upgrade button under Settings

Upgrade using PIP

1. Run sudo pip install --upgrade Mopidy-Iris.
2. Restart Mopidy

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