Расширенные функции KlipperScreen

Как включить курсор мыши в KlipperScreen

• Откройте KlipperScreen.conf в конфигурации принтера. Этот файл обычно создаётся автоматически после установки KlipperScreen, если его нет — создайте вручную.

Loading...

• Добавьте следующий код в начало конфигурации.

[main]
show_cursor: True

Loading...

• Сохраните и перезагрузите.

Удаленное подключение к другому главному компьютеру

• Откройте KlipperScreen.conf в конфигурации принтера.

Loading...

• Добавьте приведенный ниже код в самый верх конфигурации.
• Можно изменить <printer_name> — имя принтера, и <moonraker_host> — IP-адрес целевой машины.
• Первый [printer <printer_name>] используется для подключения к удаленной расширенной машине; через эту конфигурацию можно выполнять отладку или выключение.
• Второй [printer KlipperScreen] указывает на локальную машину (127.0.0.1), оставьте его по умолчанию.

Внимание

Убедитесь, что оба устройства находятся в одной локальной сети.

[printer <printer_name>]
moonraker_host: <moonraker_host>
moonraker_port: 7125
moonraker_api_key: False

[printer KlipperScreen]
moonraker_host: 127.0.0.1
moonraker_port: 7125
moonraker_api_key: False

Языковые настройки

KlipperScreen поддерживает 32 языка интерфейса, которые можно переключать прямо на экране; параметр system_lang в списке означает следование системному языку.

Переключение на экране

Перейдите в Настройки → Язык и выберите нужный — интерфейс обновится сразу, перезагрузка не требуется. На изображении ниже показан английский интерфейс:

Loading...

Список языков упорядочен по кодам: для упрощённого китайского выберите zh_CN, для традиционного китайского — zh_TW:

Loading...

Автоматически создаваемый раздел перезаписывает ручную конфигурацию

После переключения языка, темы и других параметров на экране KlipperScreen записывает текущие значения в автоматически создаваемый раздел в конце KlipperScreen.conf после строки #~# --- Do not edit below this line ---. Этот раздел читается после файла конфигурации и имеет более высокий приоритет.

Если после ручного изменения language интерфейс не меняется, проверьте, есть ли в конце файла строка #~# language: ...: если есть — измените её на нужный язык или удалите строку и перезагрузите систему.

Поддерживаемые языки

Код	Язык	Код	Язык
ar	Арабский	bg	Болгарский
cs	Чешский	da	Датский
de	Немецкий	de_formal	Немецкий (официальный)
en	Английский	es	Испанский
et	Эстонский	fa	Персидский
fr	Французский	he	Иврит
hr	Хорватский	hu	Венгерский
it	Итальянский	jp	Японский
ko	Корейский	lt	Литовский
nl	Нидерландский	pl	Польский
pt	Португальский	pt_BR	Португальский (Бразилия)
rs	Сербский	ru	Русский
sk	Словацкий	sl	Словенский
sv	Шведский	tr	Турецкий
uk	Украинский	vi	Вьетнамский
zh_CN	Упрощённый китайский	zh_TW	Традиционный китайский

Пояснение кодов

Для японского используется jp, а не ja; de_formal — официальный немецкий.

Скрытие пункта меню

Пункты меню определяются секциями [menu ...] в KlipperScreen.conf, где иерархия обозначается пробелами в имени секции. Например, главное меню More → Z Calibrate соответствует:

[menu __main more zoffset]
name: {{ gettext('Z Calibrate') }}
icon: z-farther
panel: zcalibrate

Чтобы скрыть его, добавьте в KlipperScreen.conf секцию с тем же именем, указав только enable:

[menu __main more zoffset]
enable: False

• Пользовательская конфигурация объединяется со встроенным меню, поэтому name, icon и panel повторно указывать не нужно — достаточно переопределить enable.
• Имя секции должно точно совпадать со встроенным меню (__main нельзя записывать как main, регистр и иерархия не должны изменяться). При ошибке в имени секции исходный пункт не будет переопределён, а может появиться лишний безымянный пункт меню, что приведёт к некорректному отображению панели меню.
• После сохранения перезапустите KlipperScreen:

sudo systemctl restart klipperscreen

Условное скрытие

enable поддерживает выражения Jinja2, позволяя автоматически показывать или скрывать пункты в зависимости от конфигурации или состояния принтера:

[menu __main more bedmesh]
enable: {{ 'bed_mesh' in printer.config_sections }}

[menu __main more fan]
enable: {{ printer.fans.count > 0 }}

Часто используемые переменные:

Переменная	Значение
printer.config_sections	Список имён секций, настроенных в printer.cfg
printer.gcode_macros.list	Список имён определённых G-code макросов
printer.extruders.count	Количество экструдеров
printer.fans.count	Количество вентиляторов
printer.leds.count	Количество LED
moonraker.cameras.count	Количество камер
moonraker.power_devices.count	Количество устройств питания

FlyOS дополнительно предоставляет flylcd_exists (подключён ли Fly-LCD), wifi_exists (наличие беспроводного адаптера) и oem_name (название OEM).

Скрытие всего подменю

Установите enable родительского меню в False, чтобы скрыть всё подменю. Например, чтобы скрыть меню More:

[menu __main more]
enable: False

Обзор имён встроенных секций меню

В таблице ниже перечислены все пункты меню KlipperScreen в алфавитном порядке имён секций: __main — главное меню, __print — меню печати, __splashscreen — экран загрузки, move homing — подменю парковки в меню перемещения. Три корневых узла [menu __main], [menu __print], [menu __splashscreen] не перечислены как скрываемые элементы; китайские названия взяты из языкового пакета zh_CN, при переключении на другой язык интерфейса отображается соответствующий перевод.

Имя секции	Пункт меню	Китайское название
[menu __main extrude]	Extrude	Экструзия
[menu __main gcodes]	Gcodes	G-коды
[menu __main more]	More	Дополнительные настройки
[menu __main more bedlevel]	Bed Level	Калибровка стола
[menu __main more bedmesh]	Bed Mesh	Сетка стола
[menu __main more camera]	Camera	Камера
[menu __main more console]	Console	Консоль
[menu __main more fan]	Fan	Вентилятор
[menu __main more fine_tune]	Fine Tuning	Тонкая настройка
[menu __main more fly_lcd]	Display Settings	Настройки экрана
[menu __main more input_shaper]	Input Shaper	Компенсация резонанса
[menu __main more led]	Leds	Подсветка
[menu __main more limits]	Limits	Ограничения принтера
[menu __main more macros]	Macros	Макросы
[menu __main more network]	Network	Сеть
[menu __main more notifications]	Notifications	Уведомления
[menu __main more pins]	Pins	Пины
[menu __main more power]	Power	Питание
[menu __main more save]	Save Config	Сохранить конфигурацию
[menu __main more settings]	KlipperScreen	KlipperScreen
[menu __main more spoolman]	Spoolman	Spoolman
[menu __main more system]	System	Система
[menu __main more updater]	Update	Обновление
[menu __main more zoffset]	Z Calibrate	Калибровка Z-смещения
[menu __main move]	Move	Перемещение
[menu __main print]	Print	Печать
[menu __main temperature]	Temperature	Температура
[menu __print camera]	Camera	Камера
[menu __print console]	Console	Консоль
[menu __print extrude]	Extrude	Экструзия
[menu __print fan]	Fan	Вентилятор
[menu __print led]	Leds	Подсветка
[menu __print limits]	Limits	Ограничения принтера
[menu __print lock]	Lock	Блокировка
[menu __print macros]	Macros	Макросы
[menu __print more fly_lcd]	Display Settings	Настройки экрана
[menu __print move]	Move	Перемещение
[menu __print network]	Network	Сеть
[menu __print notifications]	Notifications	Уведомления
[menu __print pins]	Pins	Пины
[menu __print power]	Power	Питание
[menu __print settings]	KlipperScreen	KlipperScreen
[menu __print spoolman]	Spoolman	Spoolman
[menu __print system]	System	Система
[menu __print temperature]	Temperature	Температура
[menu __splashscreen fly_lcd]	Display Settings	Настройки экрана
[menu __splashscreen network]	Network	Сеть
[menu __splashscreen power]	Power	Питание
[menu __splashscreen settings]	KlipperScreen	KlipperScreen
[menu __splashscreen system]	System	Система
[menu __splashscreen updater]	Update	Обновление
[menu move homing homeall]	Home All	Парковка всех осей
[menu move homing homex]	Home X	Парковка по X
[menu move homing homexy]	Home XY	Парковка по XY
[menu move homing homey]	Home Y	Парковка по Y
[menu move homing homez]	Home Z	Парковка по Z
[menu move homing quad_gantry_level]	Quad Gantry Level	Выравнивание портала
[menu move homing Z-Tilt]	Z Tilt	Калибровка наклона оси Z

Пользовательские меню

Имена секций пользовательских меню определяются секциями [menu ...] в KlipperScreen.conf.