Cross-platform Telegram client built with Tauri 2.0 + React 19 + TypeScript. Features voice transcription, media handling, and optimized message loading.

• Telegram Integration: Full MTProto support via grammers-client v0.8
• Voice Transcription (STT):
  • Cloud: Deepgram Nova-2 — bring your own API key (Settings → STT); no key is embedded in the build
  • Local: Whisper.cpp via sidecar (~1 GB RAM)
  • Auto-transcribe incoming voice messages
  • Multi-language support (Russian, English, Ukrainian, German, French, Spanish)
• Media Handling:
  • Auto-download for photos/stickers/voice — viewport-scoped (only media actually on screen is fetched)
  • Click-to-download for videos/documents (user downloads jump the queue)
  • Media caching and queue management
  • Paste images directly (Ctrl+V)
• Performance:
  • Message virtualization with @tanstack/react-virtual
  • Optimistic updates with Zustand 5
  • Connection state monitoring
• Multi-account: Switch between multiple Telegram accounts

Frontend:

• React 19 + TypeScript
• Zustand 5 (state management)
• @tanstack/react-virtual (virtualization)
• Vite (build tool)

Backend:

• Tauri 2.0 (Rust + system APIs)
• grammers-client 0.8 (Telegram MTProto)
• whisper-rs + whisper.cpp (local STT)
• reqwest (HTTP client for Deepgram)

• Node.js 20+
• Rust (latest stable)
• Xcode Command Line Tools (macOS)

# Install dependencies
npm install

# Create .env file (Deepgram key is NOT a build input — users add it in Settings → STT)
echo "TELEGRAM_API_ID=your_api_id" >> .env
echo "TELEGRAM_API_HASH=your_api_hash" >> .env

# Run in development mode
npm run tauri dev

# Build for production
npm run tauri build

cd src-tauri/stt-sidecar
cargo build --release
cp target/release/stt-sidecar target/release/stt-sidecar-aarch64-apple-darwin

1. Add repository secrets:
   • TELEGRAM_API_ID
   • TELEGRAM_API_HASH
2. Push to main or trigger workflow manually
3. Download APK from Artifacts (~15-30 minutes)

See .github/ANDROID_BUILD.md for details.

# Install Android Studio + SDK + NDK r25c
export ANDROID_HOME=$HOME/Library/Android/sdk
export NDK_HOME=$ANDROID_HOME/ndk/25.0.8775105

# Add Rust targets
rustup target add aarch64-linux-android armv7-linux-androideabi

# Build
npm run tauri android init
npm run tauri android build

The Deepgram API key is a runtime user setting (Settings → STT), not a build input — it is never embedded in the binary.

MIT

Евгений (suenot)

• GitHub: @suenot