TGScanner — настольное приложение для Windows, Linux и macOS. Оно подключается к Telegram от вашего имени (через официальный пользовательский API) и помогает узнать сведения о профиле или сообщении, которые Telegram показывает вашему аккаунту: имя, username, описание, тип чата и т.п. При необходимости можно сохранить аватар и краткую выжимку сообщения в папку на диске.
Это не клиент для переписки и не бот: приложение не рассчитано на массовую рассылку или обход ограничений Telegram. Вы сами отвечаете за соблюдение правил Telegram и законов о персональных данных.
Репозиторий: github.com/WtekSupport/TGScanner ( WtekSupport ).
- Подключение — один раз (или при смене данных) вы указываете API ID и API hash с my.telegram.org, номер телефона вашего аккаунта и проходите вход кодом из Telegram (и паролем 2FA, если включён).
- Поиск — на вкладке «Поиск» вы выбираете режим, вводите запрос и нажимаете «Выполнить». Результат появляется в журнале внизу окна.
- Сохранение файлов — в настройках задаётся папка output; туда могут попасть JPG профиля и JSON с кратким описанием сообщения (для режима URL).
| Режим | Что вводить | Что получаете |
|---|---|---|
| Username | @username или username |
Профиль пользователя, группы или канала (имя, ID, username, bio/описание где доступно), попытка скачать фото профиля |
| ID | Числовой ID Telegram (положительный — пользователь, отрицательный — группа, -100… — канал/супергруппа) |
То же, если API может разрешить этот ID для вашего аккаунта (часто нужен access hash — тогда ID из ваших диалогов или username надёжнее) |
| Телефон | Номер в формате E.164, напр. +79001234567 |
Профиль пользователя, если номер зарегистрирован; перед поиском нужны две галочки и подтверждение в диалоге; номер временно импортируется в контакты и удаляется, когда API позволяет |
| URL | Ссылка на сообщение, напр. https://t.me/channel/123 |
Текст/превью сообщения и JSON-файл в output |
- Не «взламывает» закрытые профили и не показывает то, что ваш аккаунт в Telegram не видит.
- Поиск только по ID для произвольного пользователя часто не сработает без предварительного контакта/username — это ограничение API Telegram, а не баг кнопки.
- Нет фонового мониторинга, парсинга всей ленты и автоматизации рассылок.
- Язык окна и журнала: English (по умолчанию) или Русский — Settings → Language.
- Настройки и сессия хранятся локально в зашифрованном виде рядом с программой; при старте показывается текст условий использования.
- При сбоях подробности могут записываться в файл
tgscanner-crash.logв рабочей папке приложения.
Сборка release на Windows — несколько MB (Slint + FemtoVG/OpenGL), интерфейс на Slint (Winit).
TGScanner is a small desktop program that signs in with your Telegram account (user API via grammers) and runs lookups: public or account-visible profile info, optional profile photo download, and message summary JSON for t.me/…/message links. It is not a full messenger. Lookups support username, numeric ID, phone (with explicit confirmations), and message URL. UI languages: English and Russian.
- Rust stable (see
rust-versionin Cargo.toml) — for building from source - Your own Telegram API credentials from my.telegram.org (not bundled with the app)
git clone https://github.com/WtekSupport/TGScanner.git
cd TGScanner
cargo run --releaseRelease binary:
- Windows:
target/release/tgscanner.exe(GUI, no console window) - Linux / macOS:
target/release/tgscanner
Build artifacts are under target/ in the project root (see .cargo/config.toml if present).
Official builds are attached to GitHub Releases (tag v1.0.1 and newer):
| Platform | Asset name |
|---|---|
| Windows x64 | tgscanner-windows-x86_64.exe |
| Linux x64 | tgscanner-linux-x86_64 |
| macOS | tgscanner-macos-universal |
CI also keeps the same files as workflow artifacts on each successful run on main. See PUBLISHING.md for maintainers.
| Tab | Purpose |
|---|---|
| Connection | API ID, hash, phone → login code → 2FA if needed |
| Lookup | Username / ID / phone / URL |
| Settings | Language, output folder, security notes |
Phone lookup requires two checkboxes and a confirmation dialog.
Local files (do not commit or publish if they contain personal data):
| File | Purpose |
|---|---|
.tguser_config.enc |
Encrypted settings |
.tguser_session.enc |
Encrypted session |
.tguser_vault.key |
Local encryption key (keep with .enc files) |
output/ |
Downloaded JPG / JSON |
tgscanner-crash.log |
Crash diagnostics (if a panic occurred) |
You must comply with Telegram ToS, privacy laws, and obtain consent where required. See in-app warnings and SECURITY.md for vulnerability reports.
See CONTRIBUTING.md and CODE_OF_CONDUCT.md.
GNU Affero General Public License v3.0 or later — SPDX: AGPL-3.0-or-later.