k2000

一个Python包，用于通过MIDI与Kurzweil K2000/K2500/K2600系列合成器通信。

使用方法：

pip install k2000

确保您使用的是Python 3.8、3.9或3.10。（其他版本也可能工作。）

什么？

回到20世纪90年代，由Raymond Kurzweil和Stevie Wonder共同创立的Kurzweil音乐系统发布了一系列非常先进的合成器，称为K2系列。与2025年中期我们所拥有的音乐技术相比，这些合成器实际上并不差。它们至今仍保持良好。

这个库包含与附加的K2系列合成器（特别是K2000、K2500或K2600）通过MIDI通信的代码，实现了其整个SysEx协议，允许完全接口控制和完全的对象读写支持。

如何？

快速入门示例

from k2000.client import K2500Client

c = K2500Client("My MIDI Interface Name")
assert c.is_connected

print(c.get_screen_text())
# ProgramMode    Xpose:0ST   <>Channel:1  
#                     998 Choral Sleigh   
# KeyMap Info         999 Pad Nine        
#  Grand Piano          1 Acoustic Piano  
#  Syn Piano            2 Stage Piano     
#                       3 BriteGrand      
#                       4 ClassicPiano&Vox
# Octav- Octav+ Panic  Sample Chan-  Chan+

# Navigate around the UI a bit:
c.up()
c.down()
c.number(125)
c.enter()

# Access object data:
name, program_data = c.programs[125]
print(f"Got {len(program_data):,} bytes of program data for Program \"{name}\".")
# prints: Got 586 bytes of program data for Program "Fast Solo Tenor".

# Dump all effect data, for example:
for i, value in c.effects.items():
    if value is None:
        continue
    effect_name, effect_data = value
    do_something_with(effect_name, effect_data)

# Take screenshots!
image = c.screenshot()
image.save("screenshot.png")
# Which gives...

为什么？

我在进行一些逆向工程，这个库使逆向工程变得更加容易。

更普遍的是，如果您想

• 通过Python从您的K2系列合成器中加载或转储程序（或设置、效果等）。
• 通过MIDI控制您的K2系列合成器界面（例如，按钮、读取文本和图形）
• 通过MIDI截取K2显示屏的截图
• 自动化K2的控制，用于抓取、测试等。

讽刺的是，这个库不支持发送MIDI音符；只支持发送用于控制K2特定功能的SysEx命令。

许可证

MIT License

Copyright (c) 2019-2023 Peter Sobot

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.