{"id":16151387,"url":"https://github.com/sdushantha/pyradio","last_synced_at":"2026-03-07T14:31:32.306Z","repository":{"id":94758157,"uuid":"135932786","full_name":"sdushantha/pyradio","owner":"sdushantha","description":"📻 Play your favorite radio station from the terminal","archived":false,"fork":false,"pushed_at":"2020-03-04T20:35:04.000Z","size":55,"stargazers_count":76,"open_issues_count":0,"forks_count":8,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-10-07T07:37:38.090Z","etag":null,"topics":["linux","python3","radio","terminal","vlc"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sdushantha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-06-03T19:11:25.000Z","updated_at":"2025-04-13T11:01:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"b40c8f8b-05ac-4765-9730-58b991aa9df1","html_url":"https://github.com/sdushantha/pyradio","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sdushantha/pyradio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Fpyradio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Fpyradio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Fpyradio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Fpyradio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sdushantha","download_url":"https://codeload.github.com/sdushantha/pyradio/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Fpyradio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30217430,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T14:02:48.375Z","status":"ssl_error","status_checked_at":"2026-03-07T14:02:43.192Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux","python3","radio","terminal","vlc"],"created_at":"2024-10-10T00:56:29.049Z","updated_at":"2026-03-07T14:31:32.262Z","avatar_url":"https://github.com/sdushantha.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pyradio\n\u003e Play your favorite radio station from the terminal\n\n## Installation\n```bash\n# clone the repo\n$ git clone https://github.com/sdushantha/pyradio\n\n# change into the new directory\n$ cd pyradio\n\n# install the requirements\n$ pip3 install -r requirements.txt\n```\nThis will clone the repository to your local PC and install the dependencies, `colorama`, `python-vlc`, and `requests`.\nAlso, the [VLC media player](https://www.videolan.org/vlc/) must be installed.\n\n## Usage\n```\n$ python3 pyradio.py -h\nusage: pyradio.py [-h] [-p] [-l] [-d] [-s] station [volume]\n\nPlay your favorite radio station from the terminal\n\npositional arguments:\n  station         name of station to play, checked on TuneIn if unknown\n  volume          playback volume (default: 100)\n\noptional arguments:\n  -h, --help      show this help message and exit\n  -p, --print     print a list of all stations in the local database\n  -l, --local     only use local station database for URL lookup\n  -d, --download  save stream to files instead of playing\n  -s, --split     do not split files saved with --download\n```\n\n### Example\n```bash\n$ python3 pyradio.py \"NRJ\"\n```\n\n## Adding radio stations\n`pyradio.py` will search all unknown radio stations on [TuneIn](https://tunein.com/) and add them to the local database if anything is found.\nAlternatively you also can add a station manually, to do so, add the URL pointing to the stream to the `config.json` file, more specific the `Local Stations` list.\nIf you instead just quickly want to test a new station, just pass the stream URL instead of the station name to `pyradio.py`.\n\nFollow this format:\n```\n\"station name\": \"link_to_stream\"\n```\n\n## Blocking radio stations\n`pyradio.py` can block user-specified titles and replace them with either another radio station or a local music file.\nTo use this feature, add the title or artist name to the `Blocked titles` list in the `config.json` file and set the replacement with `Replace with`.\n\nFollow this format for the blocked title list:\n```\n\"name fragment to block\"\n```\n\nAnd this format for the `Replace with` entry:\n```\n\"Replace with\": \"filename.mp3 or link_to_stream\"\n```\n\n## Downloading radio streams\n`pyradio.py` is capable of downloading a stations stream instead of playing it. To use this function, pass the `-d` option.\nThis will create a folder named after the station and save the stream to multiple files, one for each track.\nThe splitting wont be perfect, because many stations send the track title shortly after the actual track started.\nA list containing information on when a track was played can be found in `titles.txt`.\n\nTo disable the file splitting and instead save everything to a single file, pass the `-s` option.\n\n## License\nMIT License\n\nCopyright (c) 2018 Siddharth Dushantha, TeilzeitTaco\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdushantha%2Fpyradio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsdushantha%2Fpyradio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdushantha%2Fpyradio/lists"}