docs: Use text from web site and readme

(cherry picked from commit 1e0569abb6)
This commit is contained in:
Stein Magnus Jodal 2014-08-03 23:23:34 +02:00
parent 837fb00fb7
commit 7fc89972a2

View File

@ -2,25 +2,64 @@
Mopidy Mopidy
****** ******
Mopidy is a music server which can play music both from multiple sources, like Mopidy is an extensible music server written in Python.
your :ref:`local hard drive <ext-local>`, :ref:`radio streams <ext-stream>`,
and from Spotify and SoundCloud. Searches combines results from all music
sources, and you can mix tracks from all sources in your play queue. Your
playlists from Spotify or SoundCloud are also available for use.
To control your Mopidy music server, you can use one of Mopidy's :ref:`web Mopidy plays music from local disk, Spotify, SoundCloud, Google Play Music, and
clients <http-clients>`, the :ref:`Ubuntu Sound Menu <ubuntu-sound-menu>`, any more. You edit the playlist from any phone, tablet, or computer using a range
device on the same network which can control :ref:`UPnP MediaRenderers of MPD and web clients.
<upnp-clients>`, or any :ref:`MPD client <mpd-clients>`. MPD clients are
available for many platforms, including Windows, OS X, Linux, Android and iOS. **Stream music from the cloud**
Vanilla Mopidy only plays music from your :ref:`local disk <ext-local>` and
:ref:`radio streams <ext-stream>`. Through :ref:`extensions <ext-backends>`,
Mopidy can play music from cloud services like Spotify, SoundCloud, and Google
Play Music. With Mopidy's extension support, backends for new music sources can
be easily added.
**Mopidy is just a server**
Mopidy is a Python application that runs in a terminal or in the background on
Linux computers or Macs that have network connectivity and audio output. Out of
the box, Mopidy is an :ref:`MPD <ext-mpd>` and :ref:`HTTP <ext-http>` server.
Additional frontends for controlling Mopidy can be installed from extensions.
**Everybody use their favorite client**
You and the people around you can all connect their favorite :ref:`MPD
<mpd-clients>` or :ref:`web client <http-clients>` to the Mopidy server to
search for music and manage the playlist together. With a browser or MPD
client, which is available for all popular operating systems, you can control
the music from any phone, tablet, or computer.
**Mopidy on Raspberry Pi**
The Raspberry Pi is a popular device to run Mopidy on, either using Raspbian or
Arch Linux. It is quite slow, but it is very affordable. In fact, the
Kickstarter funded Gramofon: Modern Cloud Jukebox project used Mopidy on a
Raspberry Pi to prototype the Gramofon device. Mopidy is also a major building
block in the Pi Musicbox integrated audio jukebox system for Raspberry Pi.
**Mopidy is hackable**
Mopidy's extension support and Python, JSON-RPC, and JavaScript APIs makes
Mopidy perfect for building your own hacks. In one project, a Raspberry Pi was
embedded in an old cassette player. The buttons and volume control are wired up
with GPIO on the Raspberry Pi, and is used to control playback through a custom
Mopidy extension. The cassettes have NFC tags used to select playlists from
Spotify.
**Getting started**
To get started with Mopidy, start by reading :ref:`installation`. To get started with Mopidy, start by reading :ref:`installation`.
**Getting help**
If you get stuck, we usually hang around at ``#mopidy`` at `irc.freenode.net If you get stuck, we usually hang around at ``#mopidy`` at `irc.freenode.net
<http://freenode.net/>`_ and also have a `mailing list at Google Groups <http://freenode.net/>`_ (with `searchable logs
<https://groups.google.com/forum/?fromgroups=#!forum/mopidy>`_. If you stumble <https://botbot.me/freenode/mopidy/>`_) and also have a `mailing list at Google
into a bug or got a feature request, please create an issue in the `issue Groups <https://groups.google.com/forum/?fromgroups=#!forum/mopidy>`_. If you
tracker <https://github.com/mopidy/mopidy/issues>`_. The `source code stumble into a bug or got a feature request, please create an issue in the
`issue tracker <https://github.com/mopidy/mopidy/issues>`_. The `source code
<https://github.com/mopidy/mopidy>`_ may also be of help. If you want to stay <https://github.com/mopidy/mopidy>`_ may also be of help. If you want to stay
up to date on Mopidy developments, you can follow `@mopidy up to date on Mopidy developments, you can follow `@mopidy
<https://twitter.com/mopidy/>`_ on Twitter. <https://twitter.com/mopidy/>`_ on Twitter.