Python 跨平台保活工具 wakepy 使用教程

Python 跨平台保活工具 wakepy 使用教程

wakepy Cross-platform keep-awake with python 项目地址: https://gitcode.com/gh_mirrors/wa/wakepy

1. 项目介绍

wakepy 是一个用 Python 编写的跨平台保活工具，它提供了一个 API 和命令行工具，用于防止系统进入睡眠状态。wakepy 通过使用系统提供的 API 和程序来保持系统唤醒，适用于长时间运行的任务，如机器学习模型训练、视频编码和网页抓取等。

wakepy 支持 Windows、macOS 和多种 Linux 桌面环境，如 GNOME、KDE Plasma 和 Freedesktop.org 等。它的使用方式是非侵入性的，不会改变系统设置，而且在进程意外终止时不会留下激活的保活状态，无需手动清理。

2. 项目快速启动

首先，确保您的 Python 环境是 CPython 3.7 到 3.13 或 PyPy 3.8 到 3.10。然后，可以通过以下命令安装 wakepy：

pip install wakepy

或者，如果您使用的是 conda 环境，可以使用以下命令：

conda install -c conda-forge wakepy

安装后，可以通过命令行工具 wakepy 保持系统唤醒。以下是一些基本用法：

• 保持 CPU 唤醒：

wakepy

• 保持屏幕唤醒（适用于演示模式）：

wakepy -p

在 Python 代码中，可以这样使用 wakepy：

from wakepy import keep

with keep.running():
    # 执行长时间运行的任务，系统可能会启动屏幕保护程序或锁屏，
    # 但 CPU 会保持唤醒状态。

with keep.presenting():
    # 执行长时间运行的任务，同时需要屏幕保持唤醒状态。

3. 应用案例和最佳实践

wakepy 可以用于多种场景，以下是一些应用案例：

• 机器学习模型训练：在训练过程中，需要 CPU 保持唤醒，以避免训练过程中断。
• 视频编码：编码过程中保持系统唤醒，确保视频处理不间断。
• 网页抓取：在进行网络爬虫任务时，保持系统唤醒，防止因系统睡眠导致任务中断。

最佳实践是结合任务的具体需求选择合适的模式，如 keep.running() 或 keep.presenting()，并监控任务的执行情况，以确保系统资源得到合理利用。

4. 典型生态项目

以下是一些使用 wakepy 的典型生态项目：

• aTrain：利用机器学习模型转录语音记录。
• mpc-autofill：自动化 MakePlayingCards 在线订购系统。
• LiveboxMonitor：用于路由器的图形用户界面（法国项目）。
• FOLON-FO4Downgrader：用于将游戏回滚到以前版本的工具（Fallout 4）。
• BD_to_AVP：3D 蓝光到 Apple Vision Pro 转换器。

这些项目展示了 wakepy 在不同场景下的应用，帮助开发者解决了长时间运行任务中的系统睡眠问题。

wakepy Cross-platform keep-awake with python 项目地址: https://gitcode.com/gh_mirrors/wa/wakepy