Wiki y Manual de Usuario

Aprende a configurar, operar y personalizar BibleStream Studio para tus transmisiones en vivo con OBS Studio.

1. Introducción

BibleStream Studio es un software open source diseñado específicamente para iglesias, ministerios y creadores que transmiten en vivo utilizando OBS Studio (versiones 28, 29, 30 o superiores).

El plugin se compone de dos elementos que se comunican automáticamente en tiempo real mediante la tecnología nativa BroadcastChannel:

  • Panel de Control (Dock - index.html): Una ventana flotante integrada dentro de OBS Studio donde el operador busca versículos, navega y controla qué sale al aire.
  • Capa de Transmisión (Browser Source - verso.html): Una superposición transparente en alta definición (1080p) que se agrega sobre las cámaras o escenas de tu stream.

2. Guía de Instalación en OBS Studio

A. Configuración del Panel de Control (Custom Browser Dock)

  1. Abre OBS Studio en tu computadora.
  2. En la barra de menús superior, ve a Docks (Paneles) Custom Browser Docks (Paneles de navegador personalizados).
  3. En la tabla que aparece, escribe:
    • Nombre del panel: BibleStream Studio
    • URL: La ruta absoluta hacia tu archivo index.html (ejemplo: file:///Users/tu-usuario/Documents/Bible-obs-plugin/index.html).
  4. Haz clic en Aplicar. Se abrirá la ventana del buscador.
  5. Arrástrala con el cursor hacia cualquier lateral o parte inferior de la interfaz de OBS para acoplarla limpiamente.

B. Configuración de la Superposición (Browser Source)

  1. Ve a la Escena donde quieras mostrar los versículos (ej: Cámara Pastor o Predicación).
  2. En el panel de Fuentes (Sources), presiona el botón + Navegador (Browser Source).
  3. Nómbralo Biblia Overlay.
  4. Marca la casilla Archivo Local (Local File) y selecciona el archivo verso.html.
  5. Establece los siguientes valores:
    • Ancho (Width): 1920
    • Alto (Height): 1080
    • CSS Personalizado: Déjalo vacío o por defecto (el fondo es 100% transparente).
  6. Haz clic en Aceptar. ¡Ya está listo para transmitir!

3. Manual de Operación en Vivo

Durante el servicio o transmisión, el operador no necesita tocar el mouse para tareas complejas:

  • Búsqueda directa: Escribe la cita en la barra de búsqueda y presiona Enter.
  • Indicador de Estado EN EL AIRE:
    • EN VIVO: [Cita] con indicador verde pulsante indica que el versículo está siendo visto por la audiencia en el stream.
    • OCULTO indica que la pantalla está limpia.
  • Botón de Pánico (Ocultar Pantalla): Si el predicador termina la lectura bíblica o cambia de tema de imprevisto, presiona Esc o haz clic en OCULTAR PANTALLA para limpiar el stream de forma suave e inmediata.

4. Versiones Bíblicas Disponibles (100% Offline)

BibleStream Studio integra 6 de las traducciones bíblicas más leídas y confiables en el idioma español. Cada una está completamente precargada de forma local en tu equipo, garantizando que el operador pueda cambiar de versión al instante durante la predicación desde el selector del Dock sin demoras ni caídas por falta de internet.

Acrónimo Nombre Completo Tipo de Traducción Uso Recomendado
RV1960 Reina-Valera 1960 Formal / Clásica La versión por excelencia del pueblo hispano. Belleza lírica, liturgia y memorización congregacional.
NVI Nueva Versión Internacional Equivalencia Dinámica Óptima Sermones modernos, excelente balance filológico y lenguaje actual comprensible.
LBLA La Biblia de las Américas Formal Literal Rigurosa Estudios bíblicos profundos, precisión textual extrema y predicación expositiva verso a verso.
NTV Nueva Traducción Viviente Dinámica Contemporánea Claridad impactante, lectura ágil en stream y frescura para transmitir el mensaje vivo.
TLA Traducción en Lenguaje Actual Pedagógica / Sencilla Ministerios infantiles, jóvenes, familias y personas que inician en la fe cristiana.
DHH Dios Habla Hoy Español Estándar Latinoamericano Lectura comunitaria accesible y estilo directo de las Sociedades Bíblicas Unidas.
Arquitectura de Carga Ligera (Lazy Loading):
BibleStream Studio inicia con RV1960 precargada por defecto (~7 MB). Las otras versiones solo se cargan en memoria si el operador las selecciona en el selector, ahorrándole a OBS Studio más de 40 MB de memoria RAM durante tus transmisiones.

5. Tabla de Abreviaturas Bíblicas

El motor inteligente de BibleStream Studio reconoce abreviaturas canónicas en español para que no tengas que escribir el nombre completo del libro:

Ejemplo Abreviaturas Reconocidas Libro Detectado
Jn 3:16 jn, jua, juan Juan
Gn 1:1 gn, gen, genesis Génesis
Sal 23 sal, salmo, salmos, ps Salmos
1 Co 13:4-8 1co, 1cor, 1 corintios 1 Corintios
Rom 8:28 ro, rom, romanos Romanos
Ap 21:4 ap, apo, apoc, apocalipsis Apocalipsis
Mt 5:3-12 mt, mat, mateo Mateo
Ex 20:1 ex, exo, exodo Éxodo

6. Atajos de Teclado en Vivo

Tecla Acción
→ (Flecha Derecha) Avanzar al siguiente versículo y proyectarlo de inmediato.
← (Flecha Izquierda) Retroceder al versículo anterior y proyectarlo de inmediato.
Espacio Alternar entre Mostrar en pantalla u Ocultar el versículo seleccionado.
Esc Ocultar pantalla inmediatamente (Blackout de emergencia).
Enter Ejecutar la búsqueda de la referencia escrita en el campo de texto.

7. Personalización de Fondos y Temas

Haz clic en el botón de engranaje/sliders () en la cabecera del Dock para abrir el panel de personalización:

  • Modos de Posición:
    • Tercio Inferior (Lower-Third): Barra moderna en la parte baja de la pantalla. Ideal para cuando el pastor o conferencista está en cuadro.
    • Tarjeta Centrada: Versículo amplio y centrado en la pantalla. Ideal para lecturas comunitarias o momentos de reflexión.
    • Minimalista con Sombra: Sin recuadro de fondo, solo texto flotante con sombra profunda de alto contraste.
  • Fondos Personalizados:
    • Puedes subir fotos de tu iglesia o gráficos presionando el botón Subir.
    • O elegir entre degradados elegantes como Azul Noche Celestial, Dorado Cálido, Púrpura Real o Esmeralda.
  • Control de Contraste / Oscurecimiento (Slider): Ajusta entre 20% y 95% la capa de oscurecimiento para asegurar que el texto blanco nunca se pierda sobre fondos coloridos o cámaras iluminadas.
  • Modo Claro y Oscuro del Dock: Presiona el ícono de Sol / Luna en la cabecera para adaptar la interfaz del operador a cabinas oscuras o iluminadas.

8. Preguntas Frecuentes (FAQ)

¿Requiere conexión a internet durante el culto?
No. Todas las 6 versiones bíblicas están almacenadas localmente en archivos de datos. Funciona 100% offline.
¿El versículo no aparece en la pantalla de OBS, qué hago?
1. Verifica que la fuente de navegador apunte a verso.html.
2. En OBS, haz clic derecho sobre la fuente Biblia Overlay y selecciona Actualizar (Refresh).
3. Asegúrate de que el Dock tenga un versículo seleccionado (marcado con el indicador verde EN VIVO).
¿Es compatible con Mac, Windows y Linux?
Sí. Al estar desarrollado con estándares web nativos y la API BroadcastChannel, funciona idénticamente en cualquier sistema operativo donde corra OBS Studio.

9. Soporte, Dudas y Sugerencias

Si encuentras algún problema, deseas sugerir una nueva función o necesitas ayuda para configurarlo en tu iglesia, puedes escribir directamente a:

Correo: [email protected]
Desarrollado por: mikerosasdev