iHeart Radio
================
Command line client for `iHeartRadio <https://www.iheart.com/>`_
|Python 3.6| |license|
This project is meant to be a learning exercise. It is heavily inspired by `pianobar <https://github.com/PromyLOPh/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 <https://anonradio.net/>`_
* Play `internet-radio <https://internet-radio.com/>`_
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 <https://www.videolan.org>`_
Installation/Usage
---------------------
Stable release using pip - `Great read <https://matthew-brett.github.io/pydagogue/installing_scripts.html>`_
.. code::
$ pip install -U iheart-cli
$ iheart --help
Latest code from repository (might contains bugs and incomplete features)
.. code::
$ 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
.. |Python 3.6| image:: https://img.shields.io/badge/python-3.6+-blue.svg
.. |license| image:: https://img.shields.io/github/license/shashfrankenstien/iheart-cli
Raw data
{
"_id": null,
"home_page": "https://github.com/shashfrankenstien/iheart-cli",
"name": "iheart-cli",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Shashank Gopikrishna",
"author_email": "shashank.gopikrishna@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/18/99/e76abacf2da137c17d4a7762d5a9675bee4ddbe5d5038c934c9a1398016a/iheart-cli-0.7.3.tar.gz",
"platform": null,
"description": "iHeart Radio\n================\n\nCommand line client for `iHeartRadio <https://www.iheart.com/>`_\n\n|Python 3.6| |license|\n\n\nThis project is meant to be a learning exercise. It is heavily inspired by `pianobar <https://github.com/PromyLOPh/pianobar>`_ which I love!\n\nThe 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.\n\nFeatures\n---------------------\n\n* Play Live and Artist radio stations\n* Play Song radio stations (Which are essentially Artist stations, but created using song names)\n* Save song urls into local playlists maintained as json files\n\n - Each playlist is saved as a separate json file and can be freely copied between machines\n - Play songs in a playlist sequentially or on shuffle\n\n* Play `aNONradio <https://anonradio.net/>`_\n* Play `internet-radio <https://internet-radio.com/>`_\n\nDependencies\n---------------------\n\nThis project does not implement an audio player. It uses VLC for cross platform audio playback. It can be installed from the `VLC website <https://www.videolan.org>`_\n\n\nInstallation/Usage\n---------------------\n\nStable release using pip - `Great read <https://matthew-brett.github.io/pydagogue/installing_scripts.html>`_\n\n.. code::\n\n $ pip install -U iheart-cli\n $ iheart --help\n\n\nLatest code from repository (might contains bugs and incomplete features)\n\n.. code::\n\n $ git clone https://github.com/shashfrankenstien/iheart-cli.git\n $ cd iHeart-cli\n $ python3 -m iheart --help\n\n\n\nTODO\n---------------------\n\n* Add more / better tests\n* aNONradio and internet-radio are very slow to start (almost 1 minute) - look into vlc documentation\n\n\n.. |Python 3.6| image:: https://img.shields.io/badge/python-3.6+-blue.svg\n.. |license| image:: https://img.shields.io/github/license/shashfrankenstien/iheart-cli\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Command line utility to search and play iHeartRadio",
"version": "0.7.3",
"project_urls": {
"Homepage": "https://github.com/shashfrankenstien/iheart-cli"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ed15d8a075461dc3bde579bd9c97ceb9ea444a881f67ba69250e707a9ab9c96b",
"md5": "1c647c39429b1badf53e5314ad870e4d",
"sha256": "6212e930d7b3f3b16a57a14dfbf5bab758d94e06c967fa33764467ef93055cf9"
},
"downloads": -1,
"filename": "iheart_cli-0.7.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1c647c39429b1badf53e5314ad870e4d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 23876,
"upload_time": "2023-11-26T00:00:23",
"upload_time_iso_8601": "2023-11-26T00:00:23.695453Z",
"url": "https://files.pythonhosted.org/packages/ed/15/d8a075461dc3bde579bd9c97ceb9ea444a881f67ba69250e707a9ab9c96b/iheart_cli-0.7.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1899e76abacf2da137c17d4a7762d5a9675bee4ddbe5d5038c934c9a1398016a",
"md5": "6c0a1421b76bc8820cb4f56ea76fabae",
"sha256": "7b7fa8790d0612dc18b4cc7f4e5d5af73d43b0fb866877f7d5b3637128d100b9"
},
"downloads": -1,
"filename": "iheart-cli-0.7.3.tar.gz",
"has_sig": false,
"md5_digest": "6c0a1421b76bc8820cb4f56ea76fabae",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 21514,
"upload_time": "2023-11-26T00:00:25",
"upload_time_iso_8601": "2023-11-26T00:00:25.366215Z",
"url": "https://files.pythonhosted.org/packages/18/99/e76abacf2da137c17d4a7762d5a9675bee4ddbe5d5038c934c9a1398016a/iheart-cli-0.7.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-26 00:00:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "shashfrankenstien",
"github_project": "iheart-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "python_vlc",
"specs": [
[
">=",
"3.0.12118"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.23.0"
]
]
},
{
"name": "beautifulsoup4",
"specs": [
[
"==",
"4.11.1"
]
]
},
{
"name": "lxml",
"specs": [
[
">=",
"4.8.0"
]
]
}
],
"lcname": "iheart-cli"
}
JSON
