Skip to main content

Browse & play embedded tracks from Angry Metal Guy music reviews

Project description

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

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

amg-player-0.2.1.tar.gz (12.4 kB view hashes)

Uploaded Source

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