Skip to content

miangee21/Msgify-Lite

Repository files navigation

πŸ“± Msgify Lite – Offline Archive Viewer

Project Status License Latest Release Downloads

A powerful offline archive viewer for Telegram exports and database backups.
Access your data anytime, anywhere β€” no internet, servers, or cloud dependencies required.

πŸ–₯️ Desktop App β€’ 🌐 Web Version β€’ ✨ Features β€’ πŸ“– Docs


πŸš€ Installation

πŸ–₯️ Desktop App (Recommended)

Splash Screen Main Interface

Quick Install (One-Liner)

Linux/Mac:

curl -fsSL https://raw.githubusercontent.com/miangee21/Msgify-Lite/desktop/install.sh | bash

Windows (PowerShell as Administrator):

irm https://raw.githubusercontent.com/miangee21/Msgify-Lite/desktop/install.ps1 | iex

Manual Download

Platform Download Size
Windows πŸ“₯ MSI Installer ~3.5 MB
Windows πŸ“₯ EXE Setup ~2.5 MB
Linux (Debian/Ubuntu) πŸ“₯ DEB Package ~3.7 MB
Linux (Fedora/RHEL) πŸ“₯ RPM Package ~3.7 MB
Linux (Universal) πŸ“₯ AppImage ~10 MB

πŸ’‘ Tip: MSI for Windows and DEB/RPM for Linux provide automatic updates and system integration.


🌐 Web Version

Try Msgify Lite directly in your browser β€” no installation required!

Branches:

  • main β†’ Web version (Next.js)
  • desktop β†’ Desktop app (Tauri)

⚑ Desktop vs Web Comparison

Feature πŸ–₯️ Desktop App 🌐 Web Version
Speed ⚑ 10-20x faster Standard
Offline Access βœ… Full offline ⚠️ Requires initial load
Memory Usage 🟒 90% less Standard
File Access βœ… Native system dialogs ⚠️ Browser limitations
Startup βœ… Beautiful splash screen Instant
Installation Required (~3-10 MB) None
Auto Updates βœ… Built-in (future) Always latest
System Integration βœ… Native app icon, tray Browser tab

🎯 Recommendation: Use Desktop App for best performance and offline reliability.


✨ Key Features

πŸ›‘οΈ Security & Independence

  • Zero Dependencies: Runs completely locally without backend, database, or external APIs
  • Privacy First: Your data never leaves your device β€” all processing happens client-side
  • 100% Offline: No internet required after installation
  • Disaster Recovery: Access archived data even if the main service is unavailable

πŸ“‚ Smart Format Detection

Automatically detects and parses multiple data structures:

  • Telegram Desktop Export – Standard result.json format
  • Custom JSON Arrays – Simplified, flattened structures
  • Database Reconstruction – Parses raw Posts.json and Button.json exports

⚑ Premium Performance

  • Lazy Loading – Images load on-demand (10-20x faster than traditional methods)
  • Instant Search – Real-time filtering by text and metadata
  • Smart Caching – Loaded images stay in memory for instant re-display
  • Intelligent Tagging – Auto-detects and filters by available tags
  • Responsive Grid – Beautiful masonry layout adapts to any screen size
  • Dark Mode Ready – Fully themeable Telegram-inspired interface

πŸ› οΈ Tech Stack

Desktop App (Tauri)

Category Technology
Framework Tauri 2.x + Next.js 15
Language TypeScript + Rust
UI React + Tailwind CSS
Components Shadcn/UI + Lucide Icons
File System Native Tauri APIs (Rust backend)

Web Version

Category Technology
Framework Next.js 15 (App Router)
Language TypeScript
Styling Tailwind CSS
UI Components Shadcn/UI
Icons Lucide React
State React Hooks

πŸ“– Usage Guide

Step 1: Launch the Application

Step 2: Select Your Data Folder

Click the "Select Folder" button and choose your data source:

  • For Telegram Exports: Select the folder containing result.json and the photos directory
  • For Database Exports: Select the folder with Posts.json, Button.json, and photos

Step 3: Browse & Search

Once loaded:

  • Use the Search Bar to find specific posts by text
  • Apply Tag Filters to sort and categorize content
  • Navigate through pages using the pagination controls
  • Enjoy a beautiful, responsive grid layout

Step 4: Offline Access

  • Desktop App: Works completely offline after installation
  • Web Version: Requires initial internet connection to load, then works offline

πŸš€ Need More Features? Try Msgify Pro

Msgify Pro is the full-featured, production-ready version with cloud storage, database, and advanced features.

Msgify Pro Features

  • ☁️ Cloud Storage – Cloudflare R2 integration for high-performance image delivery
  • πŸ—„οΈ Database – PostgreSQL (Neon) + Prisma ORM for persistent data storage
  • πŸ” Authentication – Secure JWT-based login and signup system
  • 🏷️ Smart Tagging – Create, edit, and merge tags with automatic post migration
  • πŸ—‘οΈ Safety Features – Soft delete with recycle bin and restore functionality
  • ⚑ Bulk Operations – Quick cleanup and batch processing capabilities
  • πŸ“Š Dashboard – Beautiful grid-based interface with advanced search and filtering

Quick Links


πŸ—οΈ Development Setup

Prerequisites

  • Node.js 18.0.0 or higher
  • Rust (for desktop app development)
  • npm or yarn

Web Version Setup

# Clone repository
git clone https://github.com/miangee21/Msgify-Lite.git
cd msgify-lite

# Install dependencies
npm install

# Run development server
npm run dev

Visit http://localhost:3000

Desktop App Setup

# Switch to desktop branch
git checkout desktop

# Install dependencies
npm install

# Run in development mode
npm run tauri dev

# Build for production
npm run tauri build

Built apps will be in src-tauri/target/release/bundle/


πŸ“‚ Project Structure

Desktop App

msgify-lite/ (desktop branch)
β”œβ”€β”€ .github/
β”‚   └── assets/               # Screenshots and media
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ layout.tsx        # Root layout with theme provider
β”‚   β”‚   β”œβ”€β”€ page.tsx          # Main app logic (parsers, state, rendering)
β”‚   β”‚   └── globals.css       # Global styles + animations
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ ui/               # Reusable UI components (Shadcn)
β”‚   β”‚   β”œβ”€β”€ SplashScreen.tsx  # Startup splash screen
β”‚   β”‚   β”œβ”€β”€ lite-navbar.tsx   # Navbar with search functionality
β”‚   β”‚   β”œβ”€β”€ local-post-card.tsx # Post display component
β”‚   β”‚   └── local-pagination.tsx# Pagination component
β”‚   └── lib/
β”‚       └── utils.ts          # CSS utilities and helpers
β”œβ”€β”€ src-tauri/
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   └── main.rs           # Rust backend entry point
β”‚   β”œβ”€β”€ icons/                # App icons (all platforms)
β”‚   β”œβ”€β”€ capabilities/         # Tauri permissions
β”‚   └── tauri.conf.json       # Tauri configuration
β”œβ”€β”€ install.sh                # Linux/Mac installer
β”œβ”€β”€ install.ps1               # Windows installer
└── README.md                 # This file

Web Version

msgify-lite/ (main branch)
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ layout.tsx
β”‚   β”‚   β”œβ”€β”€ page.tsx
β”‚   β”‚   └── globals.css
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   └── [same as desktop]
β”‚   └── lib/
β”‚       └── utils.ts
β”œβ”€β”€ public/                   # Static assets
└── README.md

🀝 Contributing

Contributions are welcome! Help improve Msgify Lite:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/YourFeature
  3. Commit your changes: git commit -m "Add YourFeature"
  4. Push to the branch: git push origin feature/YourFeature
  5. Open a Pull Request

Branch Guidelines

  • main β†’ Web version development
  • desktop β†’ Desktop app development
  • Feature branches β†’ New features or fixes

πŸ“ Changelog

v0.1.1 (Latest) - February 14, 2026

  • ✨ Added beautiful splash screen on app startup
  • πŸš€ Implemented lazy loading (10-20x faster)
  • πŸ’Ύ Reduced memory usage by 90%
  • πŸ› Fixed image loading issues
  • πŸ”§ Improved folder selection dialog

v0.1.0 - Initial Release

  • πŸŽ‰ First public release
  • πŸ“‚ Support for Telegram & DB exports
  • πŸ” Search and tag filtering
  • 🎨 Dark mode support

View All Releases


πŸ“„ License

This project is licensed under the MIT License. See the LICENSE file for details.


🌟 Credits & Acknowledgments

  • Tauri – Lightweight desktop framework
  • Shadcn/UI – Beautiful, accessible component library
  • Vercel & Next.js – Next-generation React framework
  • Telegram Desktop – Data export format reference
  • Community Contributors – Your support drives innovation

πŸ”— Links


Made with ❀️ by the Msgify Team

⭐ Star on GitHub β€’ πŸ“§ Report Issues

Support the Project:
If you find Msgify Lite useful, consider giving it a star ⭐ on GitHub!

About

A clean viewer for exported Telegram chats.

Resources

License

Stars

Watchers

Forks

Contributors