radio.garden-to-m3u/main.py

import os
import requests
import argparse

parser = argparse.ArgumentParser(
                    prog='Radio Garden M3U Generator',
                    description='This script generates a M3U file with stations from Radio Garden.')

parser.add_argument('--country', help='Country name', type=str, required=True)
parser.add_argument('--state', help='State or province name', type=str, required=False)
parser.add_argument('--onlinestream', help='Only include working streams (status 200)', action='store_true')

args = parser.parse_args()

BASE_URL = "https://radio.garden/api"

def get_places():
    
    list = []
    
    data = requests.get(f"{BASE_URL}/ara/content/places").json()['data']['list']
    for place in data:
        list.append([place['country'], # Country
                     place['title'], # City, State or Province
                     place['id']]) # Place ID

    return sorted(list)

def resolve_final_stream_url(rg_proxy_url):
    try:
        # Make a HEAD request to follow redirects but not download stream content
        response_api = requests.get(rg_proxy_url, allow_redirects=True, stream=True, timeout=10)
        response_stream = requests.get(response_api.url, stream=True)

        if args.onlinestream  :
            if response_stream.status_code != 200 :
                return
        return response_stream.url  # This is the final resolved stream URL

    except Exception as e:
        print(f"[ERROR] Couldn't resolve URL for {rg_proxy_url}: {e}")
        return rg_proxy_url  # fallback to original
def get_stations(place_id):
        list = []
        
        data = requests.get(f"{BASE_URL}/ara/content/page/{place_id}/channels").json()['data']['content'][0]['items']
        for station in data:
            list.append([station['page']['title'], # Station Name
                        station['page']['url'].split("/")[-1]]) # Station ID    
        return list
    
def get_stream_url(station_id):
    return f"{BASE_URL}/ara/content/listen/{station_id}/channel.mp3"


def m3u(stations):
    f = open('radio.m3u','a', encoding='utf-8')  

    # if the file is empty, write the header
    if os.path.getsize("radio.m3u") == 0:
        f.write('#EXTM3U\n')

    for station in stations:
        station_name = station[0]
        resolved_url = resolve_final_stream_url(get_stream_url(station[1]))
        f.write(f'#EXTINF:-1 tvg-name="{station_name}", {station_name}\n')
        f.write(f'{resolved_url}\n')
    f.close()

def main():
    open('radio.m3u', 'w').close()
    if not args.state:
        places = get_places()
        for place in places:
            if args.country in place[0]:
                print(place[1])
                stations = get_stations(place[2])
                m3u(stations)
    if args.state:
        places = get_places()
        for place in places:
            if args.state in place[1]:
                print(place[1])
                stations = get_stations(place[2])
                m3u(stations)

if __name__ == "__main__":
    main()