HablaFacil

Teleprompter y cámara en una sola app Android. Escribe tu guion, léelo mientras te grabas sin memorizar nada y exporta el video listo para redes, sin que tus videos salgan del teléfono.

Qué hace

Guion

• Proyectos con su guion, autoguardado mientras escribes, buscar y reemplazar, e importación desde .txt o el portapapeles.
• Estadísticas en vivo: palabras, caracteres y tiempo estimado de lectura.

Teleprompter y cámara

• El texto se desplaza a un ritmo constante (1.0x ≈ 150 palabras por minuto, con cualquier tamaño de letra) con controles de velocidad, tamaño, posición, modo espejo y cuenta atrás.
• Teleprompter superpuesto a la cámara (solo en la vista previa, nunca queda en el video): grabación con pausa, zoom, enfoque, exposición, linterna y cambio de cámara.
• Solo ofrece resoluciones y fps que tu cámara admite de verdad, y graba a una tasa de bits razonable (10 Mbit/s en 1080p30) para no llenar el teléfono.

Exportar y compartir

• Exporta en 720p, 1080p o 4K (si la toma lo permite). Si no cambias tamaño ni fps, copia el video sin recodificarlo.
• Se ejecuta en segundo plano con notificación de progreso, tiempo restante y opción de cancelar.
• Guardar en la galería (Películas/HablaFacil), compartir con el menú del sistema o directo a Instagram, TikTok, YouTube y WhatsApp si están instaladas.

Tecnología

Área	Librerías
Lenguaje y UI	Kotlin 2.4, Jetpack Compose (BOM 2026.09), Material 3, Navigation Compose con rutas tipadas
Arquitectura	MVVM + casos de uso, Hilt, Coroutines/Flow
Cuenta	Firebase Authentication + Credential Manager (Google)
Datos	Room 2.8 (esquemas versionados y migraciones con test), DataStore
Cámara	CameraX 1.6 (camera-compose)
Video	Media3 1.11: ExoPlayer, ui-compose, Transformer y efectos
Segundo plano	WorkManager con servicio en primer plano
Efectos visuales	Haze 2.0 (desenfoque "Liquid Glass")
Pruebas	JUnit 4, Truth, Turbine, MockK, coroutines-test, Room testing, Compose UI Test

El proyecto está organizado en capas (core / domain / data / feature). La lógica que se puede probar sin Android (ritmo del teleprompter, estadísticas del guion, opciones de exportación) es Kotlin puro en domain. Las decisiones de diseño, versiones y el plan por fases están en ARCHITECTURE.md.

Compilar

Requisitos

• Android Studio 2025.3 o superior (su JBR 21 sirve como JDK), o un JDK 17+ con JAVA_HOME configurado.
• Android SDK con la plataforma 37 (compileSdk 37). La app funciona desde Android 8.0 (minSdk 26).

git clone https://github.com/ArnoldZamoratec/teleprompt-caption-android.git
cd teleprompt-caption-android

./gradlew assembleDebug        # APK de depuración
./gradlew installDebug         # instalar en un dispositivo conectado

El Gradle Wrapper descarga todo lo necesario. Android Studio crea local.properties con la ruta del SDK al abrir el proyecto.

Firebase: coloca el google-services.json de tu proyecto de Firebase (app Android com.arnoldcode.glassprompt, con los proveedores Correo/contraseña y Google activados y el SHA-1 de tu clave registrado) en app/.

Versión para Play: ./gradlew bundleRelease genera app/build/outputs/bundle/release/app-release.aab, firmado con la clave de subida definida en keystore.properties (storeFile, storePassword, keyAlias, keyPassword). Ese archivo y el .jks no se suben al repositorio.

Pruebas

./gradlew testDebugUnitTest    # pruebas unitarias en la JVM
./gradlew lint                 # análisis estático
./gradlew connectedDebugAndroidTest   # pruebas instrumentadas (ver nota)

Nota: connectedDebugAndroidTest desinstala la app al terminar y borra sus datos (proyectos y tomas). En un teléfono con datos reales, instala las APK con ./gradlew installDebug installDebugAndroidTest y ejecuta una clase concreta con adb shell am instrument -w -e class com.arnoldcode.glassprompt.data.MigrationTest com.arnoldcode.glassprompt.test/com.arnoldcode.glassprompt.HiltTestRunner.

Privacidad y permisos

Para entrar hace falta una cuenta (Google o correo y contraseña, con Firebase Authentication); es el único uso de Internet. Guiones y videos se guardan solo en el almacenamiento interno del teléfono. La cuenta se puede eliminar desde Ajustes → Cuenta. Política completa: docs/PRIVACY.md.

Permiso	Para qué	Cuándo se pide
Cámara y micrófono	Grabar la toma y su audio	Al abrir la cámara
Notificaciones (Android 13+)	Progreso de la exportación (opcional)	En la primera exportación
Almacenamiento (solo Android 8–9)	Guardar en la galería	Al pulsar "Guardar"
Internet	Iniciar sesión	No se pide (permiso normal)

Los videos se comparten mediante FileProvider, que solo expone la carpeta de exportaciones; las tomas originales siguen siendo privadas.

Estado

Fase	Contenido	Estado
1–2	Arquitectura y proyecto base	✅
3	Design system "Liquid Glass", onboarding y navegación	✅
4	Proyectos, editor de guion y plantillas	✅
5	Teleprompter, cámara y grabación	✅
6	Transcripción, editor y estilos de subtítulos	✅
7	Exportación, galería y compartir	✅
7.1	Se retiraron los subtítulos automáticos y las plantillas	✅
8	Completar las suites de pruebas de integración e interfaz	⏳
9	Rendimiento (Baseline Profile), accesibilidad y R8	⏳
10	Build de release firmado	⏳

Probado en un Samsung Galaxy A24 (Android 16) y en el emulador. Las capturas de este README son del emulador, cuya cámara virtual muestra una escena de prueba.

Limitaciones conocidas

• La prueba instrumentada RecordingFlowTest falla por una incompatibilidad del entorno de pruebas de Compose con el reproductor de Media3; se resolverá en la fase 8.

Autor

Arnold · @ArnoldZamoratec

Este proyecto todavía no tiene una licencia definida.