Iris/README.md

<img src="https://raw.githubusercontent.com/jaedb/Iris/master/src/assets/logo.png" width="128" />

Iris is an extension for the Mopidy music server. With support for Spotify, LastFM, Genius, Snapcast and many other extensions, Iris brings all your music into one user-friendly and unified web-based interface that works beautifully, no matter your device.

Built and maintained by James Barnsley.

[![Downloads](https://static.pepy.tech/personalized-badge/mopidy-iris?period=total&units=international_system&left_color=grey&right_color=green&left_text=Downloads)](https://pepy.tech/project/mopidy-iris)
[![npm](https://img.shields.io/npm/v/mopidy-iris.svg?style=flat-square)]()
![badge](https://img.shields.io/pypi/v/mopidy-iris.svg?style=flat-square)
![badge](https://img.shields.io/badge/unique_monthly_users-4,000+-brightgreen.svg?style=flat-square)
[![badge](https://img.shields.io/badge/donate-paypal-blue.svg?style=flat-square)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=james%40barnsley%2enz&lc=NZ&item_name=James%20Barnsley&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted)

Features
--------

* Full web-based interface controls for Mopidy
* Improved support for local libraries (powered by Mopidy-Local)
* Browse and manage your playlists and tracks
* Discover new, popular and related music (powered by Spotify)
* Multiple language support. [Want to provide a translation?](https://github.com/jaedb/Iris/wiki/Contributing#translations)
* Streaming controls with the ability to play audio from your browser (requires Snapcast)
* Integration with:
  * [Spotify](https://developer.spotify.com/web-api/)
  * [LastFM](https://www.last.fm/api) for rich music metadata and artwork
  * [Genius](https://docs.genius.com/) for lyrics
  * [Snapcast](https://github.com/badaix/snapcast/) to stream audio to multiple devices

![Overview](https://raw.githubusercontent.com/jaedb/Iris/master/screenshot.jpg)


Requirements
--------

* Mopidy
* Mopidy-Spotify (recommended, not required)
* Mopidy-Local (recommended, not required)

Getting started
-------

* [Installation](https://github.com/jaedb/Iris/wiki/Getting-started#installing)
* [Debugging](https://github.com/jaedb/Iris/wiki/Advanced#debugging)
* [Issues and requests](https://github.com/jaedb/Iris/wiki/Support#before-you-log-an-issue)
* [Changelog](https://github.com/jaedb/Iris/releases)