WinterGram

Privacy-focused Telegram client for iOS

WinterGram (Wnt) is an independent iOS client for Telegram. It keeps the familiar Telegram experience and adds a dedicated WinterGram settings tab where privacy tools, history recovery, appearance controls, and other enhancements live in one place.

The app speaks both tg:// deep links and its own wnt:// scheme.

---

Download

Prebuilt unsigned IPAs are published on the Releases page. Install with AltStore, SideStore, or another sideloading tool.

WinterGram is not distributed on the App Store. Free Apple IDs must re-sign the app every 7 days; AltStore and SideStore can automate this.

---

Features

WinterGram adds Ghost Mode, saved deleted messages, edit history, a hidden archive, local Premium UI, ad removal, Liquid Glass appearance, spoofing, chat conveniences, and more.

A complete, structured feature list is in docs/FEATURES.md.

Developer implementation notes: docs/wintergram-features.md.

---

Quick Start (build from source)

Requirements: macOS, Xcode, Python 3, ~60 GB free disk space.

git clone --recursive https://github.com/reekeer/WinterGram.git
cd WinterGram
cp build-system/wintergram-development-configuration.example.json \
   build-system/wintergram-development-configuration.json
# Edit the JSON: api_id, api_hash, bundle_id, team_id
./scripts/build-wintergram.sh sim

The simulator IPA lands in build/WinterGram-Simulator.ipa. Build straight into a running Simulator with ./scripts/build-wintergram.sh --install (add --run to launch it). Full instructions (device builds, signing, AltStore): docs/wintergram-setup.md.

---

Configuration

All WinterGram options are stored in WinterGramSettings and exposed through the WinterGram tab in Settings. English UI strings ship in en.lproj; Russian translations are seeded in submodules/TelegramPresentationData/Sources/WinterGramStrings.swift.

---

Project Layout

WinterGram/
├── Telegram/           App entry, extensions, icons, xcconfig
├── submodules/         Feature libraries (Swift / Obj-C)
├── branding/           Source art: app-icon PNGs (wnt-app-icon-*.png) + badge/snowflake shapes
├── docs/               Setup guide, feature list, architecture notes
├── build-system/       Bazel wrapper (Make.py) and configs
└── scripts/            Build + tooling
    ├── build-wintergram.sh    Convenience build script (sim / sideload / livecontainer)
    └── generate-app-icons.sh  Regenerate every app icon from branding/wnt-app-icon-*.png

---

Deep Links

Anything that works with tg:// also works with wnt://:

tg://resolve?domain=durov
wnt://resolve?domain=durov
wnt://wintergram/ghost

wnt:// URLs are normalized to tg:// at the app entry point.

---

Contributing

Maintainers: IMDelewer, salenyo under the reekeer organization. See MAINTAINERS.md.

---

_{GPLv2 © reekeer}