Transform your private Telegram channels into a secure, encrypted personal photo and document vault with zero subscription fees.
🚀 Quick Setup • ⚖️ Comparison • ✨ Features • 📥 Download APK • 🗺️ Roadmap • ❓ FAQ
Commercial cloud storage services (like Google Photos, iCloud, Dropbox) enforce strict storage quotas and costly recurring subscriptions while training AI models on your personal photos.
TeleGphoto solves this by putting you in complete control: your media is encrypted client-side using AES-256-GCM and stored in your own private Telegram channel vault. Telegram's cloud serves as a high-capacity backend with zero third-party tracking, zero recurring subscription fees, and complete data ownership.
| Feature | 📸 TeleGphoto | 🌐 Google Photos / Commercial Clouds |
|---|---|---|
| Storage Model | 🛡️ Decentralized Private Channel Vault | ❌ 15 GB Quota (Paid subscriptions) |
| Subscription Cost | $0 / Month (Free & Open Source) | ❌ $20 – $120+ / Year |
| Privacy & Security | 🔒 Client-Side AES-256-GCM Encryption | ❌ Corporate Scanning & Ads Targeting |
| Max File Upload | ⚡ Up to 2,000 MB (2 GB) per file | |
| Open Source | ✅ 100% Transparent (MIT License) | ❌ Proprietary Closed Source |
| OCR Smart Text Search | ✅ Built-in Client-Side OCR | ✅ Cloud OCR |
| PWA & Offline Mode | ✅ Yes (Installable Web & Android APK) | ✅ Native Apps |
- 🛡️ 100% Private & Self-Hosted: No intermediary servers. All tokens, chat IDs, and encryption keys stay in your browser's local storage.
- ☁️ Unlimited Free Storage: Upload high-resolution photos, 4K videos, raw audio, and PDF documents without paying for cloud storage.
- 🔍 Smart OCR Text Search: Automatically reads text inside receipts, documents, and screenshots for instant keyword search.
- 🎨 Glassmorphic Modern UI: Built with responsive dark mode, smooth gesture controls, and fluid micro-animations.
- 📁 Multi-Format In-Place Viewer: Fullscreen preview and streaming support for
.jpg,.png,.mp4,.mkv,.pdf, and zip files. - 📱 Cross-Platform (PWA + APK): Install on Android, iPhone, Windows, or Mac with a single tap.
flowchart LR
A[📱 User / Client App] -->|Upload Media| B[⚡ TeleGphoto Frontend]
B -->|Encrypted Bot API| C[🤖 Telegram Bot]
C -->|Store Message| D[🔒 Your Private Telegram Channel Vault]
D -->|Stream / Retrieve| B
B -->|Render Gallery| A
Setting up TeleGphoto takes less than 2 minutes:
- Open Telegram and search for @BotFather.
- Send the message
/newbot. - Give your bot a name and a username (e.g.
MyPhotoVault_bot). - Copy your HTTP API Token (e.g.
7123456789:AAF_example_token_abc).
- In Telegram, tap New Channel → Select Private Channel.
- Go to Channel Settings → Administrators → Add Admin → Search your newly created bot and grant "Post Messages" permissions.
- Post any test message (e.g.
hello) in the channel, then forward that message to @userinfobot to get your Chat ID (starts with-100, e.g.-1001234567890).
- Launch TeleGphoto on your browser or install the APK.
- Enter your Bot Token and Chat ID in Settings.
- Tap Connect — start uploading your unlimited photos and videos!
Download the latest production release directly:
- Download APK:
release/TeleGphoto_v1.0_Final.apk - Or download from the GitHub Releases Page.
- Open the web application URL in Chrome (Android/Desktop) or Safari (iOS).
- Android: Tap the popup "Install App" or tap
⋮→ Install Application. - iOS (iPhone/iPad): Tap the Share button
⎙→ Select "Add to Home Screen".
# Clone the repository
git clone https://github.com/krishna3163/GooglePhoto_Alternative.git
# Navigate to web app directory
cd GooglePhoto_Alternative/web-app
# Install dependencies
npm install
# Start local development server
npm run devWe are evolving TeleGphoto from a simple storage client into a full-fledged, privacy-first Google Photos & Apple Photos killer. Here is the active engineering roadmap:
- 📅 Smart Timeline View: Year → Month → Day chronological grouping with sticky date headers and smooth virtualized scrolling.
- 📁 Albums & Smart Folders: Create, rename, and manage albums, plus auto-generated smart albums (Screenshots, Camera, Downloads).
- ❤️ Favorites Vault: Mark photos as favorite with instant filterable gallery.
- 🗑️ Trash & Soft Delete: Safe delete with 30-day recovery and restore capability before permanent channel removal.
- 🔍 Advanced Multi-Filter Search: Search by filename, date range, size, tags, OCR text, and EXIF attributes.
- 📸 EXIF & Metadata Inspector: View camera model, lens, ISO, shutter speed, aperture, resolution, and GPS geolocation coordinates.
- ⚡ Upload Queue & Auto-Retry: Real-time progress bar (MB/s speed, ETA), chunked uploads, and automatic retry on network drops.
- 🔒 Client-Side AES-256-GCM Encryption: Encrypt all photos locally with your private password before uploading to Telegram. Telegram servers only store unreadable ciphertext.
- 🗂️ Multi-Vault Support: Connect multiple distinct Telegram channels (e.g. Personal Vault, Family Gallery, Work & Documents).
- 🛡️ App Lock & Biometrics: Protect your gallery with a local master PIN, password, or device biometric authentication.
- 🧹 Duplicate Photo Cleaner: Detect identical and similar images using SHA-256 and perceptual hash (
pHash) to free up channel clutter.
- 🌅 "On This Day" Memories: Automated nostalgic throwbacks (e.g., "1 Year Ago Today").
- 🔎 Semantic Natural Language Search: Query photos using descriptive terms like "beach sunset", "college trip with friends" using client-side embeddings.
- 👤 Local Face Clustering: On-device face detection and grouping without sending biometric data to external clouds.
- ✂️ Built-in Photo Editor: Crop, rotate, brightness, contrast, and color filters processed entirely in-browser.
- 🎬 Video Player with Duration Badges: In-stream video player with duration stamps, custom thumbnails, and playback controls.
┌─────────────────────────┐
│ React 18 / PWA │
│ (Timeline, Albums, EXIF)│
└────────────┬────────────┘
│
┌─────────┴─────────┐
│ Local IndexedDB │
│ (pHash, Search, │
│ Offline Cache) │
└─────────┬─────────┘
│
┌─────────┴─────────┐
│ Client Encryption │
│ (AES-256-GCM) │
└─────────┬─────────┘
│
┌─────────┴─────────┐
│ Upload Queue & │
│ Resumable Sync │
└─────────┬─────────┘
│ Telegram Bot API
┌────────────────┼────────────────┐
▼ ▼ ▼
┌──────────────────┐┌──────────────┐┌──────────────┐
│ Personal Vault ││ Family Vault ││ Docs Vault │
│ (Private Channel)││ (Channel 2) ││ (Channel 3) │
└──────────────────┘└──────────────┘└──────────────┘
- Core Framework: React 18 + TypeScript
- Styling: Vanilla CSS (Tailored Glassmorphism Design System)
- Animations: Framer Motion
- Icons: Lucide React
- Backend API: Telegram Bot API
- Build Tool: Vite (Lightning fast HMR & PWA packaging)
🔒 Is my media private and secure?
Yes! Your media is stored directly in your personal private Telegram channel. No one has access to it except you and your bot. TeleGphoto runs entirely on client-side JavaScript without storing anything on external databases.
📦 Is there any file size limit?
Telegram Bot API allows uploading files up to 50 MB via standard HTTP bot API, and up to 2,000 MB (2 GB) via Telegram Local Bot API server.
💰 Can Telegram delete my files or charge me?
Telegram offers permanent cloud backup in personal channels for all accounts without expiry. As long as your Telegram account is active, your channel vault remains completely intact.
Contributions, suggestions, and feedback are always welcome! Feel free to open an issue or submit a pull request.
Built with ❤️ by Krishna Kumar
This project is licensed under the MIT License — see the LICENSE file for details.