/iheart-cli

Command line utility to search and play iHeartRadio

Primary LanguagePythonMIT LicenseMIT

iHeart Radio

Command line client for iHeartRadio

Python 3.6 license

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