Repository navigation
OpenKeys Piano 0.2.0
Windows x64 feature release. The installer and portable ZIP are published only after
the tagged commit passes Linux and Windows verification, including packaging,
installation, upgrade, shortcuts, the finish-page launch option and uninstall cleanup.
Changes since 0.1.1
- Move file, soundfont, output, keymap and help actions into menus. Keep all seven
performance settings evenly spaced on one row, with compact key/octave labels,
tooltips and arrow-only controls that support press-and-hold. - Add a latched live Sustain switch. It starts off, is preserved in recordings,
cooperates with custom pedal bindings and is cleared by emergency stop. Space
is unassigned by default; existing custom bindings remain available. - Display hand velocities as 0–100%, with zero producing no new notes. Preserve
MIDI velocities in native files and convert EOP percentage dynamics correctly. - Restore C, original hand octaves and 80%/100% left/right velocities at startup
while retaining custom key bindings. Explicitly imported profiles apply their settings. - Correct EOP v201/v301 key-signature IDs, signed offsets, independent layer changes
and releases across key changes. Show file settings during playback and pause;
seeking restores the destination's held notes, pedals, highlights and settings. - Add separate embedded soundfont and EOP/recording guides with offline language
and topic links. The installer finish page offers a bilingual, checked-by-default
run option; silent installation never launches the application. - Enforce the documented 32-layer mapping limit for v201 zero-section containers,
including the first unprefixed layer. Regression tests accept 32 and reject 33
layers for all supported layered layouts. - Synchronize project/package metadata and bilingual documentation. Resource checks
now reject mismatched CMake/vcpkg versions, download links, release notes and tags.
Downloads and installation
| Asset | Description |
|---|---|
OpenKeysPiano-0.2.0-Windows-AMD64.exe |
Windows x64 NSIS installer, English and Simplified Chinese, optional desktop and Start Menu shortcuts. |
OpenKeysPiano-0.2.0-Windows-AMD64.zip |
Portable build; extract and run openkeys.exe. |
SHA256SUMS.txt |
SHA-256 checksums for both downloads. |
Requires Windows 10 22H2 or Windows 11, x64. No soundfont is bundled or downloaded.
Choose Soundfont → Import / Replace Soundfont to import your own extracted .sf2.
Use Output → Audio Settings to select or reconnect an output device.
Both shortcuts default to enabled and can be deselected independently. The installer
never modifies PATH. Uninstall and upgrade remove the entire installation directory,
including files added there by the user; settings and imported soundfonts outside that
directory are preserved. Back up any files you have placed inside it before upgrading.
The installer and executables are unsigned. Product/publisher metadata is not a
verified signing identity; Windows may show an unknown publisher or SmartScreen warning.
Verify the downloads against SHA256SUMS.txt before running them:
certutil -hashfile OpenKeysPiano-0.2.0-Windows-AMD64.exe SHA256sha256sum -c SHA256SUMS.txtCompatibility and validation limits
Native recordings and keymaps retain version 1. Existing recordings keep their absolute
pitches and MIDI velocities. Reimport original EOP files to obtain corrected key-signature
interpretation; previously saved native files are not automatically reinterpreted.
Unknown EOP controls remain warnings, and some mapping/control semantics remain experimental.
Automated tests use generated SF2 fixtures; the optional real-bank test is explicitly
skipped without a supplied soundfont. Full Windows 10/11 visual installation and DPI
acceptance, Raw Input and WASAPI on physical hardware, end-to-end latency, listening tests
and complete real-world EOP corpus comparisons remain pending. Linux is source-only.
External MIDI input, VST hosting, EOP export, practice scoring and score engraving are
outside this release. See the bundled validation and EOP compatibility documentation.
Licensed under GPL-3.0-or-later; third-party notices are included.
OpenKeys Piano 0.2.0(简体中文)
面向 Windows x64 的功能版本。只有标签提交的 Linux 与 Windows 验证全部通过后才发布安装器
和便携 ZIP,包括打包、安装、升级、快捷方式、完成页启动选项和卸载清理检查。
相比 0.1.1 的更新
- 将文件、音源、输出、键位和帮助操作移入菜单。七项演奏设置在同一行等距排列,采用紧凑的
调名/八度标签和完整悬停说明;上下按钮支持按住连续调整,避免输入和滚轮误改。 - 新增持续延音开关,启动时关闭、录制时保留,与自定义踏板键协作;紧急止音会关闭开关。
空格默认不再分配延音,已有自定义绑定继续可用。 - 左右手力度显示为 0–100%,零不产生新音符。原生文件保持 MIDI 力度,正确换算 EOP 百分比力度。
- 每次启动恢复 C 调、左右手原音区及 80%/100% 力度,保留自定义键位;主动导入方案时采用
方案中的设置。 - 修正 EOP v201/v301 调号编号、有符号偏移、分层独立变调及跨变调释放。播放和暂停显示文件
设置;定位时重建目标处的音符、踏板、高亮和配置。 - 提供独立内嵌的音源与曲谱/录音教程,支持离线语言及主题跳转。双语安装完成页默认勾选
立即运行;静默安装不会启动程序。 - 修复 v201 零段容器的映射层数限制,首个无前缀段也计入总共 32 层。所有支持的分层布局均
通过接受 32 层、拒绝 33 层的回归测试。 - 同步项目/安装包版本和双语文档。资源检查新增 CMake/vcpkg 版本、下载链接、发布说明和
标签一致性验证。
下载与安装
| 文件 | 说明 |
|---|---|
OpenKeysPiano-0.2.0-Windows-AMD64.exe |
Windows x64 NSIS 安装器,支持英文、简体中文以及可选桌面和开始菜单快捷方式。 |
OpenKeysPiano-0.2.0-Windows-AMD64.zip |
便携版,解压后运行 openkeys.exe。 |
SHA256SUMS.txt |
两个下载文件的 SHA-256 校验和。 |
需要 Windows 10 22H2 或 Windows 11,x64。软件不附带、也不会自动下载音源。 通过
音源 → 导入/替换音源 导入自行准备并解压的 .sf2,通过 输出 → 音频设置 选择或重连设备。
两种快捷方式默认均开启,可分别取消;安装器不修改 PATH。卸载和升级会清理整个安装目录,
包含用户自行放入的文件;目录外的配置和导入音源保留。升级前请备份放在安装目录内的文件。
安装器和程序未签名。产品及发行者信息不代表经过验证的签名身份,Windows 仍可能显示
“未知发布者”或 SmartScreen 警告。
运行前计算校验和,并与 SHA256SUMS.txt 比对:
certutil -hashfile OpenKeysPiano-0.2.0-Windows-AMD64.exe SHA256sha256sum -c SHA256SUMS.txt兼容性与验证限制
原生录制和键位方案继续使用版本 1。已有录制保留绝对音高和 MIDI 力度;需重新导入原始 EOP
才能采用修正后的调号解释,不会自动修改此前保存的原生文件。未知 EOP 控制仍会提示警告,
部分映射和控制语义继续属于实验性支持。
自动测试使用生成的 SF2 夹具,未提供用户音源时可选真实音源测试明确跳过。Windows 10/11
完整安装视觉检查与 DPI 验收、实体硬件上的 Raw Input 和 WASAPI、端到端延迟、听感及完整
真实 EOP 曲库对比仍待完成。Linux 仅支持源码构建。外部 MIDI 输入、VST 宿主、EOP 导出、
练习评分和制谱不在本版本范围内。详情见随包提供的验证与 EOP 兼容性文档。
采用 GPL-3.0-or-later 许可证,安装包包含第三方声明。