Guía de Uso

Descarga el instalador para macOS o Windows, ábrelo y listo — WorshipHub es una sola app nativa sin dependencias, sin cuenta y sin necesidad de internet para sus funciones principales.

Solución a error de apertura en macOS ("Aplicación dañada" o bloqueada)

Al descargar e instalar cualquiera de nuestras apps de escritorio (WorshipHub, WorshipHub Notes o WorshipHub Songs) en macOS desde internet, el sistema Gatekeeper de macOS puede bloquear la app mostrando una alerta como "La aplicación está dañada y no se puede abrir. Deberías trasladarla a la papelera" o "Desarrollador no identificado".

Esto se debe a la marca de cuarentena de macOS sobre archivos descargados de la web. Para solucionarlo e iniciar la app sin problemas, abre la Terminal de tu Mac y ejecuta el comando correspondiente a la app instalada:

# Para WorshipHub:
sudo xattr -rd com.apple.quarantine /Applications/"WorshipHub.app"

# Para WorshipHub Notes:
sudo xattr -rd com.apple.quarantine /Applications/"WorshipHub Notes.app"

# Para WorshipHub Songs:
sudo xattr -rd com.apple.quarantine /Applications/"WorshipHub Songs.app"

(Terminal te pedirá la contraseña de tu Mac al ejecutar sudo. Escríbela y presiona Enter).

La ventana principal

La app se organiza en tres áreas:

• Panel izquierdo — tus bibliotecas: Canciones, Biblia y Medios (imágenes, videos, enlaces de YouTube).
• Centro — la Lista del Servicio (el orden de hoy) y la cuadrícula de diapositivas del elemento seleccionado.
• Panel derecho — la Vista Previa: lo que está EN VIVO, lo que sigue, el botón Proyectar y los controles de Negro/Logo.

Proyectar

Conecta una segunda pantalla (proyector o TV) y presiona el botón Proyectar — o ⌘P / Ctrl+P. La ventana de salida se abre en la pantalla secundaria, en pantalla completa real y sin bordes. Presionar Proyectar de nuevo (o Escape dentro de la ventana de salida) la cierra.

• Doble clic en cualquier diapositiva la envía en vivo al instante.
• Las flechas del teclado avanzan/retroceden diapositivas, pasando de un elemento del servicio al siguiente.
• B activa pantalla negra; L muestra el logo de tu iglesia sobre negro. Ambos son instantáneos y se quitan igual.

Apariencia del texto

La barra superior tiene tamaño de fuente (A- / A+), negrita, cursiva y alineación — se aplican a la salida proyectada en vivo. El tamaño de fuente se recuerda entre sesiones.

Tip: todo lo que esta guía menciona sobre teléfonos — Control Remoto, Subtítulos, Notas de Sermón — no necesita instalarse de ninguna tienda. Son apps web que se abren escaneando un código QR desde la app de escritorio.

La Lista del Servicio es el orden de tu evento: canciones, pasajes bíblicos, imágenes, videos y clips de YouTube, en el orden en que los presentarás.

Agregar elementos

• Canciones — presiona el + en cualquier canción de la biblioteca. Si la canción tiene traducciones, todos los idiomas vienen incluidos y puedes cambiar en vivo.
• Versículos — navega a un capítulo, toca los versículos que quieras y presiona Agregar Versículos. Cada versículo se vuelve su propia diapositiva, etiquetada V1, V2…
• Imágenes y videos — agrégalos a la biblioteca de Medios y de ahí al servicio.
• YouTube — pega un enlace. La app obtiene el título real y la miniatura automáticamente, y reproduce el video integrado en la ventana de salida — sin ventanas de navegador.

Arrastra los elementos para reordenarlos. La ✕ elimina un elemento.

Cambiar idiomas en vivo

Los elementos de canción con traducciones muestran un selector de idioma en el encabezado de la cuadrícula — cambiarlo re-renderiza todas las diapositivas en ese idioma. Cada diapositiva individual también tiene un chip para cambiar solo esa temporalmente. Los elementos bíblicos funcionan igual: si tienes varias versiones descargadas, un pasaje proyectado puede cambiar entre versiones o idiomas sin salir de la vista en vivo.

Guardar y abrir servicios

Archivo ▸ Guardar Servicio escribe todo el orden en un solo archivo portátil:

• Las canciones van incluidas — al abrir el archivo en otra computadora, cualquier canción que falte se restaura en su biblioteca.
• Las imágenes y videos también van incluidos.
• Los clips de YouTube se descargan dentro del archivo cuando es posible, para que se reproduzcan sin internet en el momento de la presentación.

Abre el archivo en la computadora de la iglesia con Archivo ▸ Abrir Servicio y todo queda exactamente como lo armaste en casa.

Lo que hay detrás de la letra importa. WorshipHub renderiza los fondos en la GPU como shaders GLSL reales — no videos en bucle — así que corren fluidos hasta en hardware modesto.

Fondos animados

Abre el selector de fondos en la barra superior. Hay 16 efectos animados (Malla Líquida, Flujo de Aurora, Lluvia de Gracia, Vitral, Mar de Cristal…), cada uno con controles de velocidad y complejidad. Los efectos toman los colores de tu degradado seleccionado, así todo queda en paleta.

Tus propios fondos

Presiona ＋ Agregar fondo dentro del selector para crear un preset personalizado: elige los dos colores del degradado, opcionalmente fuerza un color de partículas/acento, ponle nombre y guárdalo. Los presets personalizados persisten y se pueden borrar cuando quieras. También puedes subir imágenes de fondo estáticas y mostrarlas a pantalla completa desde el panel de Vista Previa.

Reproducción de video y YouTube

Cuando una diapositiva de video o YouTube está en vivo, el panel de Vista Previa muestra una barra de transporte: reproducir/pausar y una línea de tiempo arrastrable con posición y duración. Arrastra a cualquier punto y la salida salta al instante. Los videos se repiten al terminar.

Negro, Logo y tomas de pantalla

Negro (B) apaga la salida; Logo (L) muestra el logo de tu iglesia sobre negro; una imagen de fondo también puede tomar toda la pantalla. Los tres son mutuamente excluyentes e instantáneos. Los subtítulos se ocultan automáticamente mientras Negro o Logo están activos.

Pantallas

La app elige la pantalla secundaria automáticamente y re-detecta cuando conectas un proyector después de arrancar. También puedes elegir la pantalla de salida manualmente — una elección manual nunca se sobreescribe.

El panel de Biblia te da escritura sin internet, proyección versículo por versículo y cambio de versión en vivo.

Descargar traducciones

Abre el panel de Biblia y busca en el catálogo — hay cientos de traducciones disponibles, filtradas por idioma (Español, English, Français, Italiano). Presiona descargar en las que quieras: el texto completo se guarda localmente, así que después todo funciona sin internet. Puedes borrar cualquier traducción desde la misma lista.

Navegar y proyectar

Elige una traducción, luego un libro, luego un capítulo. Toca los versículos para seleccionarlos y presiona Agregar Versículos — el pasaje llega a la Lista del Servicio como un elemento con una diapositiva por versículo (V1, V2…), titulado como "Juan 3:16-18". Doble clic en cualquier versículo lo proyecta; las flechas recorren el pasaje versículo por versículo.

Cambiar versión o idioma en vivo

Si el libro y capítulo de un pasaje existen en más de una traducción descargada, el elemento tiene el mismo selector de idioma que las canciones — cambia el pasaje completo a otra versión (digamos NVI → RVR1960) en pleno servicio, o cambia una sola diapositiva temporalmente. Solo se ofrecen las traducciones que realmente contienen ese capítulo.

Versículos desde otras apps

Los versículos también pueden llegar al servicio desde el Control Remoto (su pestaña de Biblia) y desde Notas de Sermón (su editor y modo Podio) — aparecen formateados idénticamente, una diapositiva por versículo, y se de-duplican automáticamente si el mismo pasaje se envía dos veces.

El Control Remoto es una app web para teléfonos, tablets y laptops — nada que instalar.

Activarlo y emparejar

Activa Herramientas ▸ Activar Control Remoto en la app de escritorio. Un código QR y un PIN de 6 dígitos aparecen en Configuración ▸ Acceso Remoto. En el teléfono, abre la app Remota, escanea el QR (o escribe la dirección mostrada) y escribe el PIN si te lo pide.

Después del primer emparejamiento exitoso, el teléfono recibe un token de dispositivo y queda recordado — no volverá a pedir el PIN, incluso después de que el escritorio se reinicie o la dirección del túnel cambie. Administra los dispositivos confiados (renombrar, revocar, marcar como salida) en Configuración ▸ Dispositivos Conectados.

Qué puedes hacer desde el teléfono

• Pestaña Control — diapositiva siguiente/anterior, pantalla negra, logo y estado en vivo.
• Pestaña Servicio — ver el orden, saltar a cualquier diapositiva, reordenar elementos.
• Pestaña Biblioteca — agregar canciones al servicio, navegar la Biblia y enviar versículos, pegar enlaces de YouTube, y subir fotos/videos directo del carrete del teléfono.
• Cambio de idioma — los mismos selectores por elemento y por diapositiva que tiene el escritorio.

El diseño se adapta: los teléfonos usan pestañas inferiores; las tablets y laptops, una superficie de control de varias columnas.

Un teléfono como segundo proyector

En Configuración ▸ Dispositivos Conectados, marca un dispositivo como Salida. El Remoto de ese dispositivo muestra entonces un botón Proyectar que abre una ventana a pantalla completa en una pantalla conectada a él — útil para un TV del lobby o un salón adicional. Si el navegador bloquea la pantalla completa automática, aparece un botón Pantalla completa dentro de la propia ventana de proyección.

Notas de Sermón es una app aparte para el pastor — escribir durante la semana, predicar el domingo. Corre como app de escritorio o en el navegador.

Escribir

Un editor de texto enriquecido limpio: encabezados, negrita/cursiva, listas y bloques de citas bíblicas. Inserta un pasaje desde el navegador bíblico integrado y cada versículo aparece con su pequeño número — así siempre ves dónde termina el versículo 1 y empieza el 2. Los sermones se guardan localmente y pueden sincronizarse con tu propio proyecto de Supabase.

Conectar con la app principal

En Notas ▸ Configuración ▸ Servidor de Transcripción, escribe la dirección de la app de escritorio (o escanea su QR). La primera conexión pide aprobación en la pantalla del escritorio — un toque en Permitir, y el dispositivo queda confiado desde entonces. El token sobrevive reinicios y cambios de dirección del túnel.

Modo Podio

Podio convierte el sermón en un teleprompter limpio de letra grande con cronómetro de servicio. Dos superpoderes en vivo:

• Toca un versículo y se proyecta. Cada versículo de una cita bíblica se puede tocar individualmente — toca el versículo 2 y el versículo 2 sale en vivo en el proyector, agregado al servicio automáticamente (sin duplicados si ya estaba). Funciona incluso si el escritorio no tiene esa traducción descargada — el texto viaja desde el propio sermón.
• Enviar todos los pasajes de antemano. Un botón empuja cada pasaje citado al orden del servicio antes de que empiece el sermón.

El micrófono del pastor

Podio también puede transmitir la voz del pastor para la Traducción en Vivo. Dos modos (elegidos en el escritorio): transmitir el audio crudo para que el modelo Whisper del escritorio lo transcriba, o — en computadoras modestas — dejar que el propio navegador del teléfono haga el reconocimiento de voz y envíe el texto terminado.

WorshipHub puede transcribir el sermón mientras se predica y ponerlo en pantalla, en la transmisión y en el teléfono de cada oyente.

En el proyector

Activa Herramientas ▸ Traducción en Vivo (Presentación) y los subtítulos aparecen en una barra al pie de la salida proyectada. El reconocimiento de voz corre completamente en tu computadora con Whisper (dos tamaños de modelo — Lite y Pro — descargables en Configuración; acelerado con Metal en Apple Silicon). Cuando el idioma destino es inglés, Whisper traduce directamente; otros destinos muestran por ahora la transcripción.

Personalizar los subtítulos

Configuración ▸ Traducción en Vivo ▸ Subtítulos: elige el color del texto, el tamaño, el color de fondo y la opacidad del fondo (la barra siempre queda un poco translúcida a propósito). Una vista previa en vivo muestra exactamente lo que el proyector renderizará. Los subtítulos siempre se limitan a 3 líneas — las palabras más viejas se van para que la pantalla nunca se sature.

Subtítulos para la Congregación

Activa Herramientas ▸ App de Subtítulos y comparte el QR (muéstralo en el proyector vía Herramientas ▸ Mostrar QR de Acceso). Cada miembro abre una página web en su propio teléfono y elige su propio idioma de lectura — English, Español, Français, Deutsch, Italiano. El modelo de traducción (~40 MB, Opus-MT) se descarga una sola vez en su navegador y corre localmente: costo cero en la nube, funciona para cualquier cantidad de oyentes. El texto-a-voz puede leer la traducción en voz alta por audífonos.

De dónde viene la voz

El micrófono del pastor es la app de Notas de Sermón (modo Podio). El escritorio elige quién transcribe: sus propios modelos Whisper, o el reconocedor del navegador del teléfono para computadoras de bajos recursos. En ambos casos, los espectadores y el proyector ven el mismo texto.

Si tu iglesia transmite en vivo con OBS (o cualquier software con fuentes de navegador), WorshipHub te da dos overlays listos. Ambos son páginas web servidas por la app de escritorio — los agregas como Fuentes de Navegador (Browser Source).

Las dos fuentes

1. Overlay de subtítulo en vivo — el subtítulo actual sobre fondo transparente, con el estilo de tu Configuración (color, tamaño, fondo, máximo 3 líneas). Queda en blanco hasta que empieza la transcripción.
2. QR para unirse — el código QR de Subtítulos para la Congregación sobre fondo transparente, para que los espectadores en casa lo escaneen directo de la transmisión.

Agregarlas a OBS

Abre Configuración ▸ Traducción en Vivo ▸ Para OBS. Copia cada URL con su botón de copiar y pégala en una nueva Fuente de Navegador en OBS. La URL del subtítulo ya lleva tu estilo como parámetros (size, color, bg, bgcolor) — cambia el estilo en Configuración y vuelve a copiar para actualizar.

Usa la dirección del túnel. El navegador integrado de OBS no puede aceptar un certificado auto-firmado de LAN, así que si OBS corre en otra máquina — o quieres que sea a prueba de todo — activa primero un Túnel Seguro y copia las URLs con él encendido.

Control en vivo durante la transmisión

Dos interruptores en el menú Herramientas:

• Mostrar/Ocultar subtítulos (OBS) — silencia el overlay de la transmisión sin tocar los subtítulos del proyector ni los teléfonos de la congregación.
• Mostrar/Ocultar QR de acceso (OBS) — oculta el overlay del QR cuando no lo quieres en pantalla.

Ambos surten efecto en un par de segundos; las fuentes pueden quedarse permanentemente en tu escena de OBS y simplemente quedan en blanco cuando todo está apagado.

Las apps complementarias normalmente requieren que cada dispositivo esté en el mismo Wi-Fi que el escritorio. Un Túnel Seguro quita ese límite: publica el servidor local del escritorio en una dirección HTTPS pública, sin configurar el router ni abrir puertos.

Para qué lo quieres

• Teléfonos con datos móviles (sin Wi-Fi de la iglesia) pueden usar Remoto, Notas y Subtítulos igual.
• Las Fuentes de Navegador de OBS obtienen un certificado públicamente confiable — la dirección LAN usa uno auto-firmado que el navegador de OBS no acepta fácilmente.
• Los miembros en casa pueden abrir la página de Subtítulos desde cualquier lugar.

Proveedores

Configuración ▸ Túnel Seguro soporta cuatro opciones — instala la que elijas en la computadora de presentación:

Hay un interruptor de auto-inicio para que el túnel se levante solo cada vez que la app arranca.

La dirección no es permanente

Con los planes gratuitos, la URL pública cambia cada vez que el túnel se reinicia — es normal, no es un error. WorshipHub maneja las consecuencias por ti:

• Cada código QR (Remoto, Subtítulos, emparejamiento de Notas) se regenera automáticamente en el momento en que el túnel conecta o se cae.
• Los dispositivos emparejados siguen confiados: el token del dispositivo es independiente de la dirección, así que los teléfonos no necesitan re-aprobación cuando la dirección cambia — solo necesitan la dirección nueva, lo más fácil es re-escanear el QR.
• Las URLs de OBS deben re-copiarse cuando la dirección cambia, a menos que pagues un dominio fijo (ngrok) o uses Tailscale, cuya dirección es estable dentro de tu tailnet.

Tu biblioteca de canciones vive en una base de datos local — sin cuenta, sin nube obligatoria. Cuando tienes más de una computadora (o quieres respaldo externo), hay dos opciones de sincronización integradas.

Sincronización LAN (computadora a computadora)

Configuración ▸ Sincronización de Datos. Pon una computadora en modo Servidor y la otra en modo Cliente — se descubren automáticamente en la red local, y Sincronizar Ahora transfiere la biblioteca, incluyendo todas las traducciones de las canciones. Úsalo para preparar en una laptop en casa y luego pasar todo a la computadora del santuario el domingo.

Sincronización en la nube (Supabase)

Si quieres sincronizar por internet, WorshipHub se conecta a tu propio proyecto gratuito de Supabase — tú eres dueño de la base de datos, WorshipHub es solo un cliente.

1. Crea un proyecto en supabase.com (el plan gratis alcanza de sobra).
2. Copia la URL del proyecto y la clave anon/public en Configuración ▸ Sincronización en la Nube.
3. Presiona Copiar SQL y córrelo una vez en el editor SQL de Supabase — crea las tablas (es seguro re-ejecutarlo; es idempotente).
4. Sincroniza manualmente o activa auto-sincronización.

La app de Notas de Sermón tiene su propia configuración de Supabase aparte (sus propias tablas, mismos pasos) — los sermones del pastor y la biblioteca de canciones de la iglesia se mantienen independientes a propósito.

Qué se sincroniza dónde