Start
Run run_kex.bat. Kex has no main window and no tray menu. It registers global hotkeys, speaks through NVDA and opens only focused dialogs such as message entry, file selection, account login, device lists, poll setup and confirmations.
To add an account, press Alt+Win+Shift+N. Kex asks for the phone number with country code, the Telegram code and, when needed, the two-step verification password.
Main hotkeys
Win+Alt+Enter | Interact with the selected item. Open chat, open topic, play voice message, download file, open poll buffer or activate current item. |
|---|---|
Win+Alt+N | Write a message in the active chat or topic. |
Ctrl+Win+R | Reply to the selected message. |
Ctrl+Win+Alt+Up/Down | Move through chats, topics, messages, poll answers, draft fields or settings controls. |
Ctrl+Win+Alt+Left/Right | Switch open chat buffers. Moving past the edge returns to the chat list without closing buffers. |
Win+Alt+' | Close the active chat, poll or temporary buffer. |
Win+Alt+; | Speak information about the selected sender or chat. User activity is spoken as relative time. |
Alt+Win+Shift+F | Send one or more files. |
Alt+Win+Shift+V | Record and send a voice message. |
Alt+Win+Shift+P | Create a poll or submit selected answers in a multiple-choice poll. |
Alt+Win+Shift+E | React to the selected message. |
Alt+Win+Shift+L | Show users who reacted to the selected message. |
Alt+Win+Shift+C | Start a Telegram voice call with the selected user. |
Alt+Win+Shift+A / D / H | Answer, decline or hang up the current call. |
Alt+Win+Shift+Left/Right | Switch accounts and the settings page. |
Forum topics
Forum groups stay as one item on the main chat list. Opening a forum group first shows its topics. Opening a topic then loads messages from that topic only. Closing a topic buffer returns to the topic list, and moving left from the topic list returns to the main chat list.
Topic actions include creating a new topic with Alt+Win+Shift+T, marking the selected topic as read with Alt+Win+Shift+Enter, and muting the selected topic with Alt+Win+Shift+M when Telegram allows it.
Polls and reactions
To create a poll, select a chat or an already-open topic and press Alt+Win+Shift+P. Kex opens a poll draft buffer with question, answers, multiple-choice toggle, anonymous toggle, quiz mode, correct answer, send and cancel.
If Telegram does not allow polls in the selected place, Kex speaks a short reason and logs the full Telegram error.
For reactions, Kex first checks the chat reaction settings. If admins allow only selected reactions, Kex shows only those allowed reactions plus the remove-reaction item.
Voice messages and calls
Voice messages can be played with Win+Alt+Enter when a voice message is selected. Voice recording uses the configured input and output devices from the settings page.
Telegram voice calls use py-tgcalls and ntgcalls. Calls are available for users. Groups and channels do not start one-to-one voice calls.
Updates and logs
Release builds contain compiled executables for Kex, the updater, feedback and log reporting. The user release package does not include Python source files or the project README.
Kex writes logs to %APPDATA%\Krzywy\Kex\logs. If the main app will not start, run run_log_reporter.bat. The reporter asks for consent, creates a zip from log files only and uploads it to the developer endpoint.
If the desktop feedback or log tools stop working after an update, use the website form at /contact/.
Security
- Telegram sessions, settings and embedded API credentials are stored in
%APPDATA%\Krzywy\Kex\data.dat. - The vault uses a per-user Windows DPAPI-wrapped root key, HKDF-SHA256 and AES-256-GCM.
- Updater metadata is protected by a private request header.
- Log upload files, feedback files and Telegram bot configuration stay outside the public Apache document root.