GramFrame Logo
GramFrame Official User Manual (EN)
Official Reference v1.0.0

User Guide & Complete Telegram Commands

Learn how to pair your display in 30 seconds, post solo or in family groups, overlay text captions, create giant typographic posters, upload bulk ZIPs, and configure synchronized video walls.

1. Quick Start in 30 Seconds

Step 1 · On Your Screen

Open the GramFrame App

Install the app on your Android tablet, Smart TV, or TV Box. Upon launching, you will see a 4-character pairing code (e.g. 7K2B) and sample demo photos.

Step 2 · On Telegram

Pair via Bot

Open Telegram and search for @GramFrameAppBot (or invite it to a group chat). Send /start 7K2B (or directly 7K2B). You're connected!

2. Solo vs Multi-User Family Groups

GramFrame uniquely allows a single screen to receive photos from dozens of people simultaneously:

Private Solo Chat

Send photos directly to the bot in private. Ideal for personal desk frames or office management.

Family Group Chat (Multi-user)

Add the bot to your family group. Any family member can send pictures and the grandparents' living room tablet will display them along with the sender's name!

3. Daily Features & Media Types

Photos with Ken Burns Motion

Photos automatically display with continuous 60 FPS Ken Burns pan & zoom, bordered by dynamic color-matching backdrop blur so pictures fill the screen without awkward black bars.

Superimposed Captions

Add text when uploading a photo on Telegram. It renders as an elegant frosted bottom pill on the screen with author attribution (e.g. «Sunset in Ibiza — Sent by Maria»).

Full-Screen Text Posters (/texto)

Type /texto Message to project a giant typographic poster. Great for café lunch specials, meeting notices, or daily reminders.

Removing Content (/borrar)

Reply to any previous photo in Telegram with /borrar. The photo is instantly wiped from all connected displays.

Interactive Dashboard (/menu)

Send /menu to reveal touchscreen inline buttons. Manage screens, videowalls, meetings, and global presets with one tap.

Sessions & Auto Minutes (/acta)

Launch sessions with /sesion iniciar [Title]. Participants post slides and whiteboard snaps. When done, /acta exports formal PDF minutes.

Timed Scheduling (/programar)

Schedule announcements for exact times: /programar 13:30 Lunch special. View pending jobs with /programadas.

Global Presets (/escenario)

Shift all displays together using /escenario noche, reunion, fiesta, comercial, or /apagar (blackout).

Smart TV Auto-Boot (BootReceiver)

On Smart TVs or Chromecast with Google TV plugged into timed outlets, the app starts automatically when power turns on via BOOT_COMPLETED.

AI Integration (Google Gemini)

Connect Telegram bots with Gemini to request: «Create a slide for our summer cocktail promotion and broadcast it». Gemini sends /texto and it lights up instantly.

4. Official Telegram Commands List

Command Usage Example Description Permissions
/menu /menu Opens the interactive touchscreen dashboard with inline buttons. All
/pantallas /pantallas Shows paired displays, real-time online status (🟢/⚪), and #hashtag. All
/renombrar /renombrar 1 LivingRoom (or /alias) Assigns a friendly name to the display for routing photos via #livingroom. All
/start /start 7K2B (or 7K2B) Pairs the display with this chat or group. All
/texto /texto Daily Special: Pasta Carbonara 10 € Renders a giant high-contrast full-screen typography poster. All
/borrar /borrar (replying to photo) Removes an individual photo or video from the slideshow immediately. Author or Admin
/borrartodo /borrartodo (or /vaciar) Clears all memories from screens with an interactive confirmation prompt. Author or Admin
/sesion /sesion iniciar Board Meeting | /sesion fin Starts or ends a meeting session with intervention tracking. All
/acta /acta Compiles and delivers formal session minutes in PDF and Markdown. All
/programar /programar 13:30 Lunch special 12 € Schedules a notice to project at a specific time (HH:MM). All
/programadas /programadas Lists pending time-scheduled announcements in this group. All
/escenario /escenario noche | reunion | fiesta | comercial Applies a global ambiance preset to all connected screens. All
/apagar /apagar Blackout mode: darkens screen illumination after hours. All
/despertar /despertar Wakes up screens and restores normal daytime slideshow. All
/mis_marcos /mis_marcos Lists active screens and live online/offline status. All
/canjear /canjear PROMO2026 Redeems a promotional code for lifetime license activation. All
/videowall /videowall 2x2 0,0 Screen1 Configures N×M grid matrix and row/column coordinates. Admin
/filtro /filtro free | /filtro command Moderates whether all photos show or only those tagged #marco. Admin

5. Multi-Screen Management: Videowalls vs Independent Rooms

GramFrame provides three versatile display topologies to fit any residential or commercial requirement:

A. Matrix Videowall N×M 1 Sliced Canvas

Tile multiple contiguous displays into one giant synchronized visual surface. Each screen renders its slice with hardware GPU acceleration.

2x2 Matrix Example: /videowall 2x2 0,0 Screen1
/videowall 2x2 0,1 Screen2
/videowall 2x2 1,0 Screen3
/videowall 2x2 1,1 Screen4
Sub-ms UTC synchronization across all panels.
B. Multi-Room Mirroring Same Content

Displays located in different rooms (Living Room, Kitchen, Grandparents' Home) linked to the same Telegram chat or family group.

How to configure: 1. Type /start PIN_1 on screen 1
2. Type /start PIN_2 on screen 2
Any photo or text posted broadcasts simultaneously to all screens.
1 single post updates the entire home.
C. Independent Screens Targeted Content

Deliver dedicated photos or bulletins to specific rooms or commercial store branches:

Method 1: Hashtag Routing Recipe photo #kitchen
/texto Meeting starts at 10 AM #office
Method 2: Separate Groups: Pair each display to a dedicated Telegram group (e.g. "Living Room" and "Kitchen").
Completely isolated feeds with zero overlap.

6. Frequently Asked Questions & Screen Safety

How does GramFrame prevent OLED burn-in on older tablets?

GramFrame features dynamic 5-minute *Pixel-Shifting* on the clock and ambient widgets, while images are continuously kept in subtle cinematic Ken Burns motion.

What happens if the WiFi disconnects or the tablet reboots?

The app maintains local on-device caching. It will continue cycling through cached images without freezing. Once WiFi restores, it seamlessly reconnects via WebSockets.

Can I transfer my license if I upgrade my tablet?

Yes. Licenses are bound to your account, not permanently married to the hardware. You can disconnect an old screen and activate a new device using your license code.

What happens if the TV is turned off? Does the app auto-start?

Yes. GramFrame implements BootReceiver with Android's RECEIVE_BOOT_COMPLETED. When your Smart TV, TV Box, or Chromecast with Google TV powers on, GramFrame launches automatically. While off, the bot tracks its offline status in /mis_marcos and queues incoming photos until it boots back up.

Can I connect AI assistants like Google Gemini with Telegram?

Yes! With Telegram AI bots or automations, users can issue prompts like: «Create a typographic announcement for tonight's cocktail tasting and project it.» The AI formats it as /texto and GramFrame immediately broadcasts it to your screens.