Что получится
wifi-qr\
.venv\ окружение: свой python и пакеты qrcode, pillow
wifi_qr.py скрипт
wifi-guest.png картинка для печати или для экрана
Скрипт печатает строку для QR-кода, рисует код прямо в терминале и сохраняет PNG.
По шагам
Создаём окружение
mkdir wifi-qr cd wifi-qr python -m venv .venvВ папке появилась
.venv— копия интерпретатора со своим списком пакетов. Пакеты, поставленные сюда, не видны системному Python и другим проектам.Ставим пакет
.venv\Scripts\python -m pip install "qrcode[pil]" # Successfully installed colorama-0.4.6 pillow-13.0.0 qrcode-8.2На Linux и macOS путь другой:
.venv/bin/python.[pil]— ставим вместе с Pillow, без него PNG не сохранить.Пишем скрипт
Файл
wifi_qr.pyв той же папке; имя сети и пароль — свои:import qrcode SSID = "Guest" PASSWORD = "tea-and-cookies-42" SECURITY = "WPA" # WPA подходит и для WPA2, и для WPA3; сеть без пароля — "nopass" def escape(text): """Символы \\ ; , : " в формате WIFI: экранируются обратной косой чертой.""" for char in '\\;,:"': text = text.replace(char, "\\" + char) return text data = f"WIFI:T:{SECURITY};S:{escape(SSID)};P:{escape(PASSWORD)};;" print(data) qr = qrcode.QRCode(border=2) qr.add_data(data) qr.print_ascii(invert=True) image = qr.make_image() image.save("wifi-guest.png") print("Сохранено: wifi-guest.png")Запускаем
.venv\Scripts\python wifi_qr.py # WIFI:T:WPA;S:Guest;P:tea-and-cookies-42;; # …QR-код символами… # Сохранено: wifi-guest.pngНаводим камеру телефона на код в терминале или на
wifi-guest.png— телефон предлагает подключиться кGuest.
Что здесь нового
- Пакеты:
pip. Всё, чего нет в стандартной библиотеке, ставят из каталога PyPI командойpip. Запускаем его как модуль нужного интерпретатора —python -m pip, — тогда пакет точно ляжет туда, откуда его будут импортировать. Голыйpipможет оказаться от другого Python. - Виртуальное окружение.
python -m venv .venvделает папку с отдельным Python для проекта. Пакеты одного проекта не мешают другому, а лишнее удаляется вместе с папкой. Окружение не переносят: на другом компьютере его создают заново.
Формат строки WIFI
WIFI:T:WPA;S:Guest;P:пароль;; — тип защиты, имя сети, пароль, в конце две точки с запятой. Если в имени или
пароле есть \, ;, ,, : или ", их нужно экранировать — это делает функция escape. Скрытая сеть —
добавляем H:true; перед ;;.
Пароль лежит в скрипте открытым текстом, поэтому QR-код — для гостевой сети, отделённой от домашних устройств («Гостевая сеть на MikroTik»).
Если не работает
ModuleNotFoundError: No module named 'qrcode'
- Причина
- Скрипт запущен системным
python, а пакет стоит в.venv: у каждого окружения свои пакеты. - Делаем
- Запускаем через окружение:
.venv\Scripts\python wifi_qr.py(Linux, macOS —.venv/bin/python).
ModuleNotFoundError: No module named 'PIL' на строке make_image
- Причина
- Поставлен
qrcodeбез Pillow: код в терминал он печатает, а PNG рисует через Pillow. - Делаем
.venv\Scripts\python -m pip install "qrcode[pil]"— в квадратных скобках дополнительная часть пакета.
Activate.ps1 cannot be loaded because running scripts is disabled on this system
- Причина
- PowerShell по умолчанию не запускает скрипты, а активация окружения — скрипт
.ps1. - Делаем
- Активация не обязательна: вызываем
pythonокружения по пути, как в материале. Нужна —Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
error: externally-managed-environment при pip install на Ubuntu
- Причина
- Ubuntu 23.04 и новее не дают ставить пакеты в системный Python (PEP 668).
- Делаем
- Ставим в окружение, как здесь:
python3 -m venv .venv, потом.venv/bin/python -m pip install "qrcode[pil]".
Камера видит код, но к сети не подключается
- Причина
- Опечатка в имени сети или пароле: регистр важен,
Guestиguest— разные сети. - Делаем
- Сверяем строку
WIFI:…, которую скрипт печатает первой, с настройками роутера.
Как проверить
Телефон, который ещё не знает эту сеть, сканирует wifi-guest.png камерой и подключается без ввода пароля.