Documentacion
Guias paso a paso para configurar tu emisora, conectar encoders, usar widgets y sacar el maximo partido a StreamPanel Cloud.
Inicio rapido
Crea tu stream
Ve a Streams > Nuevo Stream. Elige cómo vas a emitir: AutoDJ (automatico 24/7) o Manual (BUTT/OBS/Mixxx).
Inicia el servidor
Pulsa "Iniciar" en tu stream. El servidor se enciende en segundos.
Sube música o conecta
Si elegiste AutoDJ, sube tus archivos. Si elegiste Manual, conecta tu encoder con los datos del panel.
Comparte tu radio
Copia la URL del stream y compártela. Usa nuestros widgets para tu web.
¿Qué elijo al crear mi stream?
Dos preguntas sencillas antes de crear tu radio.
1. ¿Cómo vas a emitir?
AutoDJ (24/7 automático)
Subes tu música una vez y StreamPanel la emite solo, sin que tú estés delante. Ideal para radios que suenan siempre.
Lo que necesitas: solo tus archivos de música.
Manual (en vivo desde tu PC)
Usas un encoder externo (BUTT, OBS, Mixxx, Virtual DJ...) para emitir desde tu ordenador. Ideal para DJs y programas en directo.
Lo que necesitas: tu encoder instalado y los datos del panel.
¿Se pueden combinar? Sí. Cuando elijas AutoDJ, también puedes conectar un DJ en vivo con el Live DJ Harbor (Plan Profesional) — el AutoDJ se pausa automáticamente mientras el DJ emite y retoma cuando desconecta.
2. ¿SHOUTcast o Icecast? (solo modo Manual)
Si elegiste Manual, el panel te deja escoger entre los dos protocolos más usados. Si elegiste AutoDJ, configuramos Icecast automáticamente (es el que funciona limpio con AutoDJ).
| Icecast RECOMENDADO | SHOUTcast | |
|---|---|---|
| Estándar moderno | ✅ | Más antiguo |
| SSL nativo | ✅ | ✅ (con limitaciones) |
| Metadatos y carátulas | ✅ Nativo | ✅ Via ICY |
| Múltiples mountpoints | ✅ | 1 por stream |
| Compatible con AutoDJ | ✅ Siempre | ❌ No |
| Reproductores antiguos (coches, móviles pre-2012) | Depende | ✅ |
En resumen: elige Icecast (es lo más moderno y funciona con todo). Elige SHOUTcast solo si tus oyentes actuales ya tienen URLs de SHOUTcast guardadas o si usas reproductores antiguos que no soportan Icecast.
Conectar con BUTT
BUTT (Broadcast Using This Tool) es un encoder gratuito para Windows, Mac y Linux. Ideal para emitir en directo.
1. Descarga BUTT
Descargalo gratis desde https://danielnoethen.de/butt/
2. Configura el servidor
Abre BUTT > Settings > Main > Server > Add:
Importante: Selecciona siempre IceCast como tipo, aunque tu servidor sea SHOUTcast. Esto asegura que el puerto no cambie automaticamente.
3. Configura el audio
Settings > Audio:
4. Emitir
Pulsa el boton Play en BUTT. Si la conexion es correcta, veras el tiempo corriendo y el estado "connected".
Conectar con OBS Studio
OBS Studio puede emitir audio a tu servidor SHOUTcast/Icecast usando el plugin obs-shoutcast o configuracion personalizada.
1. Instala el plugin
Descarga el plugin obs-shoutcast desde GitHub e instalalo en OBS.
2. Configura la emision
En OBS > Settings > Stream:
Alternativa sin plugin: Usa BUTT en paralelo con OBS. OBS captura y mezcla el audio, BUTT lo envia al servidor. Configura BUTT para capturar la salida de audio del sistema (Virtual Audio Cable o similar).
AutoDJ (Emision automatica 24/7)
AutoDJ usa Liquidsoap para reproducir tu musica automaticamente sin necesidad de un encoder externo.
1. Sube tu musica
Ve a AutoDJ > Mis Archivos. Sube archivos MP3, OGG, FLAC, AAC, WAV u OPUS. Formatos recomendados: MP3 a 128-320 kbps.
2. Configura las opciones
En AutoDJ > Configuracion puedes ajustar:
- Modo playlist: Aleatorio o secuencial
- Crossfade: Transicion suave entre canciones (en segundos)
- Jingles: Intercalar cuñas cada N canciones
3. Arranca el AutoDJ
Pulsa "Arrancar AutoDJ" y tu radio emitira 24/7 sin interrupcion. Si conectas un encoder en directo (BUTT/OBS), el AutoDJ se pausa automaticamente y retoma cuando desconectes.
Dominio propio con SSL
Emite desde tu propio dominio con certificado SSL gratuito. Disponible desde el Plan Basico.
1. Configura tu DNS
En tu proveedor de dominio, crea un registro DNS tipo A:
2. Espera la propagacion
Los cambios DNS tardan entre 5 y 30 minutos en propagarse. Puedes verificar con ping radio.tudominio.com
3. Configura en StreamPanel
Al crear o editar tu stream, selecciona "Usar mi propio dominio" e introduce radio.tudominio.com. Marca "SSL automatico" y el certificado se genera al instante.
Resultado
Tu stream estara disponible en https://radio.tudominio.com/8020/stream con HTTPS seguro y renovacion automatica del certificado.
Widgets para tu web
Inserta un reproductor en tu pagina web con una sola linea de codigo HTML.
Widget completo (reproductor + caratula + historial)
Copia este codigo en tu web:
Widget mini (solo reproductor)
Widget flotante
Un reproductor fijo en la esquina inferior de tu web:
Tu ID: Encontraras tu custom_id en la pagina de tu stream, debajo de la URL. Normalmente es algo como 8020 o mi-radio.
Conectar Mixxx
Mixxx es un software de DJ gratuito y open source que permite mezclar musica en directo y emitir directamente a tu stream.
Configuracion paso a paso
- Descarga Mixxx gratis desde mixxx.org
- Abre Mixxx → Preferencias → Emision en directo
- Activa la emision y configura:
Tipo: Icecast2
Host: tu-dominio.com
Puerto: (puerto de tu stream)
Mount: /stream
Login: source
Password: (contrasena del stream) - En formato de codificacion, selecciona MP3 y el bitrate deseado (128 kbps recomendado)
- Pulsa Aceptar y luego el boton de emision en la interfaz principal
Consejos
- ✓ Usa MP3 128 kbps para mejor compatibilidad
- ✓ Usa siempre tipo IceCast en el encoder, aunque tu servidor sea SHOUTcast
- ✓ Mixxx envia automaticamente los metadatos (artista y titulo) al stream
- ✓ Compatible con Windows, macOS y Linux
- ! Si tienes AutoDJ activo con Live DJ, Mixxx puede conectar al puerto harbor y el AutoDJ se pausara automaticamente
Live DJ Takeover Plan Pro+
Permite que un DJ conecte en directo y tome el control del stream. El AutoDJ se pausa automaticamente mientras el DJ emite, y retoma la musica cuando desconecta.
Como activarlo
- Ve a AutoDJ → selecciona tu stream → Settings
- Activa "Live DJ takeover" al final de la pagina
- Elige un puerto harbor (sugerido: puerto del stream + 100)
- Guarda la configuracion
- Arranca el AutoDJ (debe estar emitiendo para que el DJ pueda conectar)
Datos para el DJ
Los datos de conexion aparecen al activar Live DJ en settings:
Puerto: (puerto harbor)
Mount: /stream
Password: (contrasena del stream)
Como funciona
Caratulas de album
StreamPanel muestra automaticamente la caratula de la cancion que suena. Tambien puedes subir tus propias imagenes.
Como funcionan
- 1. Cuando suena una cancion, StreamPanel busca la caratula automaticamente
- 2. Primero busca en tus imagenes privadas (subidas por ti)
- 3. Luego en el catalogo compartido (~3000 caratulas)
- 4. Si no la encuentra, la descarga de Last.fm o iTunes
- 5. La caratula se inyecta en los metadatos ICY para que los reproductores la muestren
Subir caratulas propias
- Ve a Caratulas en el menu
- Pulsa "Subir caratula"
- Selecciona una imagen JPG o PNG (max 2 MB)
- Introduce el nombre del artista y titulo de la cancion
- La caratula se usara automaticamente cuando suene esa cancion
Formatos: JPG, PNG. Tamano recomendado: 600x600 px.
Estadisticas
Que puedes ver
- Oyentes en tiempo real — cuantas personas estan escuchando ahora mismo
- Historico de conexiones — registro de cada sesion de escucha con duracion
- Top canciones — las canciones mas escuchadas de tu stream
- Top paises — de donde te escuchan (Plan Basico+)
- Mapa interactivo — visualiza tus oyentes en un mapa mundial (Plan Pro+)
- Heatmap semanal — descubre a que horas y dias tienes mas audiencia (Plan Pro+)
Exportar datos
- CSV — exporta el historial de conexiones a Excel o Google Sheets
- PDF — genera un informe visual para imprimir o compartir
Los datos de geolocalizacion (pais, ciudad) solo se incluyen en los exports de los planes Profesional y Empresarial.
Como acceder
Ve a Estadisticas en el menu, o pulsa el icono de grafico en cualquier stream del dashboard.
API Publica Plan Pro+
Integra los datos de tu stream en tu web o app con nuestra API REST publica.
Endpoints disponibles
GET /api/player/{custom_id}
Devuelve JSON con: titulo, artista, oyentes, URL del stream, caratula
GET /api/cover/{custom_id}
Redirect 302 a la imagen de la caratula actual
GET /cp/get_info.php?p={puerto}
JSON compatible con SonicPanel y pro.radio (titulo, artista, historial)
Ejemplo rapido
.then(r => r.json())
.then(data => {
console.log(data.artist);
console.log(data.title);
console.log(data.cover_url);
});
Rate limit: 120 peticiones/minuto por IP. Sin autenticacion requerida.
Documentacion completa: Ver API Docs
Planes y facturacion
Planes disponibles
Todos los planes incluyen SSL, HTTPS y soporte tecnico. Ver comparativa completa
Preguntas sobre facturacion
Como cambio de plan?
Puedo cancelar cuando quiera?
Que metodos de pago aceptais?
Que pasa con mis streams si bajo de plan?
Solucion de problemas
Mi encoder no conecta al stream
- El stream esta iniciado (boton verde en el dashboard)
- Host, puerto y contrasena son correctos
- Usas el protocolo correcto: Icecast para Icecast, SHOUTcast v1 para SHOUTcast
- El mount point es /stream (para Icecast)
- Tu firewall local no bloquea la conexion saliente
Se oye el stream pero no se ven metadatos (titulo/artista)
El AutoDJ no arranca
- AutoDJ está incluido en todos los planes (incluido el gratuito)
- Debes tener al menos 1 playlist con canciones
- La playlist debe estar activada en el stream
- El stream debe estar iniciado antes de arrancar el AutoDJ
No se ve la caratula en el reproductor
Error al crear un stream: "puerto en uso"
No puedo acceder a una funcion (AutoDJ, Widgets, API...)
El dominio personalizado no funciona
- Has creado un registro A en tu DNS apuntando a 159.195.51.234
- El DNS puede tardar hasta 24h en propagarse
- Tu plan incluye dominio personalizado (Basico o superior)
El Live DJ no puede conectar al puerto harbor
- El AutoDJ debe estar arrancado (Live DJ solo funciona cuando el AutoDJ emite)
- El encoder del DJ usa protocolo Icecast apuntando al puerto harbor, no al puerto del stream
- El puerto harbor esta en el rango 8100-8999
- Tu plan es Profesional o superior
Preguntas frecuentes
Necesito conocimientos tecnicos?
Que diferencia hay entre SHOUTcast e Icecast?
Puedo usar AutoDJ con SHOUTcast?
Puedo cambiar de SHOUTcast a Icecast despues?
Que pasa si mi encoder se desconecta?
Cuantos oyentes puedo tener?
El SSL es gratuito?
Puedo usar mi dominio propio?
Como veo las estadisticas?
Tienes mas preguntas? Contacta con nosotros en soporte@streampanel.online