メインコンテンツにスキップ

KlipperScreen 拡張機能

KlipperScreenのマウスカーソルを表示する方法​

  • プリンター設定の KlipperScreen.conf を開きます。このファイルは通常、KlipperScreenのインストール後に自動生成されます。ない場合は自分で作成してください。
Loading...
  • 以下のコードを設定の最上部に追加します。
[main]
show_cursor: True
Loading...
  • 保存して再起動します。

他の上位機へのリモート接続​

  • プリンター設定の KlipperScreen.conf を開きます。
Loading...
  • 以下のコードを設定の最上部に追加します。
  • <printer_name> のプリンター名と <moonraker_host> のターゲットマシンの IP アドレスを変更できます。
  • 最初の [printer <printer_name>] はリモート拡張されたマシンへの接続に使用され、この設定を通じてデバッグやシャットダウンが可能です。
  • 2番目の [printer KlipperScreen] は本機（127.0.0.1）を指しており、デフォルトのままにしてください。
注意

2台のデバイスが同じローカルエリアネットワーク内にあることを確認してください。

[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繁体字中国語
コードの説明

日本語は 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_sectionsprinter.cfg で設定済みのセクション名リスト
printer.gcode_macros.list定義済みの G-code マクロ名リスト
printer.extruders.countエクストルーダー数
printer.fans.countファン数
printer.leds.countLED 数
moonraker.cameras.countカメラ数
moonraker.power_devices.count電源デバイス数

FlyOS ではさらに flylcd_exists（Fly-LCD が接続されているか）、wifi_exists（無線 LAN カードがあるか）、oem_name（OEM 名）が提供されます。

サブメニュー全体を非表示にする​

親メニューの enable を False に設定すると、サブメニュー全体を非表示にできます。例えば More メニューを非表示にするには：

[menu __main more]
enable: False

下表は KlipperScreen に付属するすべてのメニュー項目をセクション名のアルファベット順に示したものです：__main はメインメニュー、__print は印刷中メニュー、__splashscreen は起動画面、move homing は移動メニューのホーミングサブメニューです。[menu __main]、[menu __print]、[menu __splashscreen] の 3 つのルートノードは非表示可能な項目としては掲載していません。中国語名は zh_CN 言語パックから取得したもので、他の UI 言語に切り替えると対応する訳文が表示されます。

セクション名メニュー項目中国語名
[menu __main extrude]Extrude押し出し
[menu __main gcodes]GcodesGコード
[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]LedsLED
[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]KlipperScreenKlipperScreen
[menu __main more spoolman]SpoolmanSpoolman
[menu __main more system]Systemシステム
[menu __main more updater]Update更新
[menu __main more zoffset]Z CalibrateZオフセットキャリブレーション
[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]LedsLED
[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]KlipperScreenKlipperScreen
[menu __print spoolman]SpoolmanSpoolman
[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]KlipperScreenKlipperScreen
[menu __splashscreen system]Systemシステム
[menu __splashscreen updater]Update更新
[menu move homing homeall]Home All全軸ホーミング
[menu move homing homex]Home XX軸ホーミング
[menu move homing homexy]Home XYXY軸ホーミング
[menu move homing homey]Home YY軸ホーミング
[menu move homing homez]Home ZZ軸ホーミング
[menu move homing quad_gantry_level]Quad Gantry Levelガントリーレベリング
[menu move homing Z-Tilt]Z TiltZ軸チルトキャリブレーション
カスタムメニュー

カスタムメニューのセクション名は KlipperScreen.conf 内の [menu ...] の定義に準じます。

Loading...