Skip to main content

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

Metadata

Release files for iheart-cli 0.7.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iheart-cli 0.7.3
File Size Uploaded
iheart-cli-0.7.3.tar.gz 21.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iheart-cli 0.7.3
File Interpreter ABI Platform
iheart_cli-0.7.3-py3-none-any.whl Python 3 none any Details

Total release size: 45.4 kB

Release files / iheart-cli-0.7.3.tar.gz

Download URL iheart-cli-0.7.3.tar.gz
Size 21.5 kB
Tags Source
SHA-256 checksum
How to use checksums
7b7fa8790d0612dc18b4cc7f4e5d5af73d43b0fb866877f7d5b3637128d100b9
BLAKE2b-256 checksum
How to use checksums
1899e76abacf2da137c17d4a7762d5a9675bee4ddbe5d5038c934c9a1398016a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.10.6

Release files / iheart_cli-0.7.3-py3-none-any.whl

Download URL iheart_cli-0.7.3-py3-none-any.whl
Size 23.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6212e930d7b3f3b16a57a14dfbf5bab758d94e06c967fa33764467ef93055cf9
BLAKE2b-256 checksum
How to use checksums
ed15d8a075461dc3bde579bd9c97ceb9ea444a881f67ba69250e707a9ab9c96b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.10.6

Release history Release notifications | RSS feed

This release

0.7.3 This release

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page