60 lines
1.8 KiB
Python
60 lines
1.8 KiB
Python
"""Radio Browser: a directory of the community's stations rather than a station.
|
|
|
|
Three hundred of the most-clicked working relays, keyless and public-domain.
|
|
There is no now-playing API, so this catalogue offers breadth, not history: pick
|
|
a station and the stream speaks for itself.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import httpx
|
|
|
|
from ... import config
|
|
from ...models import Song, Station
|
|
from ..base import RadioProvider
|
|
from . import api, fallback
|
|
from . import hero as hero_art
|
|
|
|
__all__ = ["RadioBrowserProvider"]
|
|
|
|
|
|
class RadioBrowserProvider(RadioProvider):
|
|
id = "radiobrowser"
|
|
name = "Radio Browser"
|
|
homepage = "radio-browser.info"
|
|
brand = "RADIO BROWSER"
|
|
tagline = "community directory · 50,000 stations"
|
|
station_source = "radio-browser.info (top 300)"
|
|
history_source = ""
|
|
|
|
hero = hero_art.HERO
|
|
hero_lines = ("RADIO BROWSER", "COMMUNITY DIRECTORY", "KEYLESS · OPEN DATA")
|
|
|
|
# A directory has no show schedule and no Bandcamp worth scraping.
|
|
bandcamp = False
|
|
|
|
@property
|
|
def user_agent(self) -> str:
|
|
return f"{config.USER_AGENT}; +https://www.radio-browser.info"
|
|
|
|
async def fetch_stations(self, client: httpx.AsyncClient) -> list[Station]:
|
|
return await api.fetch_stations(client)
|
|
|
|
def load_cached_stations(self) -> list[Station]:
|
|
return api.load_cached_stations()
|
|
|
|
def fallback_stations(self) -> list[Station]:
|
|
return fallback.fallback_stations()
|
|
|
|
async def fetch_history(
|
|
self, client: httpx.AsyncClient, station_id: str
|
|
) -> list[Song]:
|
|
# Radio Browser publishes no now-playing data at all.
|
|
return []
|
|
|
|
def load_cached_history(self, station_id: str) -> list[Song]:
|
|
return []
|
|
|
|
def fallback_urls(self, station: Station) -> list[str]:
|
|
return [entry["url"] for entry in station.sorted_playlists()]
|