========================================================================
  OVERINTERACTIVE  -  LEEME PRIMERO (Solucion de problemas)
========================================================================

Conecta las interacciones de tu TikTok Live con tus juegos y los
overlays de OBS.

OverInteractive es una aplicacion PORTABLE: no requiere instalacion.
Como es un software nuevo y aun no tiene reputacion ante Microsoft,
Windows puede bloquearla la primera vez que la ejecutas. Es normal y NO
significa que el programa este danado. Abajo te explicamos como
resolverlo paso a paso.

ATAJO: si solo quieres que funcione, ve directo a la seccion 1.


------------------------------------------------------------------------
  REQUISITOS
------------------------------------------------------------------------
  - Windows 10 (64 bits) o Windows 11
  - Conexion a internet
  - Software de streaming con soporte de Browser Source (OBS Studio,
    TikTok Live Studio, Meld Studio u otro) si vas a usar los overlays
  - Espacio en disco: ~200 MB


------------------------------------------------------------------------
  INSTALACION (version portable)
------------------------------------------------------------------------
  1. Descomprime el archivo .zip COMPLETO en una carpeta donde tu
     usuario tenga permisos de escritura, como tu Escritorio o
     Documentos (por ejemplo  Documentos\OverInteractive ).

     >> NO ejecutes el programa desde dentro del .zip. Windows lo corre
        en una carpeta temporal y fallara. Extrae primero TODA la carpeta.

     >> EVITA la raiz C:\ y la carpeta "Archivos de programa": ahi
        Windows exige permisos de administrador para escribir y las
        actualizaciones automaticas podrian fallar. Una carpeta de tu
        perfil (Escritorio o Documentos) es la opcion segura.

  2. Entra a la carpeta extraida y ejecuta OverInteractive.exe

  3. La primera vez puede aparecer un aviso de seguridad de Windows.
     Sigue las instrucciones de la seccion 1.


========================================================================
  1. EL PROGRAMA NO ARRANCA / WINDOWS LO BLOQUEA
========================================================================
Identifica tu caso segun el mensaje que veas.

------------------------------------------------------------------------
  A) "Una directiva de Control de aplicaciones bloqueo este archivo"
     (error: os error 4551)
------------------------------------------------------------------------
  Es el bloqueo del CONTROL DE APLICACIONES INTELIGENTE (Smart App
  Control) de Windows 11. A diferencia de SmartScreen, NO permite crear
  excepciones para un solo programa: o lo desactivas, o no correra.

  Como desactivarlo:
    1. Abre "Seguridad de Windows" (escribelo en el menu Inicio).
    2. Ve a "Control de aplicaciones y explorador".
    3. Entra en "Configuracion del Control de aplicaciones inteligente".
    4. Cambialo a "Desactivado".
    5. Vuelve a ejecutar OverInteractive.exe

  !! AVISO IRREVERSIBLE: una vez desactivado, Windows NO permite volver
     a activarlo sin reinstalar el sistema. Solo algunos equipos con
     Windows 11 lo tienen activo; si nunca ves el error 4551, ignora
     esta seccion.

------------------------------------------------------------------------
  B) Pantalla azul: "Windows protegio tu PC" (SmartScreen)
------------------------------------------------------------------------
  Muy facil de resolver:
    1. Haz clic en "Mas informacion".
    2. Aparecera el boton "Ejecutar de todas formas". Haz clic ahi.
    3. Listo. Windows recordara tu decision.

------------------------------------------------------------------------
  C) El archivo parece "bloqueado" tras descargarlo
------------------------------------------------------------------------
  Manual:
    Clic derecho en OverInteractive.exe -> Propiedades -> marca la
    casilla "Desbloquear" (abajo) -> Aplicar.

  Rapido (PowerShell) -- desbloquea toda la carpeta de una vez.
  Abre PowerShell en la carpeta (clic derecho -> Abrir en Terminal) y
  ejecuta:

        Get-ChildItem -Recurse | Unblock-File

------------------------------------------------------------------------
  D) El antivirus elimina o pone en cuarentena el archivo
------------------------------------------------------------------------
  Falso positivo comun en programas nuevos sin firma.
    1. Abre tu antivirus (o Seguridad de Windows -> Proteccion
       antivirus y contra amenazas).
    2. Busca la cuarentena, localiza OverInteractive y selecciona
       "Restaurar" / "Permitir".
    3. Agrega la carpeta de OverInteractive a las "exclusiones".


========================================================================
  2. ABRE PERO NO SE CONECTA A TIKTOK LIVE
========================================================================
  - Verifica que estas transmitiendo en vivo o que el live este activo.
  - Confirma que escribiste correctamente tu @usuario de TikTok.
  - Revisa tu internet y que ningun firewall bloquee la app.
  - Si usas VPN, intenta desactivarla: TikTok puede limitar conexiones
    de ciertas regiones.


========================================================================
  3. LOS OVERLAYS NO APARECEN EN TU SOFTWARE DE STREAMING
========================================================================
  Los overlays son fuentes de tipo navegador (Browser Source) y
  funcionan en cualquier software compatible: OBS Studio, TikTok Live
  Studio, Meld Studio u otros.

  1. Anade una fuente / capa de tipo "Navegador" (Browser Source). En
     TikTok Live Studio aparece como anadir una "pagina web"; en Meld
     Studio, como fuente de "navegador".
  2. Pega la URL del overlay que te da OverInteractive.
  3. Ajusta el ancho y alto segun tu escena.
  4. Si sale en blanco, refresca la fuente (en OBS: clic derecho ->
     "Actualizar cache de la pagina actual").
  5. Manten OverInteractive abierto mientras transmites; los overlays
     dependen de que la app este corriendo.


========================================================================
  4. LA ACTUALIZACION FALLA (error con Update.exe)
========================================================================
  - Asegurate de haber extraido la carpeta completa (no desde el .zip).
  - Que Update.exe y OverInteractive.exe esten en la misma carpeta.
  - Con Smart App Control activo, puede bloquear Update.exe con el
    error 4551: aplica la solucion 1.A.
  - Cierra del todo la app antes de actualizar (revisa que no quede en
    la bandeja del sistema).


========================================================================
  5. LISTA DE VERIFICACION RAPIDA (antes de pedir ayuda)
========================================================================
  [ ] Descomprimiste la carpeta completa (no ejecutas desde el .zip).
  [ ] Ejecutaste OverInteractive.exe, no Update.exe.
  [ ] Desbloqueaste los archivos (seccion 1.C).
  [ ] Diste excepcion en SmartScreen / antivirus si aparecio.
  [ ] Tienes internet y tu software de streaming instalado (si usas
      overlays).


========================================================================
  ¿SIGUES CON PROBLEMAS?  SOPORTE
========================================================================
  Unete a nuestro Discord y comparte:
    - El mensaje de error exacto (o una captura).
    - Tu version de Windows (Inicio -> escribe: winver).
    - Que paso de esta guia intentaste.

  Discord de OverInteractive:  https://discord.gg/z9tSKfR6Du


------------------------------------------------------------------------
  Nota tecnica: los avisos de seguridad ocurren porque la app aun no
  esta firmada con un certificado de codigo con reputacion. Es un
  proceso en marcha; en futuras versiones estos bloqueos deberian
  desaparecer a medida que el ejecutable acumule confianza ante
  Microsoft.

  OverInteractive -- Hecho para creadores de contenido.
========================================================================
