GramFrame Logo
GramFrame Manual Oficial de Usuario
Referencia Oficial v1.0.0

Guía de Uso y Lista de Comandos de Telegram

Aprende a vincular tu tablet en 30 segundos, enviar fotos y vídeos con audio táctil, proyectar anuncios gigantes, subir lotes de fotos en carpetas o archivos .ZIP y configurar videowalls modulares.

1. Inicio Rápido en 30 Segundos

Paso 1 · En tu Pantalla

Abre la App GramFrame

Descarga e instala la app en tu tablet Android, Smart TV o TV Box. En pantalla verás un código de 4 caracteres (ej. 7K2B) para vincularla al instante.

Paso 2 · En Telegram

Empareja con el Bot

Abre Telegram y busca @GramFrameAppBot (o añádelo a tu grupo familiar). Envía /start 7K2B (o directamente 7K2B). ¡Listo!

2. Modo Individual vs Grupo Familiar Compartido

GramFrame permite que un mismo marco sea gestionado por una sola persona o por decenas de miembros de un grupo:

Chat Privado (Uso Personal)

Habla a solas con el bot. Ideal para tu escritorio personal, mesilla o para controlar pantallas de un negocio.

Grupo de Telegram (Multi-usuario Familiar)

Mete a @GramFrameAppBot en tu grupo de Telegram (ej. Familia o Boda). Todos los integrantes del grupo envían fotos y el marco las proyecta con el nombre del autor.

3. Cómo Trabajar con la Pantalla en el Día a Día

Envío de Fotografías con Pie de Foto

Manda cualquier foto directamente al chat. Si incluyes un texto, se superpondrá como una elegante leyenda inferior translúcida con el nombre del remitente. Además, la pantalla aplica zoom continuo Ken Burns a 60 FPS.

Carteles Gigantes con /texto

Escribe /texto Tu mensaje en Telegram para proyectar un cartel tipográfico gigante a pantalla completa. Ideal para menús, avisos domésticos o felicitaciones.

Vídeos 4K y Audio Táctil

Los vídeos se reproducen en un bucle continuo y silencioso para no alterar el entorno. Si deseas escuchar el sonido original, basta con tocar cualquier punto de la pantalla. Vuelve a tocar para silenciar.

Carga Masiva (Archivos .ZIP y Carpetas)

¿Quieres mandar cientos de fotos de golpe? Envía un archivo .zip al bot de Telegram o utiliza la herramienta web arrastrando una carpeta completa de tu ordenador.

Retirar Contenido y Vaciado Masivo

• Borrar individual: Responde en Telegram a la foto escribiendo /borrar.
• Vaciar carrusel completo: Escribe /borrartodo (o /vaciar). Confirmas con un botón interactivo y las pantallas se vacían al instante.

Menú Interactivo (/menu)

Escribe /menu para desplegar botones táctiles interactivos en el chat. Controla pantallas, videowalls, reuniones y escenarios con un solo toque.

Sesiones y Actas de Reunión (/acta)

Abre reuniones con /sesion iniciar [Título]. Los participantes proyectan notas y pizarras. Al concluir, /acta genera el acta formal en PDF.

Programación Horaria (/programar)

Programa emisiones automáticas para una hora concreta: /programar 13:30 Menú del día. Revisa avisos activos con /programadas.

Escenarios y Presets Globales (/escenario)

Modifica todo tu conjunto de pantallas a la vez con /escenario noche, reunion, fiesta, comercial o /apagar (blackout).

Auto-Arranque en Smart TVs (BootReceiver)

En televisores o TV Boxes conectados a enchufes programados, la app de GramFrame se inicia automáticamente al recibir corriente mediante el permiso BOOT_COMPLETED.

Generación con IA (Google Gemini)

Integra asistentes de Telegram con Gemini para pedir: «Crea una diapositiva sobre oferta de cafés y proyéctala». Gemini emitirá el /texto al bot y brillará en pantalla en segundos.

4. Lista Completa de Comandos de Telegram

Comando Ejemplo de uso Descripción Permisos
/menu /menu Abre el panel táctil interactivo con botones inline en el chat. Todos
/pantallas /pantallas Muestra las pantallas vinculadas, su estado en vivo (🟢/⚪) y su etiqueta #hashtag. Todos
/renombrar /renombrar 1 Salón (o /alias Cocina) Asigna un nombre familiar a la pantalla para enrutar fotos con #salon. Todos
/start /start 49XX (o /vincular 49XX) Vincula la pantalla con este chat o grupo. Todos
/texto /texto Menú del Día: Lentejas con arroz Crea una diapositiva tipográfica gigante a pantalla completa. Todos
/borrar /borrar (respondiendo a la foto) Retira la foto o vídeo individual de la rotación de pantallas. Autor o Admin
/borrartodo /borrartodo (o /vaciar) Vacía todos los recuerdos del carrusel con confirmación interactiva. Autor o Admin
/sesion /sesion iniciar Junta Directiva | /sesion fin Abre o cierra una sesión de trabajo con registro de intervenciones y pizarras. Todos
/acta /acta Compila y entrega el acta formal de la sesión en PDF y Markdown. Todos
/programar /programar 13:30 Paella mixta 12 € Programa un cartel o mensaje para proyectarse a una hora fija (HH:MM). Todos
/programadas /programadas Lista las emisiones programadas por hora pendientes en el grupo. Todos
/escenario /escenario noche | reunion | fiesta | comercial Aplica un cambio ambiental simultáneo a todas las pantallas. Todos
/apagar /apagar Modo blackout: apaga la iluminación de pantalla fuera de servicio. Todos
/despertar /despertar Reactiva la luminosidad y reanuda la rotación diurna. Todos
/mis_marcos /mis_marcos Lista las pantallas activas y su estado online/offline en vivo. Todos
/canjear /canjear PROMO2026 Canjea un código promocional para activar licencia vitalicia. Todos
/videowall /videowall 2x2 0,0 Pantalla1 Asigna la posición matricial para videowalls modulares (2x2, 3x3, etc.). Administrador
/filtro /filtro libre | /filtro comando Controla si entran todas las fotos o solo las que lleven #marco. Administrador
/crearcodigo /crearcodigo VIP 10 Prensa Emite un nuevo código promocional con límite de usos. Superadmin
/codigos /codigos Consulta los códigos activos y cuántos canjes llevan. Superadmin

5. Gestión Multi-Pantalla: Videowall vs Habitaciones Independientes

GramFrame te permite desplegar múltiples pantallas con tres arquitecturas completamente diferentes según tus necesidades:

A. Videowall Matricial N×M 1 Lienzo Dividido

Une varias pantallas físicas contiguas para formar una pantalla gigante. Cada panel renderiza su porción matemática recortada con sincronización milimétrica UTC.

Ejemplo 2x2 (4 Pantallas): /videowall 2x2 0,0 Pantalla1
/videowall 2x2 0,1 Pantalla2
/videowall 2x2 1,0 Pantalla3
/videowall 2x2 1,1 Pantalla4
Soporta 2x2, 3x3, 1x3 horizontal, 3x1 tótem.
B. Multi-Pantalla Espejo Mismo Contenido

Pantallas repartidas en distintas habitaciones (Salón, Cocina, Casa de los Abuelos) vinculadas al mismo chat o grupo familiar.

Cómo se configura: 1. En la tablet del salón escribe /start PIN_1
2. En la tablet de la cocina escribe /start PIN_2
Cualquier foto enviada al grupo se proyecta simultáneamente en todas las estancias.
1 solo envío en Telegram llega a toda la casa.
C. Pantallas Independientes Contenido Selectivo

Gestiona pantallas de diferentes habitaciones o sedes comerciales enviando fotos o avisos exclusivos a cada una:

Método 1: Enrutado por #Hashtag Foto de receta #cocina
/texto Cena lista #salon
Método 2: Grupos Separados: Crea un grupo de Telegram para cada estancia (ej. "GramFrame Salón" y "GramFrame Cocina").
Totalmente aisladas y sin cruces accidentales.

6. Preguntas Frecuentes y Cuidado de Pantalla

¿Cómo protege la app contra el quemado de píxeles (Burn-in) en tablets viejas?

GramFrame incorpora desplazamiento imperceptible de píxeles (*Pixel-Shifting*) cada 5 minutos en el reloj y widgets, y las fotos nunca están estáticas gracias a la transición continua Ken Burns.

¿Qué ocurre si la tablet se reinicia o se corta la conexión WiFi?

La app cuenta con almacenamiento en caché local offline. Seguirá rotando las fotos guardadas sin interrupción de pantalla. Cuando el WiFi regrese, se reconecta automáticamente en segundo plano.

¿Cómo transfiero mi licencia si cambio de tablet?

Las licencias no están atadas al hardware. Puedes desvincular un marco antiguo y volver a vincular la nueva tablet desde el propio bot de Telegram con tu código de licencia.

¿Qué pasa si la app está en una tele apagada? ¿Es autoarrancable?

Sí. GramFrame implementa el receptor BootReceiver con permiso RECEIVE_BOOT_COMPLETED. Al encender la tele, el Chromecast con Google TV o la tablet, la app arranca automáticamente en primer plano. Cuando la tele está apagada, el bot detecta el estado offline en /mis_marcos y almacena en cola los nuevos contenidos para proyectarlos nada más arrancar.

¿Se puede usar con asistentes de Inteligencia Artificial (Google Gemini)?

Absolutamente. Mediante bots de Telegram con integración de Gemini o automatizaciones webhook, cualquier usuario puede enviar prompts tipo: «Crea una diapo de oferta de cócteles y mándala al grupo». La IA genera el formato /texto o la imagen tipográfica y se proyecta al instante en las pantallas.