Run, isolate, and manage multiple Telegram accounts concurrently in one high-performance desktop application. Built with Electron + Vite + React 19 + Tailwind CSS.
Telegram-Parallel is an ultra-fast, modern desktop client engineered for power users, community managers, and professionals who manage multiple Telegram accounts simultaneously.
Unlike traditional multi-instance setups or cluttered browser windows, Telegram-Parallel isolates every session into its own dedicated Electron WebContentsView partition. Cookies, credentials, and local cache never collide, allowing you to run all your Telegram accounts concurrently within a single unified workspace.
- Zero-Accidental Opening: Launches into a clean, modern workspace hub instead of automatically loading a session.
- Visual Account Cards: Displays all connected accounts with custom avatars, real-time connection status, unread counters, and one-click session launch buttons.
- Instant Hub Return: Easily return to the selection hub at any time using the sidebar hub button, topbar breadcrumb, or
Ctrl+0.
- Zero Cross-Contamination: Each account runs within an isolated partition (
persist:tg_account_${id}). - Persistent Logins: Sessions remain active across reboots and application updates without re-authentication.
- Privacy First: Deleting an account completely purges its cookies, cache, and indexed storage from disk.
- Free up Memory on Demand: Put background accounts to sleep with a single click to save 300MB–500MB of RAM per session.
- Instant Wake-Up: Wakes instantly back up into the active workspace when selected.
- Native OS File Dialog: Pick avatar images (
.png,.jpg,.jpeg,.webp) directly through your system file picker. - Interactive Cropping Modal: Smooth zoom and pan controls powered by
react-easy-crop. - Performance Optimized: Automatically crops and downscales to 128x128 on an in-memory canvas to preserve disk space and memory.
- Background Interception: Telegram Web notifications are seamlessly intercepted and forwarded to the native OS notification system.
- Click-to-Focus: Clicking an OS notification instantly brings Telegram-Parallel to the foreground and switches directly to that specific account.
- Real-Time Unread Counters: Dynamically parses unread messages from title mutations and displays dock/taskbar notification badges.
- Automatic Process Recovery: If a background Telegram Web instance crashes due to system constraints, the application automatically restarts and recovers the session silently.
- Network Auto-Reconnect: Automatically retries loading when internet connectivity is restored.
- Smart URL Routing: Opens Telegram authentication and bot popups (
oauth.telegram.org) within the authenticated session while routing all external links to your default system browser.
- Close-to-Tray: Minimizing or closing the window keeps your accounts alive in the system tray so you never miss a message.
- Quick Tray Menu: Show/hide the application or exit cleanly through the tray context menu.
- Tailwind CSS v3: Tailored aurora dark theme (
#07090e) with electric cyan (#00D2FF), Telegram blue (#24A1DE), and vibrant indigo accents. - Fluid Micro-Animations: Smooth layout transitions and hover physics built with Framer Motion.
- Collapsible Sidebar: Collapse the sidebar to enjoy an expansive, full-width chat interface.
| Shortcut | Action |
|---|---|
| Escape | Close any active modal (Settings, Add Account, Edit Profile, Cropper) |
| Ctrl + 0 / Cmd + 0 | Return to the Account Selection Hub |
| Ctrl + 1 to 9 | Instantly switch directly to Account 1 through 9 |
| Alt + F4 | Minimize to system tray (keeps sessions alive in background) |
- Desktop Framework: Electron 39 (Multi-process
WebContentsViewarchitecture). - Bundler & Tooling: electron-vite 7 + Vite.
- Frontend Engine: React 19 + TypeScript 5.
- Styling: Tailwind CSS v3 with custom glassmorphism filters.
- Animations: Framer Motion.
- Icons: Lucide React.
- Image Cropper: react-easy-crop.
- Settings & Config Storage: electron-store.
Telegram-Parallel
├── 📁 src
│ ├── 📁 main # Electron Main Process
│ │ ├── 📄 index.ts # Window lifecycle, System Tray, deep links
│ │ └── 📄 accountManager.ts # WebContentsView sandboxing, RAM Saver, IPC
│ ├── 📁 preload # Isolated Preload Layer
│ │ ├── 📄 index.ts # Strongly-typed contextBridge API
│ │ ├── 📄 index.d.ts # Type definitions for window.api
│ │ └── 📄 telegram.ts # Telegram DOM title observer & notification patch
│ └── 📁 renderer # React 19 Frontend
│ ├── 📄 index.html # CSP-secured root template
│ └── 📁 src
│ ├── 📁 components # AvatarCropperModal, EditAccountModal
│ ├── 📁 utils # cn helper, canvas cropImage utility
│ ├── 📄 App.tsx # Hub, switcher, sidebar, and layout controller
│ └── 📄 index.css # Aurora theme tokens & glassmorphic utilities
├── ⚙️ electron.vite.config.ts # Vite multi-bundle configuration
├── ⚙️ electron-builder.yml # Multi-platform installer packaging
├── 📄 AGENTS.md # Architecture specification & contributor rules
└── 📄 package.json # Dependencies & scripts
Download the latest pre-compiled installer from the Releases page:
- Download
telegram-parallel-setup.exe. - Run the installer and launch the application.
# 1. Clone the repository
git clone https://github.com/CodeWithTanim/Telegram-Parallel.git
cd Telegram-Parallel
# 2. Install dependencies
npm install
# 3. Launch in development mode with Hot Module Replacement (HMR)
npm run dev
# 4. Run TypeScript checks across Node and Web targets
npm run typecheck
# 5. Lint codebase
npm run lint
# 6. Format codebase
npm run format
# 7. Package Windows installer
npm run build:winMD SAMIUR RAHMAN TANIM
This application is not affiliated with Telegram or Telegram FZ-LLC. It is an independent open-source desktop client designed for personal and professional multi-account productivity.
Copyright © 2026 MD SAMIUR RAHMAN TANIM
Distributed under the MIT License. See LICENSE for more details.