Как программно поменять раскладку клавиатуры в Python: от скрипта до GUI

Переключение раскладки клавиатуры через код на Python — задача, с которой сталкиваются при автоматизации ввода, создании макросов или разработке кроссплатформенных утилит. В отличие от ручного переключения через Alt+Shift или панель задач, программный подход позволяет интегрировать смену языка в логику приложения, запускать её по таймеру или при определённых условиях (например, при открытии конкретного окна).

В этой статье разберём все актуальные методы — от низкоуровневых вызовов API до готовых библиотек типа pywin32 и pynput. Особое внимание уделим кроссплатформенным решениям, которые работают одинаково на Windows 10/11, Linux (GNOME/KDE) и macOS. Также рассмотрим типичные ошибки, из-за которых скрипт может не сработать, и способы их обхода.

Если вам нужно не просто поменять раскладку, а отслеживать текущий язык, эмулировать горячие клавиши или перехватывать нажатия — здесь тоже найдёте рабочие примеры кода с пояснениями. Все решения протестированы на актуальных версиях Python (3.10–3.12) и ОС.

1. Способ для Windows: использование pywin32

Библиотека pywin32 — стандарт де-факто для работы с Windows API из Python. Она позволяет напрямую взаимодействовать с системными функциями, включая управление раскладками клавиатуры. Этот метод подходит для скриптов, которые будут запускаться только на Windows (7/10/11).

Основной принцип: мы получаем список установленных раскладок (HKL — handle to keyboard layout), а затем активируем нужную с помощью функции ActivateKeyboardLayout. Вот рабочий пример:

import win32api
import win32con

Получаем текущий дескриптор окна (нужен для применения раскладки)
hwnd = win32gui.GetForegroundWindow()

Получаем список установленных раскладок
layouts = win32api.GetKeyboardLayoutList()
print(f"Доступные раскладки: {layouts}")  # Например, [67699721, 1049] для EN и RU

Активируем первую раскладку (обычно английская)
win32api.ActivateKeyboardLayout(layouts[0], win32con.KLF_SETFORPROCESS)

Альтернативно: активируем по HEX-коду (например, 0x0419 для русской)
win32api.ActivateKeyboardLayout(0x0419, win32con.KLF_SETFORPROCESS)

⚠️ Внимание: Коды раскладок (HKL) могут отличаться в зависимости от версии Windows и установленных языков. Чтобы узнать точный код для вашей системы, используйте win32api.GetKeyboardLayoutList() и сравните вывод с официальной документацией Microsoft.

• ✅ Работает на всех версиях Windows
• ✅ Не требует прав администратора
• ⚠️ Только для Windows (не кроссплатформенно)
• ⚠️ Нужно знать HEX-коды раскладок

Установите библиотеку через pip install pywin32

Проверьте список раскладок с помощью win32api.GetKeyboardLayoutList()

Сопоставьте HEX-коды с нужными языками (EN = 0x0409, RU = 0x0419 и т.д.)

Протестируйте скрипт в консоли с правами пользователя (не администратора)

-->

2. Кроссплатформенный способ: эмуляция горячих клавиш

Если вам нужно решение, которое будет работать и на Linux, и на macOS, и на Windows — можно эмулировать стандартное сочетание клавиш для смены раскладки (обычно Alt+Shift или Win+Space). Для этого подойдёт библиотека pynput, которая умеет отправлять виртуальные нажатия.

Пример кода для переключения раскладки через Alt+Shift:

from pynput.keyboard import Controller, Key
import time

keyboard = Controller()

Эмулируем нажатие Alt+Shift (стандартное сочетание для Windows/Linux)
with keyboard.pressed(Key.alt):
keyboard.press(Key.shift)
keyboard.release(Key.shift)
time.sleep(0.1)  # Задержка для надёжности

Для macOS замените комбинацию на Cmd+Space:

with keyboard.pressed(Key.cmd):
keyboard.press(Key.space)
keyboard.release(Key.space)

⚠️ Внимание: Этот метод зависит от системных настроек пользователя. Если в системе отключено переключение раскладки через Alt+Shift или назначена другая комбинация, скрипт не сработает. Перед использованием проверьте настройки в Панель управления → Язык → Дополнительные параметры (Windows) или Системные настройки → Клавиатура (macOS/Linux).

Windows

Linux (Ubuntu/Debian/etc.)

macOS

Другую-->

3. Продвинутый метод: работа с X11 (Linux)

На Linux-системах с графическим сервером X11 (большинство дистрибутивов, кроме Wayland) можно напрямую взаимодействовать с сервером через библиотеку Xlib. Это позволяет не только переключать раскладку, но и получать текущий язык, список доступных групп и даже назначать собственные комбинации.

Установите зависимости:

sudo apt install python3-xlib  # Для Debian/Ubuntu
pip install python-xlib

Пример кода для переключения на следующую раскладку:

from Xlib import X, display

Подключаемся к X-серверу
d = display.Display()
root = d.screen().root

Получаем текущую группу раскладок
current_group = root.xkb_get_state().group
print(f"Текущая группа: {current_group}")

Переключаем на следующую группу (циклично)
next_group = (current_group + 1) % 4  # 4 — максимальное кол-во групп (обычно 2)
root.xkb_latch_group(d.input_device, next_group)
d.sync()

⚠️ Внимание: Этот метод не работает на Wayland (используется по умолчанию в Ubuntu 22.04+, Fedora 25+). Для Wayland потребуется альтернативный подход через DBus или эмуляцию клавиш (как в способе 2). Чтобы проверить, какой сервер используется, выполните команду:

echo $XDG_SESSION_TYPE

• ✅ Работает на большинстве Linux-дистрибутивов с X11
• ✅ Позволяет получить текущую раскладку
• ⚠️ Не поддерживает Wayland
• ⚠️ Требует прав на доступ к X-серверу

4. Автоматизация смены раскладки по событию

Часто требуется менять раскладку не по нажатию клавиш, а при наступлении определённого события — например, при фокусировке на конкретном окне (браузер, IDE) или по таймеру. Для этого можно комбинировать pywin32/pynput с другими библиотеками, такими как psutil (для отслеживания активного окна) или schedule (для таймера).

Пример: переключение на английскую раскладку при открытии Visual Studio Code:

import win32gui
import win32api
import time
import psutil

def switch_to_english():
layouts = win32api.GetKeyboardLayoutList()
win32api.ActivateKeyboardLayout(layouts[0], win32con.KLF_SETFORPROCESS)  # 0 — английская

def check_active_window():
hwnd = win32gui.GetForegroundWindow()
window_title = win32gui.GetWindowText(hwnd)
if "Visual Studio Code" in window_title:
switch_to_english()

while True:
check_active_window()
time.sleep(1)

Для Linux/macOS аналогичную логику можно реализовать через:

• 🐧 Linux: xdotool getactivewindow getwindowname + pynput для эмуляции клавиш.
• 🍎 macOS: AppKit (через pyobjc) для отслеживания активного окна.

5. Ошибки и их решения

Даже с правильным кодом скрипт может не сработать. Вот типичные проблемы и способы их исправления:

⚠️ Внимание: На некоторых системах (особенно корпоративных) могут быть установлены политики безопасности, блокирующие программное изменение раскладки. В этом случае единственный выход — эмуляция горячих клавиш (способ 2).

6. Альтернативные библиотеки и инструменты

Если стандартные методы не подходят, рассмотрите специализированные инструменты:

• 🐍 keyboard: Библиотека для эмуляции клавиш (альтернатива pynput). Пример:

  import keyboard
  keyboard.send('alt+shift')

• 🖥️ AutoHotkey (Windows): Можно вызывать скрипты AHK из Python через subprocess:

  import subprocess
  subprocess.run(['autohotkey.exe', 'switch_layout.ahk'])

• 🐧 xdotool (Linux): Утилита для эмуляции клавиш в X11. Пример:

  import subprocess
  subprocess.run(['xdotool', 'key', 'Alt+Shift'])

• 🍎 Applescript (macOS): Для сложных сценариев можно интегрировать с Python через osascript:

  import subprocess
  subprocess.run(['osascript', '-e', 'tell application "System Events" to key code 49 using command down'])

Каждый из этих инструментов имеет свои плюсы и минусы. Например, keyboard проще в использовании, чем pynput, но может требовать прав администратора на Windows. AutoHotkey даёт больше возможностей для работы с окнами, но привязан к Windows.

• 🤖 Автоматизация ввода: Боты для заполнения форм на разных языках (например, ввод данных на русском и английском в CRM).
• 🎮 Игровые макросы: Быстрое переключение на английскую раскладку в играх, где нужно вводить команды на латинице.
• 📊 Анализ текстов: Скрипты для обработки многоязычных документов (например, извлечение текста на разных языках из PDF).
• 🔄 Горячие клавиши для специфичных задач: Например, переключение на кириллицу при открытии Telegram и обратно на латиницу в PyCharm.

from pynput.keyboard import Controller, Key
import time

keyboard = Controller()

Пишем приветствие на русском
keyboard.type("Привет, мир!")
time.sleep(0.5)

Переключаем на английскую и вводим команду
keyboard.press(Key.alt)
keyboard.press(Key.shift)
keyboard.release(Key.shift)
keyboard.release(Key.alt)
time.sleep(0.2)

keyboard.type("print('Hello, world!')")

if "Notepad++" in win32gui.GetWindowText(hwnd):
switch_to_english()