malept/gmusicprocurator

================
GMusicProcurator
================

.. image:: https://travis-ci.org/malept/gmusicprocurator.svg?branch=master
   :target: https://travis-ci.org/malept/gmusicprocurator
   :alt: [Travis CI]

.. image:: https://codeclimate.com/github/malept/gmusicprocurator/badges/gpa.svg
   :target: https://codeclimate.com/github/malept/gmusicprocurator
   :alt: [CodeClimate]

.. image:: https://readthedocs.org/projects/gmusicprocurator/badge/
   :target: https://gmusicprocurator.readthedocs.org/
   :alt: [Read The Docs]

.. image:: https://img.shields.io/badge/Hu-Board-8165d0.svg?style=flat
   :target: https://huboard.com/malept/gmusicprocurator
   :alt: [HuBoard]

A proxy/HTML5 frontend for Google Music streaming. This mini webapp is
inspired by GMusicProxy_.

.. _GMusicProxy: http://gmusicproxy.net

Features
--------

* XSPF playlists
* Option to ID3v2-tag MP3 streams

  * Option to embed album art in MP3 streams
* Browse playlists via an HTML5 frontend
* Stream playlists in the browser without using Flash or other browser plugins,
  in `browsers that support HTML5 Audio`_

.. _browsers that support HTML5 Audio: http://caniuse.com/audio

Documentation
-------------

Installation instructions, configuration, API docs, and other information are
hosted on `Read the Docs`_.

.. _Read the Docs: https://gmusicprocurator.readthedocs.org/

Related
-------

* `Electron frontend`_ - desktop shell for GMusicProcurator using
  Atom's Electron_
* `Saltstack formula`_ - Use the Saltstack_ configuration management system to
  install GMusicProcurator

.. _Electron frontend: https://github.com/malept/gmusicprocurator-app
.. _Electron: http://electron.atom.io/
.. _Saltstack formula: https://github.com/malept/gmusicprocurator-formula
.. _Saltstack: https://docs.saltstack.com/

Legal
-----

This web application is licensed under the terms of the GNU General Public
License (GNU GPL), version 3 or later, unless otherwise noted in the source
files. See ``LICENSE`` for the full license text.

The documentation is licensed under the Creative Commons
Attribution-ShareAlike 4.0 International License; see the ``LICENSE.docs``
file for details.

The favicon is the "`Tango Music Charts`_" icon. According to the source page,
it is licensed under a `Creative Commons Attribution-Share Alike 3.0 License
<http://creativecommons.org/licenses/by-sa/3.0/>`_.

.. _Tango Music Charts: http://darkobra.deviantart.com/art/Tango-Music-Charts-Icon-121663353

This project is not affiliated in any way to Google or any of Google's
music apps.