SoundKeeper v1.1.0

English

SoundKeeper v1.1.0

The first stable release of the Jazzwind fork, based on Deimz/SoundKeeper.

This release promotes the previously published DPI preview to a stable version. The executable is unchanged from v1.1.0-jazzwind.1. The improvements are also proposed in upstream PR #1.

Features

• Native Windows tray menus with Per-Monitor V2 DPI awareness and older-system fallbacks.
• Five wait presets and three sound-duration presets.
• Persistent settings, custom JSON preferences, and centralized source defaults.
• Automatic sample-rate selection, with optional fixed-rate configuration.
• Automatic interface language selection, plus English, Simplified Chinese, French, Russian, Spanish, and Arabic.
• Current-user Windows startup registration and visible playback-error status.
• English and Chinese documentation.

Original defaults are preserved: play for 1 second, wait 55 seconds after playback, and use a noise amplitude of 0.0001.

Download and usage

1. Download SoundKeeper-1.1.0-portable.zip.
2. Extract the entire archive to a permanent folder.
3. Exit any older SoundKeeper instance.
4. Run SoundKeeper.exe and right-click its tray icon.

Requires 64-bit Windows 10 or 11 and an available audio output device. No separate Python installation is required.

The archive contains the executable, English and Chinese guides, and the MIT license. The executable is approximately 28.18 MiB. A SHA256 checksum file is attached for verifying the portable ZIP.

GitHub's automatically generated Source code archives are not compiled applications.

Settings and upgrading

Preferences are stored in %APPDATA%\SoundKeeper\config.json. Existing valid settings are preserved when replacing the executable.

Exit the app before editing JSON, then restart to apply changes. Use "sample_rate": "auto" for automatic selection, or an integer such as "sample_rate": 48000 for a fixed rate.

If moving the executable, disable the old startup registration and enable startup again from the new location. If you keep using the existing executable at the same path, no startup change is needed.

Validation and compatibility

All 30 regression tests and formatting checks passed. Both build methods embed identical DPI manifests. An isolated source-run instance reported Per-Monitor V2 for the tray windows at 144 DPI (150%). Application startup, menu operation, preference restoration, and startup registration have also been manually checked during development.

Keep-alive effectiveness depends on the audio device and selected timing. Very short sounds may not keep every device awake. Mixed-DPI multi-monitor behavior and broader device compatibility have not been exhaustively tested. Some drivers require restarting the app after reconnecting audio devices.

Acknowledgments

Thank you to Deimz and the contributors to the original SoundKeeper. This fork retains the MIT license.

简体中文

SoundKeeper v1.1.0

基于 Deimz/SoundKeeper 的 Jazzwind 分支首个正式版本。

本次将此前发布的 DPI 预览版转为正式发布，程序与 v1.1.0-jazzwind.1 完全一致。相关改进也已通过 上游 PR #1 提交。

主要功能

• Windows 原生托盘菜单，支持 Per-Monitor V2 DPI 感知和旧系统回退。
• 五种等待时长、三种播放时长预设。
• 自动保存设置，支持 JSON 自定义参数和集中放置的源码默认值。
• 自动选择采样率，也可指定固定采样率。
• 跟随系统界面语言，或选择英文、简体中文、法语、俄语、西班牙语、阿拉伯语。
• 支持当前用户登录 Windows 后启动，并显示播放错误状态。
• 附带中英文使用说明。

保留原始默认参数：播放 1 秒，播放结束后等待 55 秒，噪声振幅为 0.0001。

下载与使用

1. 下载 SoundKeeper-1.1.0-portable.zip。
2. 将整个压缩包解压到固定目录。
3. 从托盘退出正在运行的旧版 SoundKeeper。
4. 运行 SoundKeeper.exe，右键托盘图标进行设置。

需要 64 位 Windows 10 / 11 和可用的音频输出设备，无需另外安装 Python。

压缩包包含程序、中英文说明和 MIT 许可。exe 体积约为 28.18 MiB。另附 SHA256 校验文件，可用于核对便携 ZIP 的完整性。

GitHub 自动生成的 Source code 压缩包是源码，不是已经编译的程序。

设置与升级

设置保存在 %APPDATA%\SoundKeeper\config.json，替换 exe 后会保留已有的有效设置。

手动编辑 JSON 前请先退出程序，保存后重新启动。自动采样率写作 "sample_rate": "auto"；固定采样率使用整数，例如 "sample_rate": 48000。

如果移动 exe，请先取消旧的开机启动注册，再从新位置重新启用。如果继续使用原路径下的现有程序，无需重新设置开机启动。

验证与兼容性

30 项回归测试和格式检查通过，两种构建方式嵌入的 DPI 清单一致。隔离源码测试实例的托盘窗口实测为 Per-Monitor V2、144 DPI（150%）。开发期间也已手动检查程序启动、菜单操作、设置恢复及开机启动注册。

实际保活效果取决于设备和所选参数。很短的播放时长不一定适合所有设备。混合 DPI 多显示器行为及更多设备兼容性尚未全面验证。部分驱动在重新连接音频设备后，需要重启程序。

致谢

感谢 Deimz 及贡献者创建和维护原始 SoundKeeper。本分支继续采用 MIT 许可。

SoundKeeper v1.1.0-jazzwind.1 (DPI Preview)

English

SoundKeeper v1.1.0-jazzwind.1 — DPI Preview

The first preview release of the Jazzwind fork, based on Deimz/SoundKeeper. These improvements are also proposed in upstream PR #1.

Features

• Per-Monitor V2 DPI awareness for the existing native Windows tray menus, with fallbacks for older systems.
• Five wait presets and three sound-duration presets.
• Persistent preferences, advanced JSON configuration, and centralized source defaults.
• Automatic sample-rate selection, with an optional fixed rate in the configuration.
• Automatic interface language selection, plus English, Simplified Chinese, French, Russian, Spanish, and Arabic.
• Current-user Windows startup registration and visible playback-error status.
• English and Chinese documentation.

Original defaults are preserved: play for 1 second, wait 55 seconds after playback, and use a noise amplitude of 0.0001.

The DPI update keeps the existing pystray native menu backend. It does not add runtime dependencies or change audio/configuration behavior.

Download and usage

1. Download SoundKeeper-1.1.0-jazzwind.1-portable.zip.
2. Extract the entire archive to a permanent folder.
3. Exit any older SoundKeeper instance.
4. Run SoundKeeper.exe and right-click its tray icon.

Requires 64-bit Windows 10 or 11 and an available audio output device. No separate Python installation is required.

The archive includes the executable, English and Chinese guides, and the MIT license. The executable is approximately 28.18 MiB.

GitHub's automatically generated Source code archives are not compiled applications. An optional SHA256 checksum file is attached for verifying the portable ZIP.

Settings and upgrading

Preferences are stored in %APPDATA%\SoundKeeper\config.json and are shared with previous versions under the same Windows user.

Replacing the executable preserves valid saved preferences. Exit the app before editing JSON, then restart to apply changes. Use "sample_rate": "auto" for automatic selection, or an integer such as "sample_rate": 48000 for a fixed rate.

If moving to a different executable path, disable the old startup registration, then enable startup from the new executable. Keep the new executable at that location.

Validation and preview limitations

• All 30 regression tests passed.
• Formatting and whitespace checks passed.
• Spec and direct CLI builds embed identical DPI manifests.
• An isolated source-run instance reported Per-Monitor V2 for both tray windows at 144 DPI (150%).
• The new executable has been manually launched and its startup registration checked.

Pixel-level comparison, mixed-DPI multi-monitor behavior, broader device compatibility, and long-term Bluetooth keep-alive behavior still need manual validation. Very short sounds may not keep every device awake. Some drivers require restarting the app after reconnecting audio devices.

Acknowledgments

Thank you to Deimz and the contributors to the original SoundKeeper. This fork retains the MIT license.

简体中文

SoundKeeper v1.1.0-jazzwind.1 — DPI 预览版

基于 Deimz/SoundKeeper 的 Jazzwind 分支首个预发布版本。相关改进也已通过 上游 PR #1 提交。

主要功能

• 为现有 Windows 原生托盘菜单启用 Per-Monitor V2 DPI 感知，并提供旧系统回退。
• 五种等待时长、三种播放时长预设。
• 设置自动保存，支持 JSON 高级配置和集中放置的源码默认值。
• 自动选择采样率，也可在配置中指定固定采样率。
• 跟随系统界面语言，或选择英文、简体中文、法语、俄语、西班牙语、阿拉伯语。
• 支持当前用户登录 Windows 后启动，并显示播放错误状态。
• 附带中英文使用说明。

保留原始默认参数：播放 1 秒，播放结束后等待 55 秒，噪声振幅为 0.0001。

DPI 更新保留现有 pystray 原生菜单后端，不增加运行依赖，也不改变音频和配置行为。

下载与使用

1. 下载 SoundKeeper-1.1.0-jazzwind.1-portable.zip。
2. 将整个压缩包解压到固定目录。
3. 从托盘退出正在运行的旧版 SoundKeeper。
4. 运行 SoundKeeper.exe，右键托盘图标进行设置。

需要 64 位 Windows 10 / 11 和可用的音频输出设备，无需另外安装 Python。

压缩包包含程序、中英文说明和 MIT 许可。exe 体积约为 28.18 MiB。

GitHub 自动生成的 Source code 压缩包是源码，不是已经编译的程序。另附 SHA256 校验文件，可用于核对便携 ZIP 的完整性。

设置与升级

设置保存在 %APPDATA%\SoundKeeper\config.json，与同一 Windows 用户下的旧版本共用。

替换 exe 会保留已有的有效设置。手动编辑 JSON 前请先退出程序，保存后重新启动。自动采样率写作 "sample_rate": "auto"；固定采样率使用整数，例如 "sample_rate": 48000。

如果新旧 exe 路径不同，请先取消旧的开机启动注册，再从新版程序重新启用。之后保持新版 exe 的位置不变。

验证情况与预览版限制

• 30 项回归测试全部通过。
• 格式和空白检查通过。
• spec 与直接命令构建的 DPI 清单一致。
• 隔离源码测试实例的两个托盘窗口实测为 Per-Monitor V2、144 DPI（150%）。
• 新版 exe 已手动启动，并核对了开机启动路径。

像素级视觉对比、混合 DPI 多显示器、更多设备兼容性和蓝牙长期保活效果仍需实机验证。很短的播放时长不一定适合所有设备。部分驱动在重新连接音频设备后，需要重启程序。

致谢

感谢 Deimz 及贡献者创建和维护原始 SoundKeeper。本分支继续采用 MIT 许可。