Radio Argentina

Escuchar ~1200 radios argentinas desde la terminal, o desde el navegador sin instalar nada.

Player web: mammoli.ar/radio — funciona en celular, buscador en tiempo real, filtros por estado y género, ICY now-playing, encuestas, compartir por link/WhatsApp/QR, descarga M3U.

Terminal — radio.sh

Uso básico

./radio.sh <búsqueda> [reproductor]

búsqueda puede ser parte del nombre, frecuencia, provincia o cualquier texto que aparezca en el nombre de la emisora.

./radio.sh mendoza          # busca "mendoza" en el nombre
./radio.sh "99.1"           # por frecuencia
./radio.sh "cadena 3"       # nombre completo o parcial
./radio.sh nacional         # cualquier palabra del nombre

Reproductores

Parámetro	Reproductor
(omitido)	mplayer
`m`	mplayer explícito
`v`	VLC headless (`cvlc`)
`p`	mpv

./radio.sh "cadena 3"       # mplayer (default)
./radio.sh "cadena 3" v     # VLC
./radio.sh "cadena 3" p     # mpv

Alias recomendado

# ~/.bashrc o ~/.zshrc
alias radio='~/Scripts/radio/radio.sh'

radio2.sh — CLI con API v2

radio2.sh consume la API REST y muestra oyentes en tiempo real e ICY now-playing:

./radio2.sh mendoza         # busca y reproduce
./radio2.sh "cadena 3" v    # mismos parámetros que radio.sh

Requisitos CLI

sudo apt install mplayer   # recomendado
sudo apt install vlc
sudo apt install mpv

Player web — mammoli.ar/radio

Accesible desde cualquier navegador sin instalar nada.

Buscador en tiempo real (nombre, provincia, género)
Filtros: Activas / Dudosas / Caídas / Más escuchadas
Filtros de género: música, noticias, pop, rock, etc.
ICY now-playing en tiempo real (título de canción/programa)
Badge de codec y bitrate (AAC 128k, MP3 64k, etc.)
Contador de oyentes en tiempo real
Compartir por link, WhatsApp o QR
Abrir stream en VLC desde el browser
Encuesta de satisfacción (👍 / 😐 / 👎)
PWA: instalable en celular, funciona offline
Dark/light mode

Parámetros de URL

# Filtro de género al abrir
mammoli.ar/radio/?genero=noticias
mammoli.ar/radio/?genero=pop

# Filtro de estado
mammoli.ar/radio/?estado=ok       # solo activas
mammoli.ar/radio/?estado=all      # todas

# Combinar
mammoli.ar/radio/?genero=noticias&estado=ok

# Descargar playlist M3U (para VLC, apps IPTV, etc.)
mammoli.ar/radio/?m3u=1
mammoli.ar/radio/api/playlist.m3u

# Buscar server-side (útil para scripts)
mammoli.ar/radio/?buscar=cadena+3

# Página de emisora individual
mammoli.ar/radio/{slug}/

Arquitectura (v2)

web/
├── index.php          ← router (35 líneas)
├── admin.php          ← panel de administración (auth requerida)
├── sitemap.php        ← sitemap dinámico desde SQLite
├── api/
│   ├── stations.php   ← GET /api/stations[?slug=]
│   ├── playlist.php   ← GET /api/playlist.m3u
│   ├── listeners.php  ← ping/stop/count/top
│   ├── nowplaying.php ← ICY metadata
│   ├── survey.php     ← POST rating + location
│   ├── suggest.php    ← POST sugerencia de emisora
│   └── share.php      ← notificación de compartir
├── pages/
│   ├── listing.php    ← directorio principal
│   └── station.php    ← página individual (SEO, JSON-LD)
├── components/
│   └── head.php       ← <head> compartido
└── assets/
    ├── player.js      ← RadioPlayer() — estados idle/connecting/playing/buffering/error
    ├── player.css     ← estilos del player
    ├── theme.js       ← dark/light toggle
    └── style.css      ← CSS global

crawlers/
├── check_streams_v2.py  ← verifica streams (30 workers paralelos), detecta cambios
├── enrich_v2.py         ← enriquece con Radio Browser API (logo, codec, bitrate)
├── hunt_stations_v2.py  ← descubre emisoras nuevas
└── icy_refresh.php      ← refresca ICY titles (cURL Multi, 20 concurrentes, cron 10min)

db/
└── radio_v2.sqlite    ← base de datos (gitignoreada)

Base de datos

SQLite con 9 tablas + 2 vistas:

Tabla	Contenido
`stations`	directorio de emisoras (~1200)
`stream_status`	estado actual por emisora
`stream_history`	historial de verificaciones
`station_events`	eventos: came_back, went_down, icy_gained, icy_lost
`icy_cache`	título ICY actual por emisora
`plays`	historial de reproducciones
`listeners`	oyentes activos (TTL 90s)
`surveys`	calificaciones de usuarios
`crawler_runs`	log de ejecuciones de crawlers

Vistas: v_stations (join completo), v_active_listeners.

Crawlers

check_streams_v2.py — verificación periódica de URLs

Verifica todas las emisoras en paralelo (30 workers). Detecta cambios y genera eventos:

python3 crawlers/check_streams_v2.py            # verificar sin notificar
python3 crawlers/check_streams_v2.py --notify   # notifica cambios por Telegram
python3 crawlers/check_streams_v2.py --icy      # también refresca ICY titles
python3 crawlers/check_streams_v2.py --workers 40

Corre automáticamente cada 6hs via GitHub Actions (check-streams-v2.yml).

enrich_v2.py — enriquecimiento de metadatos

Actualiza logo, tags, codec, bitrate y votos desde Radio Browser API:

python3 crawlers/enrich_v2.py

Corre automáticamente los días 1 y 15 de cada mes via GitHub Actions (enrich-v2.yml).

hunt_stations_v2.py — descubrimiento de emisoras

Busca emisoras argentinas nuevas en Radio Browser y las inserta con approved=0 para revisión:

python3 crawlers/hunt_stations_v2.py

icy_refresh.php — ICY now-playing en tiempo real

Script PHP para cPanel cron. Barre todas las emisoras con icy_supported=1 usando cURL Multi (20 conexiones concurrentes) y actualiza icy_cache. Corre cada 10 minutos.

GitHub Actions

Workflow	Frecuencia	Qué hace
`check-streams-v2.yml`	cada 6hs	verifica streams, notifica cambios por Telegram
`enrich-v2.yml`	días 1 y 15	enriquece metadatos desde Radio Browser
`gist-sync.yml`	cada lunes	exporta el directorio completo al gist público

Los workflows se activan desde master (default branch). Descargan la DB por FTP, corren el crawler, y suben la DB actualizada.

Configuración (`config.php`)

Copiar config.example.php como config.php y completar:

define('RADIO_ADMIN_KEY', '...');   // clave interna de API
define('ADMIN_USER', 'admin');       // usuario del panel /admin.php
define('ADMIN_PASS', '...');         // contraseña del panel
define('TG_TOKEN',  '...');          // token del bot de Telegram
define('TG_CHAT_ID', '...');         // chat donde notificar
define('NOTIFY_OYENTES', false);     // true = notificar nuevos oyentes
define('GA_ID', '');                 // Google Analytics 4 (vacío = desactivado)
// Opcional:
define('RADIO_DB', '/ruta/a/radio_v2.sqlite');
define('RADIO_BASE', '/radio');      // prefijo URL (para staging en subpath)

Panel de administración

Accesible en /radio/admin.php con usuario y contraseña (configurados en config.php).

Secciones: resumen de estadísticas, encuestas con resultado por estación, sugerencias de nuevas emisoras (aprobar/rechazar), ICY titles activos con indicador de frescura, log de crawlers.

Versiones

Un solo branch (master = producción). Las versiones se marcan con tags:

Tag	Descripción
`v1-final`	último estado de v1 antes del cutover a v2 (2026-06-25)
HEAD	v2 activa en mammoli.ar/radio/

Directorio como gist

El listado completo de emisoras está disponible públicamente en formato TSV (URL, nombre, provincia):

gist.github.com/camammoli/21ce6e3ba07486bcd16a28cda967f0d9

Es un fork del gist original de pisculichi. Se actualiza automáticamente cada lunes via gist-sync.yml exportando directamente desde la base de datos V2. Para actualizar manualmente:

python3 gist_sync.py --dry-run   # previsualizar sin enviar
python3 gist_sync.py             # actualizar (requiere GITHUB_TOKEN con scope gist)

Licencia

MIT License — Carlos Ariel Mammoli (LU2MCA), Mendoza, Argentina

Name		Name	Last commit message	Last commit date
Latest commit History 198 Commits
.github/workflows		.github/workflows
crawlers		crawlers
db		db
docs		docs
web		web
.gitignore		.gitignore
LEGAL.md		LEGAL.md
LICENSE		LICENSE
NOTAS_DESARROLLO.md		NOTAS_DESARROLLO.md
README.md		README.md
crawler_radio_browser.py		crawler_radio_browser.py
dedup_emisoras.py		dedup_emisoras.py
dedup_urls.py		dedup_urls.py
emisoras.json		emisoras.json
emisoras.txt		emisoras.txt
enrich.py		enrich.py
gist_sync.py		gist_sync.py
hunt_stations.py		hunt_stations.py
radio.sh		radio.sh
radio2.sh		radio2.sh
recuperar_caidas.py		recuperar_caidas.py
track_since.py		track_since.py
verificar_urls.sh		verificar_urls.sh

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Radio Argentina

Terminal — radio.sh

Uso básico

Reproductores

Alias recomendado

radio2.sh — CLI con API v2

Requisitos CLI

Player web — mammoli.ar/radio

Parámetros de URL

Arquitectura (v2)

Base de datos

Crawlers

check_streams_v2.py — verificación periódica de URLs

enrich_v2.py — enriquecimiento de metadatos

hunt_stations_v2.py — descubrimiento de emisoras

icy_refresh.php — ICY now-playing en tiempo real

GitHub Actions

Configuración (`config.php`)

Panel de administración

Versiones

Directorio como gist

Licencia

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

Radio Argentina

Terminal — radio.sh

Uso básico

Reproductores

Alias recomendado

radio2.sh — CLI con API v2

Requisitos CLI

Player web — mammoli.ar/radio

Parámetros de URL

Arquitectura (v2)

Base de datos

Crawlers

check_streams_v2.py — verificación periódica de URLs

enrich_v2.py — enriquecimiento de metadatos

hunt_stations_v2.py — descubrimiento de emisoras

icy_refresh.php — ICY now-playing en tiempo real

GitHub Actions

Configuración (config.php)

Panel de administración

Versiones

Directorio como gist

Licencia

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Configuración (`config.php`)