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
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.
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:
Tile multiple contiguous displays into one giant synchronized visual surface. Each screen renders its slice with hardware GPU acceleration.
/videowall 2x2 0,0 Screen1/videowall 2x2 0,1 Screen2/videowall 2x2 1,0 Screen3/videowall 2x2 1,1 Screen4
Displays located in different rooms (Living Room, Kitchen, Grandparents' Home) linked to the same Telegram chat or family group.
/start PIN_1 on screen 12. Type
/start PIN_2 on screen 2Any photo or text posted broadcasts simultaneously to all screens.
Deliver dedicated photos or bulletins to specific rooms or commercial store branches:
Recipe photo #kitchen/texto Meeting starts at 10 AM #officeMethod 2: Separate Groups: Pair each display to a dedicated Telegram group (e.g. "Living Room" and "Kitchen").
6. Frequently Asked Questions & Screen Safety
GramFrame features dynamic 5-minute *Pixel-Shifting* on the clock and ambient widgets, while images are continuously kept in subtle cinematic Ken Burns motion.
The app maintains local on-device caching. It will continue cycling through cached images without freezing. Once WiFi restores, it seamlessly reconnects via WebSockets.
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.
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.
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.