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 SHOUTcast o Icecast, nombre, puerto y contraseña.
Inicia el servidor
Pulsa "Iniciar" en tu stream. El servidor se enciende en segundos.
Conecta tu encoder
Abre BUTT, OBS o tu encoder favorito. Introduce los datos de conexion.
Comparte tu radio
Copia la URL del stream y compártela. Usa nuestros widgets para tu web.
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:
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
- ✓ Si usas SHOUTcast, cambia el tipo a Shoutcast y deja el mount vacio
- ✓ 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
- Tu plan debe incluir AutoDJ (Basico o superior)
- 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 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