iHeart Radio

Command line client for iHeartRadio

This project is meant to be a learning exercise. It is heavily inspired by pianobar which I love!

The project is a cross platform iHeartRadio console client implemented in Python. It is simply an alternative to playing iHeartRadio on the browser; only plays Live and Artist radio stations which are available without needing to create an account.

Features

• Play Live and Artist radio stations
• Play Song radio stations (Which are essentially Artist stations, but created using song names)

• Save song urls into local playlists maintained as json files

  • Each playlist is saved as a separate json file and can be freely copied between machines
  • Play songs in a playlist sequentially or on shuffle

• Play aNONradio
• Play internet-radio

Dependencies

This project does not implement an audio player. It uses VLC for cross platform audio playback. It can be installed from the VLC website

Installation/Usage

Stable release using pip - Great read

$ pip install -U iheart-cli
$ iheart --help

Latest code from repository (might contains bugs and incomplete features)

$ git clone https://github.com/shashfrankenstien/iheart-cli.git
$ cd iHeart-cli
$ python3 -m iheart --help

TODO

• Add more / better tests
• aNONradio and internet-radio are very slow to start (almost 1 minute) - look into vlc documentation