Home Assistant 新！

在您的Home Assistant设备上运行SimplyPrint客户端，使其成为连接您打印机的桥梁。这是作为附加组件的客户端，而非作为Home Assistant实体的打印机

在GitHub上查看插件

关于此集成

上线日期

2026年9月19日

开发者

SimplyPrint

SimplyPrint 未获得 Home Assistant 的认可，也与其没有关联。我们使用商标和图片仅为表明与我们平台的兼容性。将 Home Assistant 硬件与 SimplyPrint 搭配使用，可能并非 Home Assistant 的预期用途。所有权利归各自所有者所有。

SimplyPrint Home Assistant：在已开机的设备上运行客户端

The SimplyPrint Client add-on runs our printer client directly on your Home Assistant machine, so the hardware you already leave running around the clock is the same hardware that keeps your printers connected. No spare Raspberry Pi per printer, no second thing to maintain.

What this is, and what it is not.

This add-on makes your Home Assistant machine the bridge between your printers and SimplyPrint. That is the whole job.

It does not put your printers into Home Assistant as entities - there are no printer sensors, no temperature or progress values to put on a dashboard, and nothing to drive an automation with. If that is what you came for, it is a separate thing and we have not built it yet: follow suggestion #324.

Full setup guide in our helpdesk →

The add-on uses Home Assistant Ingress, so its interface is served through Home Assistant itself. Turn on Show in sidebar and you get a SimplyPrint entry in your Home Assistant menu. There is no port for you to open, and the client interface only accepts requests coming through Home Assistant.

The add-on is new and still experimental (1.0.0-rc.17). It works and it is ready to use - it just has not been through as many hands as our other install methods. If something looks wrong, open an issue and we will fix it.

Open your Home Assistant instance and add the SimplyPrint add-on repository

What you need

  • Home Assistant OS or a Supervised install. Add-ons need the Supervisor, so Home Assistant Container and Home Assistant Core cannot install this.
  • A 64-bit machine - aarch64 or amd64. A 32-bit Raspberry Pi OS install is not supported.
  • A printer SimplyPrint already supports over a local connection.

Why run it here

  • One box, already on. Your Home Assistant machine is the most reliably powered thing in the house.
  • Backed up with everything else. The add-on participates in Home Assistant backups.
  • Set up from the sidebar. Ingress means the client UI is a panel in Home Assistant, not another address to remember.

  • Runs the SimplyPrint client on the Home Assistant machine you already have powered on
  • One-click repository install through My Home Assistant
  • 在Home Assistant侧边栏中显示为SimplyPrint面板（Ingress）
  • 包含在Home Assistant备份中
  • Home Assistant OS和Supervised安装，aarch64和amd64
  • 由SimplyPrint维护的官方加载项存储库
  • Does not expose printers as Home Assistant entities - this is the bridge, not a dashboard integration

如何在Home Assistant中安装SimplyPrint加载项

1

检查您的安装类型

加载项需要Supervisor，因此您需要在64位设备上安装Home Assistant OS或Supervised。Container和Core安装无法添加此加载项。

2

添加存储库

In Home Assistant go to Settings → Apps (Home Assistant renamed add-ons to apps, so older guides say Add-ons), open the app store, then the three-dot menu, choose Repositories, and paste https://github.com/SimplyPrint/home-assistant-apps.

3

安装SimplyPrint Client

商店中会显示SimplyPrint Client插件。打开它并点击安装。这是实验性候选版本，请先阅读插件页面上的警告。

4

启动加载项并打开面板

Turn on Start on boot, Watchdog and Show in sidebar, start the add-on, then open SimplyPrint from your Home Assistant menu and follow the setup to connect your printer to your SimplyPrint account.

常见问题

SimplyPrint Home Assistant加载项是否已可使用？

Yes. It is published in our official add-on repository and you can install it today. It is still new and experimental (1.0.0-rc.17), so it has not been through as many hands as our other install methods - if you find a bug, tell us and we will fix it.

它能在Home Assistant Container或Core上运行吗？

不能。加载项由Home Assistant Supervisor管理，该功能仅存在于Home Assistant OS和Supervised安装中。在Container或Core上，请改为直接在您网络中的设备上运行SimplyPrint客户端。

支持哪些硬件？

仅支持64位：aarch64和amd64。适用于运行64位Home Assistant OS的Raspberry Pi 4或5、Intel NUC或通用x86设备。32位安装将无法看到此加载项。

是否需要开放端口或设置隧道？

No. The add-on uses Home Assistant's Ingress, so its interface is served through Home Assistant itself and the client only accepts requests that arrive that way. Turn on Show in sidebar to get it as a panel in your Home Assistant menu.

是否会随Home Assistant一同备份？

是的，插件会包含在Home Assistant的备份中，因此其配置会随您的其他设置一同迁移。

Is there a one-click install?

Yes. If you are on a device that can reach your Home Assistant, the Open app store of My Home Assistant button on this page adds our repository for you - then install SimplyPrint Client from the store. The manual route is Settings → Apps (formerly Add-ons) → the app store → three-dot menu → Repositories.

Does this put my printers into Home Assistant as sensors or entities?

No, and this is the most common misunderstanding. The add-on runs the SimplyPrint client on your Home Assistant machine so your printers can reach SimplyPrint - it is a bridge, not a dashboard integration. It creates no entities, so there is no temperature, progress or AMS data to put on a Home Assistant dashboard or drive an automation with. That is a separate piece of work; you can follow and vote for it at suggestion #324.

关于 SimplyPrint 集成

SimplyPrint的集成功能让应用可与您的3D打印机交互，您的3D打印机也可与其他应用交互。这带来无限可能，我们坚信您的3D打印机应能作为IOT设备，与您能想到的所有应用协同工作！

这正是SimplyPrint团队致力于为最受欢迎的平台、切片软件和应用程序提供官方集成的原因，同时也允许用户通过我们的API创建自定义集成，或允许经批准的第三方供应商使用“使用SimplyPrint登录”方式（使用“OAuth2”方法）创建供所有SimplyPrint用户使用的集成。

如果您是开发者且有兴趣为SimplyPrint创建集成，请阅读我们关于此主题的文档。

如果您本人不是开发者，但希望看到特定应用的集成，请查看它是否已列入我们的路线图或建议列表；如果没有，欢迎您提出建议！