************
Frontend API
************

The following requirements applies to any frontend implementation:

- A frontend MAY do mostly whatever it wants to, including creating threads,
  opening TCP ports and exposing Mopidy for a group of clients.
- A frontend MUST implement at least one `Pykka
  <http://jodal.github.com/pykka/>`_ actor, called the "main actor" from here
  on.
- It MAY use additional actors to implement whatever it does, and using actors
  in frontend implementations is encouraged.
- The frontend is activated by including its main actor in the
  :attr:`mopidy.settings.FRONTENDS` setting.
- The main actor MUST be able to start and stop the frontend when the main
  actor is started and stopped.
- The frontend MAY require additional settings to be set for it to
  work.
- Such settings MUST be documented.
- The main actor MUST stop itself if the defined settings are not adequate for
  the frontend to work properly.
- Any actor which is part of the frontend MAY implement any listener interface
  from :mod:`mopidy.listeners` to receive notification of the specified events.

Frontend implementations
========================

* :mod:`mopidy.frontends.lastfm`
* :mod:`mopidy.frontends.mpd`