102 lines
3.9 KiB
Markdown
102 lines
3.9 KiB
Markdown
# WinterGram
|
|
|
|
<p align="center">
|
|
<img src="branding/icon-app-light.png" width="112" height="112" alt="WinterGram white icon">
|
|
</p>
|
|
|
|
<p align="center">
|
|
<strong>Privacy-focused Telegram client for iOS</strong>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="LICENSE"><img src="https://img.shields.io/badge/License-GPLv2-green?style=flat-square" alt="License"></a>
|
|
<img src="https://img.shields.io/badge/Version-1.1-blue?style=flat-square" alt="Version 1.1">
|
|
<img src="https://img.shields.io/badge/Platform-iOS%2015%2B-black?style=flat-square" alt="Platform">
|
|
<img src="https://img.shields.io/badge/Language-Swift-orange?style=flat-square" alt="Swift">
|
|
<img src="https://img.shields.io/badge/Build-Bazel-43A047?style=flat-square" alt="Bazel">
|
|
</p>
|
|
|
|
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](../../releases) page. Install with [AltStore](https://altstore.io), [SideStore](https://sidestore.io), 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`](docs/FEATURES.md).
|
|
|
|
Developer implementation notes: [`docs/wintergram-features.md`](docs/wintergram-features.md).
|
|
|
|
---
|
|
|
|
## Quick Start (build from source)
|
|
|
|
**Requirements:** macOS, Xcode, Python 3, ~60 GB free disk space.
|
|
|
|
```sh
|
|
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`](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**](https://github.com/IMDelewer), [**salenyo**](https://github.com/salenyo) under the [reekeer](https://github.com/reekeer) organization. See [`MAINTAINERS.md`](MAINTAINERS.md).
|
|
|
|
---
|
|
|
|
<p align="center"><sub><a href="LICENSE">GPLv2</a> © reekeer</sub></p>
|