【亲测免费】 KlipperScreen 安装和配置指南

1. 项目基础介绍和主要编程语言

项目基础介绍

KlipperScreen 是一个基于 Klipper 和 Moonraker 的触摸屏图形用户界面（GUI）。它允许用户通过触摸屏界面与 Klipper 3D 打印机控制软件进行交互，支持多台打印机的管理和操作。KlipperScreen 可以在不同的设备上运行，如 Raspberry Pi、PC 或平板电脑，并且可以通过配置 IP 地址连接到打印机。

主要编程语言

KlipperScreen 主要使用 Python 进行开发，同时也使用了 CSS 和 Shell 脚本进行界面设计和系统配置。

2. 项目使用的关键技术和框架

关键技术

• Klipper: 一个基于微控制器的 3D 打印机固件，提供高性能的打印控制。
• Moonraker: 一个用于 Klipper 的 API 服务器，提供与 Klipper 的通信接口。
• Python: 主要编程语言，用于开发 GUI 和逻辑处理。
• CSS: 用于界面样式设计。
• Shell 脚本: 用于系统配置和安装脚本。

框架

• Kivy: 一个开源的 Python 库，用于开发多点触控应用程序，KlipperScreen 使用 Kivy 构建其图形界面。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

1. 硬件要求:

   • 一台支持触摸屏的设备（如 Raspberry Pi、PC 或平板电脑）。
   • 连接到 Klipper 和 Moonraker 的 3D 打印机。

2. 软件要求:

   • 安装了 Klipper 和 Moonraker 的设备。
   • Python 3.x 和 pip。
   • Git（用于克隆项目代码）。

详细安装步骤

步骤 1: 克隆 KlipperScreen 项目

首先，使用 Git 克隆 KlipperScreen 项目到你的设备上：

git clone https://github.com/KlipperScreen/KlipperScreen.git
cd KlipperScreen

步骤 2: 安装依赖

进入项目目录后，安装所需的 Python 依赖包：

pip install -r requirements.txt

步骤 3: 配置 Moonraker

确保你的 Moonraker 配置文件中包含 KlipperScreen 的 API 访问权限。编辑 moonraker.conf 文件，添加以下内容：

[authorization]
trusted_clients:
  - 127.0.0.1
  - 192.168.1.0/24  # 替换为你的网络子网

步骤 4: 配置 KlipperScreen

编辑 KlipperScreen 的配置文件 KlipperScreen.conf，配置连接到 Moonraker 的 IP 地址和端口：

[server]
url = http://192.168.1.2:7125  # 替换为你的 Moonraker 地址和端口

步骤 5: 启动 KlipperScreen

完成配置后，启动 KlipperScreen：

python screen.py

步骤 6: 测试和调试

启动后，KlipperScreen 应该会显示一个触摸屏界面。你可以通过触摸屏进行打印机的操作和监控。如果遇到问题，可以查看日志文件进行调试。

常见问题和解决方案

• 屏幕不显示: 检查 Moonraker 和 Klipper 是否正常运行，确保 IP 地址和端口配置正确。
• 触摸不灵敏: 确保触摸屏驱动正确安装，并检查 Kivy 配置文件中的触摸设置。

通过以上步骤，你应该能够成功安装和配置 KlipperScreen，并开始使用其强大的触摸屏界面来管理你的 Klipper 3D 打印机。