amg-player 0.2.1

Browse & play embedded tracks from Angry Metal Guy music reviews

Angry Metal Guy Player
======================

|Latest Version| |Tests Status| |Coverage| |Supported Python versions|
|License|

Angry Metal Guy Player (AMG Player) is a Python multi platform console
tool to automatically play tracks from `Angry Metal
Guy <https://www.angrymetalguy.com/>`__ reviews.

I created this because:

- I like Angry Metal Guy, and discovered great music (both metal and
totally non-metal) thanks to their reviews
- I often disagree with their ratings (in fact I disagree more often
than I agree), both for overrating and underrating
- Even when I disagree, I like reading their reviews
- I want to listen to the music **before** I read the review, to avoid
getting influenced
- To be efficient, I want to listen to the tracks like a radio, and
read the review to learn more only when I like something

Features
--------

- Can work either in interactive mode (manually select tracks) or
totally automatic (play new tracks like a radio)
- Supports embedded tracks from: YouTube, Bandcamp, SoundCloud
- Play YouTube video if available, or generate a video on the fly with
the cover image + audio track(s) (requires FFMpeg or Libav)

Screenshots
-----------

| Selection screen:
| |Imgur|

| Playing a track:
| |Imgur|

Installation
------------

Angry Metal Guy Player requires
`Python <https://www.python.org/downloads/>`__ >= 3.3.

From PyPI (with PIP)
~~~~~~~~~~~~~~~~~~~~

1. If you don't already have it, `install
pip <http://www.pip-installer.org/en/latest/installing.html>`__ for
Python 3 (not needed if you are using Python >= 3.4)
2. Install Angry Metal Guy Player: ``pip3 install amg``

From source
~~~~~~~~~~~

1. If you don't already have it, `install
setuptools <https://pypi.python.org/pypi/setuptools#installation-instructions>`__
for Python 3
2. Clone this repository:
``git clone https://github.com/desbma/amg-player``
3. Install Angry Metal Guy Player: ``python3 setup.py install``

**Angry Metal Guy Player only supports `MPV player <https://mpv.io/>`__
for now.**

Command line usage
------------------

Run ``amg -h`` to get full command line reference.

Examples
~~~~~~~~

- Browse and play interactively last 50 reviews:

``amg -c 50``

- Choose the first track to play, then play all tracks in chronological
order:

``amg -m radio``

- Play last 20 tracks in chronological order, skipping those already
played:

``amg -c 20 -m discover``

License
-------

`GPLv3 <https://www.gnu.org/licenses/gpl-3.0-standalone.html>`__

.. |Latest Version| image:: https://img.shields.io/pypi/v/amg-player.svg?style=flat
:target: https://pypi.python.org/pypi/amg-player/
.. |Tests Status| image:: https://img.shields.io/travis/desbma/amg-player/master.svg?label=tests&style=flat
:target: https://travis-ci.org/desbma/amg-player
.. |Coverage| image:: https://img.shields.io/coveralls/desbma/amg-player/master.svg?style=flat
:target: https://coveralls.io/github/desbma/amg-player?branch=master
.. |Supported Python versions| image:: https://img.shields.io/pypi/pyversions/amg-player.svg?style=flat
:target: https://pypi.python.org/pypi/amg-player/
.. |License| image:: https://img.shields.io/github/license/desbma/amg-player.svg?style=flat
:target: https://pypi.python.org/pypi/amg/
.. |Imgur| image:: https://i.imgur.com/me4rzHSm.png
:target: https://i.imgur.com/me4rzHS.png
.. |Imgur| image:: https://i.imgur.com/pXUScj2m.png
:target: https://i.imgur.com/pXUScj2.png