KlipperScreen 확장 기능
KlipperScreen 마우스 커서 활성화 방법
- 프린터 구성 파일에서
KlipperScreen.conf를 엽니다. 이 파일은 일반적으로 KlipperScreen 설치 후 자동으로 생성되며, 없을 경우 직접 생성하세요.
- 아래 코드를 구성 파일 상단에 추가합니다.
[main]
show_cursor: True
- 저장 후 다시 시작합니다.
다른 상위 컴퓨터에 원격 연결
- 프린터 구성에서
KlipperScreen.conf를 엽니다.
- 아래 코드를 구성 최상단에 추가합니다.
<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은 시스템 언어를 따르는 것을 의미합니다.
화면에서 전환
설정 → 언어에 들어가서 선택하면 되며, 전환 후 인터페이스가 즉시 새로고침되어 재시작이 필요 없습니다. 아래 그림은 영어 인터페이스를 예로 든 것입니다:
언어 목록은 코드순으로 정렬되어 있으며, 중국어 간체는 zh_CN, 중국어 번체는 zh_TW를 선택합니다:
화면에서 언어, 테마 등의 옵션을 전환하면 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 | 중국어 번체 |
일본어는 ja가 아닌 jp를 사용합니다. 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 | LED |
[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] | 인쇄 | |
[menu __main temperature] | Temperature | 온도 |
[menu __print camera] | Camera | 카메라 |
[menu __print console] | Console | 콘솔 |
[menu __print extrude] | Extrude | 압출 |
[menu __print fan] | Fan | 팬 |
[menu __print led] | Leds | LED |
[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 ...] 정의를 기준으로 합니다.