Skip to main content

Mopidy Web client extension for mobile devices

Project description

Mopidy Mobile aims to be a simple, easy to use remote that lets you fully control a Mopidy music server from your mobile device. It is available as a Web client extension and a hybrid app for Android version 4.4 and higher. Users of older Android versions may still access the Web extension using Google’s Chrome browser. On Apple devices, the Web client should work with iOS 7 or higher.

In a nutshell, Mopidy Mobile lets you

  • Browse and search your entire Mopidy music library.

  • Search within selected directories only.

  • Edit the tracks in the current tracklist.

  • Create and edit playlists (requires Mopidy server v1.x).

  • Download cover art from selected online resources.

Installation

The Web extension can be installed from PyPi by running:

pip install Mopidy-Mobile

The Android app is available from the Google Play store. You may also join the Beta testing program to preview unreleased versions.

Note that the Web client is designed to be added to your home screen, so it is launched in full-screen “app mode”. In fact, the only major difference between the Web client and the hybrid app is that the app will let you manage multiple Mopidy server instances. Other than that, they are functionally equivalent. If you don’t know how to add a Web application to your home screen, there are plenty of instructions available online for both Android and iOS.

Configuration

The following configuration values are available for the Web extension:

  • mobile/enabled: Whether the Mopidy Mobile Web extension should be enabled. Defaults to true.

  • mobile/title: The Web application’s title, which will also be displayed when added to your home screen. The variables $hostname and $port can be used in the title. Defaults to Mopidy Mobile on $hostname.

  • mobile/ws_url: The WebSocket URL used to connect to your Mopidy server. Set this if Mopidy’s WebSocket is not available at its default path /mopidy/ws/, for example when using a reverse proxy.

Building from Source

Mopidy Mobile is built using Ionic, AngularJS and Apache Cordova, so it is recommended to familiarize yourself with these before you start.

To build the Mopidy Web extension, you need to have npm and gulp installed. Then run:

npm install
gulp install
gulp dist
pip install --editable .

To build the hybrid app for Android, please follow Ionic’s installation guide to make sure you have everything needed for Android development. Then, in addition to the commands above, run:

ionic resources android
ionic platform add android
ionic build android

Project Resources

Latest PyPI version Number of PyPI downloads Travis CI build status Test coverage

License

Copyright (c) 2015, 2016 Thomas Kemmer.

Licensed under the Apache License, Version 2.0.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Mopidy-Mobile-1.6.11.tar.gz (986.6 kB view hashes)

Uploaded Source

Built Distribution

Mopidy_Mobile-1.6.11-py2.py3-none-any.whl (982.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page