mopidy-touchscreen

****************************
Mopidy-Touchscreen
****************************

.. image:: https://img.shields.io/pypi/v/Mopidy-Touchscreen.svg?style=flat
:target: https://pypi.python.org/pypi/Mopidy-Touchscreen/
:alt: Latest PyPI version

.. image:: https://img.shields.io/pypi/dm/Mopidy-Touchscreen.svg?style=flat
:target: https://pypi.python.org/pypi/Mopidy-Touchscreen/
:alt: Number of PyPI downloads

.. image:: https://img.shields.io/travis/9and3r/modipy-touchscreen/master.png?style=flat
:target: https://travis-ci.org/9and3r/modipy-touchscreen
:alt: Travis CI build status

.. image:: https://img.shields.io/coveralls/9and3r/modipy-touchscreen/master.svg?style=flat
:target: https://coveralls.io/r/9and3r/modipy-touchscreen?branch=master
:alt: Test coverage

Extension for displaying track info and controlling Mopidy from a touch screen using `PyGame `_/SDL.

Dependencies
============

- ``Mopidy`` >= 0.18
- ``Pykka`` >= 1.1
- ``pygame``

Installation
============

Install by running::

pip install Mopidy-Touchscreen

Or, if available, install the Debian/Ubuntu package from `apt.mopidy.com
`_.


Configuration
=============

Before starting Mopidy, you must add configuration for
Mopidy-Touchscreen to your Mopidy configuration file::

[touchscreen]
enabled = true
screen_width = 320
screen_height = 240
cursor = True
fullscreen = False
cache_dir = $XDG_CACHE_DIR/mopidy/touchscreen

The following configuration values are available:

- ``touchscreen/enabled``: If the Touchscreen extension should be enabled or not.
- ``touchscreen/screen_width``: The width of the resolution you want to use in pixels.
- ``touchscreen/screen_height``: The width of the resolution you want to use in pixels.
- ``touchscreen/cursor``: If the mouse cursor should be shown. (If you use a touchscreen it should be false)
- ``touchscreen/fullscreen``: If you want to be shown as a window or in fullscreen.
- ``touchscreen/screen_width``: The folder to be used as cache. Defaults to ``$XDG_CACHE_DIR/mopidy/touchscreen``, which usually means
``~/.cache/mopidy/spotify``

Features
=============

Working
-------

* See track info (track name, album, artist, cover image)
* Seek Track
* Play/Pause
* Mute/Unmute
* Change volume
* Next/Previous track
* Library
* Menu (exit mopidy, restart...)
* Shuffle on/off
* Repeat one/on/off
* Playback list and song selection
* Playlists

Planned
-------

* Use keyboard or GPIO buttons instead of touchscreen

Screenshots
===========

.. image:: http://i60.tinypic.com/qqsait.jpg

Video
=====

`Example video running the extension `_

Project resources
=================

- `Source code `_
- `Issue tracker `_
- `Download development snapshot `_


Changelog
=========

v0.2.0
----------------------------------------

- First working version

v0.1.0 (UNRELEASED)
----------------------------------------

- Initial release.