Skip to content

Releases

OpenKeys Piano v0.2.0

Choose a tag to compare

@github-actions github-actions released this 16 Nov 06:41

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 SHA256
sha256sum -c SHA256SUMS.txt

Compatibility 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 SHA256
sha256sum -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 许可证,安装包包含第三方声明。

OpenKeys Piano v0.1.1

Choose a tag to compare

@github-actions github-actions released this 13 Nov 14:33

OpenKeys Piano 0.1.1

Windows x64 maintenance release. The installer and portable ZIP are published only after
the Linux and Windows checks for the tagged commit pass.

Changes

  • Import left/right hand assignments from EOP v201/v301 key mappings, preserving them
    through playback, pause, seeking and replay. Unrecognized assignments remain Unknown.
  • Distinguish playback hands on both keyboard views: green for left, purple for right and
    gold for Unknown, independently of the live keymap.
  • Improve file-dialog text contrast in the dark interface.
  • Add Windows product, company and version properties to both project executables, the
    installer and uninstaller. The installed-app publisher is OpenKeysPiano.
  • Keep the application, About dialog and package versions consistent with CMake.

Downloads and installation

Asset Description
OpenKeysPiano-0.1.1-Windows-AMD64.exe Windows x64 NSIS installer, English and Simplified Chinese, optional desktop and Start Menu shortcuts.
OpenKeysPiano-0.1.1-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.
After installation, import your own .sf2 and start the audio device in Audio Settings.
The offline import guide is included. Upgrading uninstalls the previous application;
settings and imported soundfonts outside the installation directory are preserved.

The installer and executables are unsigned. File properties and installed-app publisher
information do not establish a verified signing identity. Windows may show an unknown
publisher or a SmartScreen warning.

Check the installer against SHA256SUMS.txt before running it:

certutil -hashfile OpenKeysPiano-0.1.1-Windows-AMD64.exe SHA256

Verification and limitations

The tagged commit passes Linux and Windows builds/tests and resource checks. Windows also
verifies deployment without developer DLL paths, installer/portable product metadata,
installed publisher/version, both installation languages, Unicode paths with spaces,
shortcut combinations, upgrade, locked-file failure and uninstall cleanup.

Interactive Windows installation, DPI, real audio-device latency and comparison with real
EOP libraries still require real-machine acceptance. EOP support remains experimental for
some mappings and controls; unknown controls produce warnings. Reimport original EOP files
to recover hand assignments missing from previously saved recordings. 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.1.1(简体中文)

面向 Windows x64 的维护版本。只有标签提交对应的 Linux 与 Windows 检查全部通过后,才发布
安装器和便携 ZIP。

更新内容

  • 从 EOP v201/v301 键位映射导入左右手分配,并在播放、暂停、定位和重播时保留;无法识别的
    分配保持为未知。
  • 两个键盘视图按文件中的左右手显示:左手绿色、右手紫色、未知金色,不受现场键位方案影响。
  • 改善深色界面中文件对话框的文字对比度。
  • 为两个自有程序、安装器和卸载器添加 Windows 产品、公司及版本属性;已安装应用列表中的
    发行者为 OpenKeysPiano。
  • 应用、关于窗口与安装包统一使用 CMake 项目版本。

下载与安装

文件 说明
OpenKeysPiano-0.1.1-Windows-AMD64.exe Windows x64 NSIS 安装器,支持英文、简体中文以及可选桌面和开始菜单快捷方式。
OpenKeysPiano-0.1.1-Windows-AMD64.zip 便携版,解压后运行 openkeys.exe。
SHA256SUMS.txt 两个下载文件的 SHA-256 校验和。

需要 Windows 10 22H2 或 Windows 11,x64。软件不附带、也不会自动下载音源。 安装后自行
导入 .sf2,然后在音频设置中启动音频设备。软件包含离线导入教程。升级会先卸载旧应用,
安装目录外的配置和已导入音源会保留。

安装器和程序未签名。文件属性及已安装应用的发行者信息不代表经过验证的签名身份,
Windows 仍可能显示“未知发布者”或 SmartScreen 警告。

运行前计算安装器校验和,并与 SHA256SUMS.txt 比对:

certutil -hashfile OpenKeysPiano-0.1.1-Windows-AMD64.exe SHA256

验证与限制

标签提交通过 Linux 与 Windows 构建、测试及资源检查。Windows 还验证脱离开发 DLL 路径的
启动、安装器及便携版产品属性、安装发行者与版本、两种安装语言、含空格的 Unicode 路径、
快捷方式组合、升级、占用文件失败以及卸载清理。

Windows 交互安装、DPI、真实音频设备延迟及与真实 EOP 曲库的对比仍需实机验收。部分 EOP
映射与控制效果仍属实验性;未知控件会提示警告。此前保存的录制若缺少左右手分配,需要重新
导入原始 EOP 文件。Linux 仅支持源码构建。外部 MIDI 输入、VST 宿主、EOP 导出、练习评分和
制谱不在本版本范围内。详情见随包提供的验证与 EOP 兼容性文档。

使用 GPL-3.0-or-later 许可证,安装包内包含第三方声明。

OpenKeys Piano v0.1.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 08:55

OpenKeys Piano 0.1.0

First public release, targeting Windows x64. OpenKeys Piano is a free and open-source
computer-keyboard piano built with C++20, Qt 6 Widgets, FluidSynth and PortAudio. The 0.1.0
release is published only after the Linux and Windows verification jobs for the tagged commit
have passed.

Downloads

Asset Description
OpenKeysPiano-0.1.0-Windows-AMD64.exe NSIS installer for Windows x64. English and Simplified Chinese, optional desktop and Start Menu shortcuts, no PATH changes.
OpenKeysPiano-0.1.0-Windows-AMD64.zip Portable build. Extract it and run openkeys.exe; no installation required.
SHA256SUMS.txt SHA-256 checksums for the installer and portable ZIP.

Verify the downloads before running them:

certutil -hashfile OpenKeysPiano-0.1.0-Windows-AMD64.exe SHA256
sha256sum -c SHA256SUMS.txt

The installer is not code-signed, so Windows SmartScreen may ask for confirmation.

Requirements

  • Windows 10 22H2 or Windows 11, x64.
  • A soundfont (.sf2) that you obtain yourself. No soundfont is bundled or downloaded.
  • Linux is supported for development and automated verification. This release provides no Linux
    package; build from source as described in docs/build.md.

Installation

  1. Run the installer and choose the interface language and shortcuts, or extract the portable ZIP.
  2. Start OpenKeys Piano, choose Import Soundfont, and select your own extracted .sf2 file.
  3. Wait for the managed copy to finish loading, then start the audio device in Audio Settings.

The application keeps a managed copy of the imported soundfont in the user's local application
data. Replacement is committed only after the new bank loads successfully. An offline import
guide is included in the application and the installation.

Highlights

  • Play with both hands across all 88 piano keys, with editable key mappings, mouse playing,
    sustain and velocity modifiers.
  • Import, replace and persist a managed soundfont copy with failure and cancellation recovery.
  • Open, play, pause, seek and change speed for EOP .eop and .eopiano.json performances.
  • Record and replay performances, including simultaneous physical and mouse input.
  • English and Simplified Chinese interface and installer; file dialogs follow the selected
    application language.
  • Windows background playing, with Ctrl+Alt+F12 / Panic as the emergency stop.

Verification

The release is created from the installer and portable ZIP built and verified by the Windows CI
job for the tagged commit. That job stages the application, starts it without developer tools on
PATH, builds the NSIS installer and portable ZIP, and runs the installer acceptance script: silent
installation in both languages to a Unicode path containing spaces, desktop/Start Menu shortcut
combinations, shortcut targets, upgrade, locked-file failure, and complete uninstall cleanup. The
Linux job builds and runs the full automated test suite. SHA-256 checksums are attached.

Known limitations

  • Interactive Windows 10/11 installation pages, DPI behavior, real audio-device latency and
    comparison against real EOP libraries still require real-machine acceptance. See
    docs/validation.md.
  • Parts of EOP v201/v301 key-mapping offsets are experimental, and unknown controls are reported
    as warnings rather than reproduced. See docs/eop-compatibility.md.
  • External MIDI input, VST hosting, EOP export, practice scoring and score engraving are outside
    this release.
  • The installer and executables are unsigned.
  • No Linux package is provided in 0.1.0.

License

OpenKeys Piano is licensed under GPL-3.0-or-later. Third-party notices are included in the
package. Users obtain and import third-party soundfonts themselves.


OpenKeys Piano 0.1.0(简体中文)

首个公开版本,面向 Windows x64。OpenKeys Piano 是一款免费开源的电脑键盘钢琴,使用 C++20、
Qt 6 Widgets、FluidSynth 和 PortAudio 构建。只有该标签提交的 Linux 与 Windows 验证任务全部
通过后,0.1.0 版本才会发布。

下载

文件 说明
OpenKeysPiano-0.1.0-Windows-AMD64.exe Windows x64 的 NSIS 安装器。支持英文和简体中文,可选择桌面和开始菜单快捷方式,不修改 PATH。
OpenKeysPiano-0.1.0-Windows-AMD64.zip 便携版。解压后运行 openkeys.exe,无需安装。
SHA256SUMS.txt 安装器和便携 ZIP 的 SHA-256 校验和。

运行前请先校验:

certutil -hashfile OpenKeysPiano-0.1.0-Windows-AMD64.exe SHA256
sha256sum -c SHA256SUMS.txt

安装器未进行代码签名,Windows SmartScreen 可能要求确认。

系统要求

  • Windows 10 22H2 或 Windows 11,x64。
  • 自行获取的 .sf2 音源。安装包不附带、也不会自动下载音源。
  • Linux 仅用于开发和自动化验证。本版本不提供 Linux 安装包,请按 docs/build.zh-CN.md 从源码构建。

安装

  1. 运行安装器并选择界面语言和快捷方式,或解压便携 ZIP。
  2. 启动 OpenKeys Piano,选择 导入音源,选择自行解压出的 .sf2 文件。
  3. 等待托管副本加载完成,然后在音频设置中启动音频设备。

应用会在用户本地应用数据目录保留音源的托管副本。只有新音源成功加载后才会提交替换;失败或
取消会保留原有配置。应用和安装目录内均包含离线导入指南。

主要功能

  • 双手演奏全部 88 个钢琴键,支持键位编辑、鼠标演奏、延音和力度修饰键。
  • 导入、替换并持久保存托管音源,支持失败与取消恢复。
  • 打开、播放、暂停、拖动定位和变速播放 EOP .eop 与 .eopiano.json 演奏文件。
  • 录制并回放演奏,支持物理键盘与鼠标同时输入。
  • 英文和简体中文界面及安装器;文件对话框跟随所选应用语言。
  • Windows 后台演奏,使用 Ctrl+Alt+F12 或 Panic 紧急停止。

验证

发布所用的安装器和便携 ZIP 由该标签提交的 Windows CI 任务构建并验证:部署应用、在移除开发
工具 PATH 的情况下启动、生成 NSIS 安装器和便携 ZIP,并运行安装器验收脚本,覆盖两种安装语言
下安装到含空格的 Unicode 路径、桌面/开始菜单快捷方式组合、快捷方式目标、升级、占用文件失败
以及完整卸载清理。Linux 任务构建并运行完整自动化测试。发布同时提供 SHA-256 校验和。

已知限制

  • Windows 10/11 交互安装页面、DPI 行为、真实音频设备延迟以及与真实 EOP 曲库的对比仍需实机
    验收,见 docs/validation.zh-CN.md。
  • EOP v201/v301 的部分键位映射偏移仍属实验性,未知控件以警告方式提示而不会完整还原,见
    docs/eop-compatibility.zh-CN.md。
  • 外部 MIDI 输入、VST 宿主、EOP 导出、练习评分和制谱不在本版本范围内。
  • 安装器和可执行文件未签名。
  • 0.1.0 不提供 Linux 安装包。

许可证

OpenKeys Piano 使用 GPL-3.0-or-later 许可证。安装包内包含第三方声明。用户自行获取并导入
第三方音源。