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 为正式德语。

隐藏某个菜单选项

菜单项由 KlipperScreen.conf 里的 [menu ...] 段定义，段名用空格表示层级。例如主菜单 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轴倾斜校准

自定义菜单

自定义菜单的段名以 KlipperScreen.conf 中的 [menu ...] 定义为准。