Repository navigation
OpenKeys Piano v0.1.0
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 SHA256sha256sum -c SHA256SUMS.txtThe 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 indocs/build.md.
Installation
- Run the installer and choose the interface language and shortcuts, or extract the portable ZIP.
- Start OpenKeys Piano, choose Import Soundfont, and select your own extracted
.sf2file. - 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
.eopand.eopiano.jsonperformances. - 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. Seedocs/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 SHA256sha256sum -c SHA256SUMS.txt安装器未进行代码签名,Windows SmartScreen 可能要求确认。
系统要求
- Windows 10 22H2 或 Windows 11,x64。
- 自行获取的
.sf2音源。安装包不附带、也不会自动下载音源。 - Linux 仅用于开发和自动化验证。本版本不提供 Linux 安装包,请按
docs/build.zh-CN.md从源码构建。
安装
- 运行安装器并选择界面语言和快捷方式,或解压便携 ZIP。
- 启动 OpenKeys Piano,选择 导入音源,选择自行解压出的
.sf2文件。 - 等待托管副本加载完成,然后在音频设置中启动音频设备。
应用会在用户本地应用数据目录保留音源的托管副本。只有新音源成功加载后才会提交替换;失败或
取消会保留原有配置。应用和安装目录内均包含离线导入指南。
主要功能
- 双手演奏全部 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 许可证。安装包内包含第三方声明。用户自行获取并导入
第三方音源。