KG Chat — кроссплатформенный десктопный чат на PythonПредставляю кроссплатформенный десктопный чат на Python (Windows, macOS, Linux): графический интерфейс реализован с помощью PyQt6, а для тёмной и светлой тем используется pyqtdarktheme.
Чат представлен в двух цветовых темах: тёмной и светлой.
скрытый текст…
Скриншот тёмной темы:

Скриншот светлой темы:

═══════════════════════════════════════════1. Установка Python═══════════════════════════════════════════Перед установкой приложения чата необходимо установить интерпретатор Python. Скачайте его с официального сайта
https://www.python.org — для Windows используйте установочный .exe файл (standalone installer).
Скриншот: Страница загрузки PythonВажно для Windows: При запуске установщика обязательно поставьте галочку
"Добавить Python в PATH" (Add Python to PATH) в нижней части первого окна установки — это добавит Python и pip в системные переменные и позволит запускать их из командной строки.
Проверка установки Python:Если вы установили Python правильно, то, запустив cmd.exe и выполнив команду:
python --version & pip --version
вы должны увидеть версии установленных Python и pip.
Скриншот: Проверка версий Python и pip═══════════════════════════════════════════2. Установка дополнительных компонентов═══════════════════════════════════════════Для полноценной работы приложения необходимо также установить:
2.1. MPV PlayerMPV Player — медиаплеер для воспроизведения видео из ссылок (YouTube, VK, VKVideo, Rutube и др.)
Скачать: https://mpv.io/installation/ ->
Скриншот страницы загрузкиУстановка:1. Скачайте архив
mpv-x86_64-20260204-git-ea82915.7z (версия может отличаться) ->
Скриншот2. Распакуйте архив в папку
mpv ->
Скриншот3. Переместите папку mpv в
C:\Program Files\4. Запустите
mpv-register.bat для регистрации программы в системе
5. Запустите
updater.bat для обновления компонентов
Регистрация и обновление2.2. Графический интерфейс uosc (опционально)Можно использовать MPV с альтернативным графическим интерфейсом uosc:
Скачать: https://github.com/tomasklaen/uosc/releases/ (файл
uosc.zip из Releases)
Установка GUI: Скачайте архив uosc.zip и распакуйте его содержимое (папки
scripts и
fonts) в папку
C:\Users\%USERNAME%\AppData\Roaming\mpv\ (если такой папки нет, необходимо создать)
2.3. .NET Runtime (только для Windows)Для пользователей Windows требуется установить .NET Runtime для работы приложения.
Скачать: https://dotnet.microsoft.com/download/dotnet (Рекомендуется версия .NET 10.0.2 и выше)
═══════════════════════════════════════════3. Установка приложения чата═══════════════════════════════════════════1. Скачайте архив приложения:
https://github.com/VimiummuimiV/KG_Chat_PyQ.../heads/main.zip2. Распакуйте содержимое архива. Вы получите папку
KG_Chat_PyQt6-main3. При желании переименуйте папку в более понятное название, например
KG_Chat4. Переместите папку в
C:\Program Files\ или в любое другое удобное место
ВАЖНО: После установки не рекомендуется перемещать папку в другое место
5. Запустите файл
install.bat для начала установки
6. После завершения установки на рабочем столе появятся:
- Ярлык
"KG Chat" для запуска приложения
- Файл лога установки в формате .txt
═══════════════════════════════════════════4. Основные возможности и горячие клавиши═══════════════════════════════════════════4.1. Глобальная горячая клавишаЧат можно быстро скрыть в трей или показать снова с помощью глобального сочетания клавиш:
Windows: Win + C
macOS: Cmd + C
Linux: Super + C
Горячая клавиша работает даже когда окно чата неактивно.
4.2. Переключение между видами (Tab)Быстрое переключение между режимами просмотра:
Tab — переключение между Чатом и Чатлогами
Если вы находитесь в профиле пользователя или других окнах, клавиша автоматически перенаправит вас на основной экран чата (сообщения).
Видео: Переключение между видами по Tab4.3. Клик по пользователю в списке участников чатаЛКМ — открывает профиль пользователя
Ctrl + ЛКМ — активирует шепталку с выбранным пользователем
Видео: Вход в приватный чат и ответ пользователю4.4. Клик по пользователю в сообщенияхЛКМ — добавляет ник в поле ввода (только уникальные)
Двойной клик — заменяет содержимое поля выбранным ником / очищает поле, если ник единственный
Ctrl + ЛКМ — активирует шепталку с выбранным пользователем
Shift + ЛКМ — открывает профиль выбранного пользователя
ПКМ — открывает контекстное меню с возможностью добавления пользователя в постоянную или временную блокировку
Примечание: Функции работают только в сообщениях чата, но не в чатлогах.
Видео: Работа с никамиВидео: Контекстное меню блокировки4.5. Навигация по категориям смайликовВ окне смайликов доступна навигация по тематическим группам:
ЛКМ по категории — переключение на выбранную группу смайликов
СКМ (колёсико мыши) над панелью категорий — быстрое перемещение между группами вперёд/назад
Вставка смайлика мышью:ЛКМ — вставить смайлик и закрыть панель
Shift + ЛКМ — вставить смайлик без закрытия панели (для вставки нескольких подряд)
Клавиатурная навигация (когда панель смайликов открыта):Открытие панели через
Ctrl + ; автоматически снимает фокус с поля ввода, чтобы клавиши навигации заработали сразу.
← /
H — влево
→ /
L — вправо
↑ /
K — вверх
↓ /
J — вниз
Tab — следующая группа
Shift + Tab — предыдущая группа
Enter /
A /
; — вставить выбранный смайлик и закрыть панель
Shift + Enter /
Shift + A /
Shift + ; — вставить без закрытия панели
Esc — закрыть панель смайликов и вернуть фокус на поле ввода
H/L навигация линейная — перемещается через всю сетку последовательно с переходом на следующую/предыдущую строку. J/K навигация колоночная — перемещается строго по столбцам.
Панель смайликов запоминает последнюю выбранную группу и позицию курсора в каждой группе между сессиями.
Примечание: Клавиши навигации работают только при отсутствии фокуса на поле ввода. Когда поле ввода активно — клавиши пишут текст как обычно.
Tab при открытой панели смайликов переключает группы, а не виды чата.
Видео: Навигация по категориям смайликов4.6. Работа со ссылкамиКопирование ссылок:ПКМ по ссылке — мгновенное копирование в буфер обмена
Цветовая маркировка ссылок:Ссылки в чате окрашены в разные цвета в зависимости от типа контента:
Синий цвет — обычные ссылки, открываются в браузере по
ЛКМЗелёный цвет — медиа-контент (изображения, видео):
•
ЛКМ — открытие в локальном просмотрщике
•
Ctrl + ЛКМ — открытие в браузере
Видео: Цветовая маркировка и открытие ссылок4.7. Прокрутка средней кнопкой мышиРеализована браузерная прокрутка с помощью средней кнопки мыши (СКМ):
СКМ (зажать и удерживать) — активация режима прокрутки
При удерживании СКМ и перемещении курсора вверх/вниз окно с сообщениями автоматически прокручивается в соответствующем направлении
Функция работает:
• В основном окне чата (сообщения)
• В чатлогах (история сообщений)
Видео: Прокрутка средней кнопкой мыши4.8. Фильтрация сообщений в логах чатаВ логах чата можно фильтровать сообщения по пользователям:
ЛКМ по пользователю в списке — отображение только его сообщений
Ctrl + ЛКМ — добавление пользователя к фильтру (отображаются сообщения нескольких выбранных пользователей)
Фильтрация сохраняется при переключении между логами разных дней.
Видео: Фильтрация сообщений в логах4.9. Навигация по дням в чатлогахУдобная навигация по истории сообщений с поддержкой нескольких способов управления:
Навигация кнопками:• Стрелки
< > в интерфейсе — переключение между днями
•
Боковые кнопки мыши (назад/вперёд) — навигация по дням
Навигация клавиатурой:•
← (стрелка влево) — предыдущий день
•
→ (стрелка вправо) — следующий день
•
H — предыдущий день
•
L — следующий день
Быстрая перемотка:При удержании кнопок навигации (клавиатура, мышь или интерфейс) дни пролистываются без рендеринга сообщений и списка пользователей, что позволяет быстро перемещаться по истории. Рендеринг происходит только после отпускания кнопки.
Видео: Навигация по дням в чатлогах4.10. Масштабирование размера шрифтаРеализована возможность изменения размера шрифта для комфортного чтения:
Ctrl + прокрутка СКМ (колёсико мыши) — увеличение/уменьшение размера шрифта
Ctrl + + — увеличение размера шрифта
Ctrl + - — уменьшение размера шрифта
Функция позволяет адаптировать интерфейс под ваши предпочтения и обеспечивает комфортное чтение текста на экранах с разным разрешением.
4.11. Горячие клавиши интерфейсаСледующие клавиши работают только когда фокус не находится в поле ввода сообщения:
F — перевести фокус на поле ввода сообщения
Esc — снять фокус с поля ввода
U — показать / скрыть список пользователей (работает для чата и чатлогов)
B — открыть / закрыть список банов
P — открыть / закрыть управление произношением никнеймов
M — включить / выключить звуковые эффекты
V — включить / выключить голосовое озвучивание сообщений
N — переключить режим уведомлений по циклу: Stack → Replace → Muted
T — включить / выключить режим "поверх всех окон"
R — сбросить размер и положение окна до значений по умолчанию
C — изменить цвет своего никнейма
Ctrl + C — сбросить цвет никнейма
Shift + C — обновить цвет никнейма с сервера
X — выйти из приватного режима
Space — прокрутить вниз на одну страницу
Shift + Space — прокрутить вверх на одну страницу
Следующие клавиши работают всегда, независимо от фокуса:
Ctrl + ; — открыть / закрыть панель смайликов (также снимает фокус с поля ввода при открытии)
Ctrl + U — сменить аккаунт
Ctrl + T — переключить тему оформления (светлая / тёмная)
Примечание: Когда панель смайликов открыта, клавиша
Tab переключает группы смайликов, а не виды чата. Стандартное поведение Tab восстанавливается после закрытия панели.
Vim-style прокрутка — работает в чате и чатлогах:J — прокрутить вниз
K — прокрутить вверх
gg — перейти в начало (двойное нажатие G)
Shift + G — перейти в конец
Дополнительные клавиши в режиме чатлогов:M — включить / выключить фильтр упоминаний (вместо звуковых эффектов)
P — открыть / закрыть парсер чатлогов
D — открыть выбор даты
S — открыть / закрыть поиск (или запустить парсинг если парсер открыт)
Esc — закрыть поиск если открыт
H — предыдущий день (поддерживает удержание)
L — следующий день (поддерживает удержание)
Ctrl + F — открыть / закрыть поиск (работает независимо от фокуса)
Ctrl + P — открыть чатлог и парсер из любого места
Ctrl + C — скопировать результаты парсинга (когда парсер открыт)
Ctrl + S — сохранить результаты парсинга в файл (когда парсер открыт)
C — отменить парсинг (когда идёт парсинг)
Примечание: Все клавиши, кроме
F,
Esc,
Ctrl+;,
Ctrl+U,
Ctrl+T и
Ctrl+F, работают только при отсутствии фокуса на поле ввода. Горячие клавиши не зависят от раскладки клавиатуры. Клавиши навигации смайликами (стрелки, H/J/K/L, Tab, Enter/A/;) активны только пока открыта панель смайликов и перехватывают приоритет у стандартных функций этих клавиш.
4.12. Горячие клавиши окна управления аккаунтамиРаздел Connect (подключение):Tab — переключить аккаунт в выпадающем списке
Enter / E — подключиться к чату
A — перейти к созданию аккаунта
D — удалить выбранный аккаунт
C — изменить цвет никнейма
Ctrl + C — сбросить цвет никнейма
Shift + C — обновить цвет никнейма с сервера
1 — переключить Auto-login
2 — переключить Start minimized
3 — переключить Start with system
Раздел Create (создание аккаунта):Tab — переключить фокус между полями Username и Password
Enter — сохранить аккаунт (когда поле ввода в фокусе)
Ctrl + S — сохранить аккаунт
Esc — вернуться в раздел Connect
Как запомнить: каждая клавиша — первая буква английского слова, связанного с функцией:
F —
Focus ·
U —
Userlist ·
B —
Ban ·
P —
Pronunciation /
Parser ·
M —
Mute /
Mentions
V —
Voice ·
N —
Notification ·
T —
Top /
Theme ·
R —
Reset ·
C —
Color /
Cancel
S —
Search /
Save ·
H —
History back ·
L — (vim-style: вперёд) ·
D —
Date /
Delete ·
X — e
Xit ·
A —
Add /
Act (insert emoticon)
J /
K /
gg /
G — vim-style прокрутка ·
; — вставить смайлик (мнемоника: та же клавиша что открывает панель)
═══════════════════════════════════════════5. Боковая панель кнопок═══════════════════════════════════════════Прокрутка панели кнопокПри ограниченной высоте окна чата, когда не все кнопки помещаются одновременно, доступна удобная прокрутка боковой панели:
Колёсико мыши — прокрутка панели кнопок вверх/вниз
СКМ (зажать и удерживать среднюю кнопку) — режим drag-прокрутки с перемещением курсора
Это позволяет получить доступ ко всем кнопкам независимо от высоты окна чата.
Видео: Прокрутка боковой панели кнопок5.1. Toggle User List (Переключатель списка пользователей)Кнопка позволяет скрывать и показывать список пользователей:
• В режиме чата — скрывает/показывает список участников чата
• В режиме логов — скрывает/показывает список пользователей в логах
Горячая клавиша:
UСписки управляются независимо друг от друга (скрытие в логах не влияет на чат и наоборот). Состояние сохраняется в конфигурационном файле приложения.
Видео: Переключение видимости списка пользователей5.2. Switch Account (Переключение аккаунта)Позволяет мгновенно переключаться между разными аккаунтами без закрытия приложения. При нажатии окно чата скрывается и открывается окно авторизации.
Видео: Переключение аккаунта5.3. Show Ban List (Список игнорируемых пользователей)Позволяет добавлять пользователей в игнор-список:
• При вводе неверного никнейма поле окантовывается красной обводкой
• При успешном добавлении поле остаётся без красной обводки, а ID пользователя отображается в нередактируемом поле справа
• Заблокированные пользователи не отображаются в списках участников чата и логов
• Их сообщения скрываются из чата и логов
Важно: Для полного применения изменений необходимо перезагрузить чат.
Горячая клавиша:
BВидео: Добавление пользователя в бан-лист5.4. Toggle Voice Sound / Username PronunciationКомплексная кнопка управления голосовым озвучиванием:
ЛКМ — включение/отключение голосового синтеза (gTTS)
Ctrl + ЛКМ — открытие окна редактирования произношения никнеймов (можно задать кастомное произношение для любого пользователя)
Горячие клавиши:
V — переключить синтез,
P — открыть произношение
Видео: Управление голосовым синтезом и произношением5.5. Effects Sound (Звуковые эффекты)Включает и отключает звуковые эффекты в чате:
• Звук при бане пользователя (Mario Game Over)
• Звук упоминания при обращении к вам по нику
Примечание: Эта кнопка не управляет голосовым синтезом (Toggle Voice Sound) — для полной тишины отключите обе функции.
Горячая клавиша:
MВидео: Переключение звуковых эффектов5.6. Notifications (Режимы уведомлений)Управление всплывающими уведомлениями с тремя режимами:
Stack — уведомления выстраиваются в очередь одно за другим
Replace — каждое новое уведомление заменяет предыдущее (удобно при просмотре фильмов, видео и т.д.)
Muted — уведомления полностью отключены
Горячая клавиша:
N — цикличное переключение режимов
Видео: Переключение режимов уведомленийРежим StackРежим Replace5.7. Change Username Color (Изменение цвета никнейма)Позволяет управлять цветом собственного никнейма:
ЛКМ — изменение цвета никнейма (вплоть до белого)
Ctrl + ЛКМ — восстановление оригинального цвета
Shift + ЛКМ — обновление цвета и аватара с сервера
Горячие клавиши:
C — изменить,
Ctrl + C — сбросить,
Shift + C — обновить с сервера
Данные сохраняются в
KG_Chat_Data > accounts > accounts.dbВажно: Изменение цвета на белый создаёт эффект невидимости ника — не рекомендуется злоупотреблять.
5.8. Switch to Light/Dark Mode (Переключение темы)Переключение между светлой и тёмной темами оформления.
Видео: Переключение темы5.9. Reset Window Size and Position to Default (Сброс размера и позиции окна)Окно чата умеет запоминать размер и позицию, которые были установлены в результате ручного изменения пользователем.
Сохранение и применение пресетов:Кнопка поддерживает сохранение пресетов расположения и размера окна чата для быстрого применения. Меню с пресетами открывается по правому клику на кнопке сброса настроек. Левый клик восстанавливает параметры по умолчанию.
Горячая клавиша:
R — сбросить размер и положение окна
Видео: Сохранение и применение пресетовУправление пресетами:Пресеты можно удалять по одному или группой, используя выделение мышью либо клавиши Ctrl/Shift.
Видео: Удаление пресетовВидео: Сброс размера и позиции окна чата5.10. Always on Top (Всегда поверх других окон)Переключение режима "Всегда поверх других окон":
• Включено — окно чата всегда отображается поверх всех остальных окон
• Выключено — окно чата ведёт себя как обычное окно приложения
Горячая клавиша:
TСкриншот: Режим "Всегда поверх других окон"5.11. Exit (Закрытие приложения)Полное завершение работы приложения (не сворачивание в трей). Альтернативный способ выхода помимо команды "Exit" в меню трея.
Видео: Закрытие приложения5.12. Reconnect (Переподключение к чату)Система автоматического переподключения при потере связи с чатом:
Автоматическое переподключение:При потере соединения система автоматически предпринимает до 10 попыток восстановления связи с экспоненциально увеличивающейся задержкой от 1 до 60 секунд между попытками.
Ручное переподключение:При обрыве соединения в боковой панели автоматически появляется кнопка переподключения, которая позволяет немедленно восстановить связь без ожидания следующей автоматической попытки.
Кнопка отображается только при потере соединения и автоматически исчезает после успешного переподключения.
Скриншот: Кнопка переподключения к чату Последний раз отредактировано 21 февраля 2026 в 00:22 пользователем ПОТРОШИТЕЛЬЧАТА