Documentación
Guías paso a paso para configurar tu emisora, conectar encoders, usar widgets y sacar el máximo partido a StreamPanel Cloud.
Inicio rápido
Crea tu stream
Ve a Streams > Nuevo Stream. Elige cómo vas a emitir: AutoDJ (automático 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.
¿Dónde están mis datos de conexión?
Para conectar cualquier encoder (BUTT, OBS, Mixxx, BroadcastingMyself...) necesitas el servidor, puerto, contraseña y mount point de tu stream. Los tienes en el panel:
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
Descárgalo 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 automáticamente.
3. Configura el audio
Settings > Audio:
4. Emitir
Pulsa el botón Play en BUTT. Si la conexión es correcta, verás 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 configuración personalizada.
1. Instala el plugin
Descarga el plugin obs-shoutcast desde GitHub e instálalo en OBS.
2. Configura la emisión
En OBS > Settings > Stream:
Alternativa sin plugin: Usa BUTT en paralelo con OBS. OBS captura y mezcla el audio, BUTT lo envía al servidor. Configura BUTT para capturar la salida de audio del sistema (Virtual Audio Cable o similar).
AutoDJ (Emisión automática 24/7)
AutoDJ usa Liquidsoap para reproducir tu música automáticamente sin necesidad de un encoder externo.
1. Sube tu música
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 > Configuración puedes ajustar:
- Modo playlist: Aleatorio o secuencial
- Crossfade: Transición suave entre canciones (en segundos)
- Jingles: Intercalar cuñas cada N canciones
3. Arranca el AutoDJ
Pulsa "Arrancar AutoDJ" y tu radio emitirá 24/7 sin interrupción. Si conectas un encoder en directo (BUTT/OBS), el AutoDJ se pausa automáticamente y retoma cuando desconectes.
Dominio propio con SSL
Emite desde tu propio dominio con certificado SSL gratuito. Disponible desde el Plan Básico.
1. Configura tu DNS
En tu proveedor de dominio, crea un registro DNS tipo A:
2. Espera la propagación
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 automático" y el certificado se genera al instante.
Resultado
Tu stream estará disponible en https://radio.tudominio.com/8020/stream con HTTPS seguro y renovación automática del certificado.
Widgets para tu web
Inserta un reproductor en tu página web con una sola línea de código HTML.
Widget completo (reproductor + carátula + historial)
Copia este código en tu web:
Widget mini (solo reproductor)
Widget flotante
Un reproductor fijo en la esquina inferior de tu web:
Tu ID: Encontrarás tu custom_id en la página 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 música en directo y emitir directamente a tu stream.
Configuración paso a paso
- Descarga Mixxx gratis desde mixxx.org
- Abre Mixxx → Preferencias → Emisión en directo
- Activa la emisión y configura:
Tipo: Icecast2
Host: tu-dominio.com
Puerto: (puerto de tu stream)
Mount: /stream
Login: source
Password: (contraseña del stream) - En formato de codificación, selecciona MP3 y el bitrate deseado (128 kbps recomendado)
- Pulsa Aceptar y luego el botón de emisión 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 envía automáticamente los metadatos (artista y título) 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 pausará automáticamente
Conectar con BroadcastingMyself Compatible ✓
BroadcastingMyself es un encoder web — emites directamente desde el navegador sin instalar nada. Compatible con StreamPanel (Icecast).
1. Accede a BroadcastingMyself
Ve a broadcastingmyself.com e inicia sesión o crea una cuenta gratuita.
2. Crea una emisora
En tu panel de BroadcastingMyself, crea una nueva emisora y elige "Servidor externo / Icecast". Introduce los datos de tu stream:
3. Emitir
Pulsa "Conectar" o "Ir al aire". BroadcastingMyself capturará el micrófono de tu navegador y lo enviará en directo a tu stream de StreamPanel.
Ventajas e inconvenientes
¿Otros encoders web?
Cualquier encoder que soporte Icecast funciona con StreamPanel. Otros ejemplos compatibles:
- • RadioBoss Cloud — encoder profesional online
- • Airtime / LibreTime — automatización avanzada
- • VirtualDJ — con el plugin de broadcast Icecast
- • SAM Broadcaster — encoder profesional de escritorio
Live DJ Takeover Plan Pro+
Permite que un DJ conecte en directo y tome el control del stream. El AutoDJ se pausa automáticamente mientras el DJ emite, y retoma la música cuando desconecta.
Cómo activarlo
- Ve a AutoDJ → selecciona tu stream → Settings
- Activa "Live DJ takeover" al final de la página
- Elige un puerto harbor (sugerido: puerto del stream + 100)
- Guarda la configuración
- Arranca el AutoDJ (debe estar emitiendo para que el DJ pueda conectar)
Datos para el DJ
Los datos de conexión aparecen al activar Live DJ en settings:
Puerto: (puerto harbor)
Mount: /stream
Password: (contraseña del stream)
Cómo funciona
Carátulas de álbum
StreamPanel muestra automáticamente la carátula de la canción que suena. También puedes subir tus propias imágenes.
Cómo funcionan
- 1. Cuando suena una canción, StreamPanel busca la carátula automáticamente
- 2. Primero busca en tus imágenes privadas (subidas por ti)
- 3. Luego en el catálogo compartido (~3000 carátulas)
- 4. Si no la encuentra, la descarga de Last.fm o iTunes
- 5. La carátula se inyecta en los metadatos ICY para que los reproductores la muestren
Subir carátulas propias
- Ve a Carátulas en el menú
- Pulsa "Subir carátula"
- Selecciona una imagen JPG o PNG (máx. 2 MB)
- Introduce el nombre del artista y título de la canción
- La carátula se usará automáticamente cuando suene esa canción
Formatos: JPG, PNG. Tamaño recomendado: 600x600 px.
Estadísticas
Qué puedes ver
- Oyentes en tiempo real — cuántas personas están escuchando ahora mismo
- Historico de conexiones — registro de cada sesion de escucha con duracion
- Top canciones — las canciones mas escuchadas de tu stream
- Top países — de dónde te escuchan (Plan Pro+)
- Mapa interactivo — visualiza tus oyentes en un mapa mundial (Plan Pro+)
- Heatmap semanal — descubre a qué horas y días tienes más 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 geolocalización (país, ciudad) solo se incluyen en los exports de los planes Profesional y Empresarial.
Cómo acceder
Ve a Estadísticas en el menú, o pulsa el ícono de gráfico en cualquier stream del dashboard.
API Pública Plan Básico+
Integra los datos de tu stream en tu web o app con nuestra API REST pública.
Endpoints disponibles
GET /api/player/{custom_id}
Devuelve JSON con: título, artista, oyentes, URL del stream, carátula
GET /api/cover/{custom_id}
Redirect 302 a la imagen de la carátula actual
GET /cp/get_info.php?p={puerto}
JSON compatible con SonicPanel y pro.radio (titulo, artista, historial)
Ejemplo rápido
.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 autenticación requerida.
Documentación completa: Ver API Docs
Planes y facturación
Planes disponibles
Todos los planes incluyen SSL, HTTPS y soporte técnico. Ver comparativa completa
Preguntas sobre facturación
¿Cómo cambio de plan?
¿Puedo cancelar cuando quiera?
¿Qué métodos de pago aceptáis?
¿Qué pasa con mis streams si bajo de plan?
Solución de problemas
¿Dónde encuentro el servidor, puerto y contraseña para configurar mi encoder?
streampanel.online), puerto (ej. 8020), contraseña y mount point (/stream). También puedes verlo al editar tu stream.Mi encoder no conecta al stream
- El stream esta iniciado (boton verde en el dashboard) — si no esta iniciado, el encoder no puede conectar
- Host: streampanel.online (sin http://, sin barra al final)
- Puerto: el número exacto de tu stream (lo ves en el dashboard)
- Contraseña: sin espacios, distingue mayúsculas
- Mount point: /stream (con la barra delante, sin nada más)
- Protocolo: selecciona siempre Icecast / IceCast2 en tu encoder
- 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 función (dominio propio, GeoIP, Live DJ...)
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 técnicos?
¿Es compatible con BroadcastingMyself?
¿Qué pongo en el campo "Mount point" o "Punto de montaje"?
¿Qué usuario pongo en el encoder?
¿Qué diferencia hay entre SHOUTcast e Icecast?
¿Puedo usar AutoDJ con SHOUTcast?
¿Puedo cambiar de SHOUTcast a Icecast después?
¿Qué pasa si mi encoder se desconecta?
¿Cuántos oyentes puedo tener?
¿El SSL es gratuito?
¿Puedo usar mi dominio propio?
¿Cómo veo las estadísticas?
¿Tienes más preguntas? Contacta con nosotros en soporte@streampanel.online