逆向工程了YAMAHA的Vocaloid5项目文件格式

技术 | Technology
1

最近在研究YAMAHA Vocaloid5的项目文件（.vpr格式）。

按照对大厂套路的深入理解，后缀名改zip零帧起手，果然是个ZIP压缩包，里面包含了一个sequence.json，存储了所有的工程数据（音轨、音符、参数等）。

于是写了一个Python解析库，把它的结构逆向出来了。

内容分析

解压后主要文件是Project/sequence.json，包含项目的元信息、音轨（tracks）、音符（notes）、效果器等。
命名规则是驼峰命名法，按照PEP8要转换一下。

开始逆向！

用Python写了一个解析库，主要功能：

  • 读取VPR文件 → 转成Pydantic模型（带类型检查）。
  • 修改数据（比如改BPM、音符参数）→ 重新打包成.vpr。
  • 性能分析：内置Timer util类，可以看各部分解析耗时。

示例用法：

from vpr_parser import VPRParser

parser = VPRParser()
project = parser.parse("song.vpr")  # 读取文件
project.title = "New Song Name"    # 改标题
parser.dump(project, "modified.vpr")  # 保存

踩坑记录

奇怪的命名法

YAMAHA命名规则太奇怪，本来用驼峰命名法，pydantic alias_generator转换一下的事，结果comp_id这个字段不是compId，而是compID:sweat_smile:
另、有的字段，比如global，是Python保留字，需要替换（处理代码如下）：

class AliasedBaseModel(BaseModel):
    model_config = ConfigDict(
        alias_generator=lambda x: (
            to_camel(x).replace("Id", "ID")  # this shit is so ass i hate you yamaha 😭
            if x != "global_config"
            else "global"
        ),  # i love pyright randomly giving me 1mil errors ❤️
        populate_by_name=True,
        extra="forbid",
    )

后续计划

  • 给每个字段加入解释文档
  • 有的类型还不是很完善，比如ControllerEvent只有几种类型(应该使用Literal[…])，我却直接用了str

GitHub项目：vpr-parser（欢迎Star/PR！）

2 个赞
2

NL镇站萝莉出教程了。 大赞。 先Star再看。

1 个赞