Mainsail

项目简介

Mainsail is the popular web interface for managing and controlling 3D printers with Klipper.

Mainsail 是一个专为 Klipper 固件打造的轻量级、响应式 Web 用户界面，旨在让 3D 打印机的操控变得更加直观和便捷。它解决了传统 3D 打印机控制界面操作复杂、界面不够友好、以及难以在移动设备上流畅使用的问题。通过 Mainsail，用户无需依赖笨重的桌面软件，只需通过浏览器即可随时随地监控和管理打印机。

项目特点

**响应式 Web 界面**：针对桌面、平板和移动设备进行了优化。

**打印机农场支持**：支持管理多台 3D 打印机。

**多语言支持**：提供 12 种不同语言。

**文件管理器**：可删除、重命名和上传 G-Code 及配置文件。

**文件编辑器**：在浏览器中编辑 G-Code 和配置文件，支持语法高亮。

**打印历史与统计**：查看历史打印任务及其状态，统计打印机使用时间和任务成功率。

**作业队列**：可排队多个打印任务，并直接从切片软件添加。

**温度预设**：管理不同的温度预设，方便预热。

**热床网格可视化**：使用 3D 网格图查看热床状态。

**G-Code 查看器**：以 3D 渲染方式查看打印模型并跟踪进度。

**多摄像头支持**：通过多个摄像头从不同角度查看打印过程。

**延时摄影集成**：自动录制打印过程的延时摄影。

**电源控制**：控制继电器、TP-Link 和 Tasmota 等电源设备。

**强大的宏管理**：精细管理宏。

**可配置仪表盘**：创建个性化仪表盘。

**主题支持**：可自定义用户界面，包括 Logo、背景和自定义 CSS。

**额外传感器**：向温度图表添加额外传感器。

**排除对象**：排除打印中的部分对象。

技术规格

目标平台
后端依赖
前端框架
界面语言
部署方式
许可证

项目资源

mainsail-crew/mainsail /docs.mainsail.xyz docs.mainsail.xyz/setup /my.mainsail.xyz discord.gg/skWTwTD www.patreon.com/meteyou ko-fi.com/mainsail

物料清单 (BOM)

物料名称	数量	参考价格	备注
运行 Klipper 的 3D 打印机	1	—	核心硬件
Moonraker	1	—	Klipper API 后端
Mainsail 前端	1	—	本项目的 Web 界面
网络摄像头	1+	—	用于多摄像头监控
电源控制设备	1+	—	如继电器、TP-Link 插座等

所需工具

工具	用途	是否必需
3D 打印机	运行 Klipper 固件的打印机	✅ 是
计算机或单板机	运行 Mainsail 和 Moonraker	✅ 是
网络连接	访问 Web 界面	✅ 是
浏览器	访问 Mainsail 界面	✅ 是

能力画像

记忆与知识检索

逻辑推演

表达与交流

感知与观察

数理与计算

动手与操作

狂热与坚持

创造与创新

项目图库

所需技能

🔧 **动手能力**：需要具备基本的 3D 打印机设置和网络配置能力。 💻 **编程能力**：无需编程，但需要能够阅读和编辑配置文件（如 printer.cfg）。 ⚡ **电子电路**：无需深入电子知识，但了解基本的电源控制设备连接会有帮助。

适用场景

使用 Klipper 固件的 3D 打印机用户，希望获得更现代、功能更丰富的 Web 控制界面。

需要远程监控和管理多台 3D 打印机的用户（打印机农场）。

希望集成延时摄影、多摄像头监控等高级功能的 3D 打印爱好者。