ScoreTranslate

本地乐谱格式转换工具。选择乐谱文件，转换成其它格式并下载。 A local sheet-music format converter. Pick a score file, convert it, download the result.

全程在本机完成，文件不上传到任何外部服务。 Everything runs on your own machine — no file is ever uploaded anywhere.

在 GitHub 上查看View on GitHub 快速开始Get started

转换矩阵Conversion matrix

输入Input

.mid.midi.gp .gpx.gp3.gp4 .gp5.mxl.musicxml .xml.json

→

输出Output

.mid.musicxml.xml .mxl.gp.gp5 .json.mscz.pdf .png

单文件上限 50MB。PNG 按页导出，多页自动打包成 zip，也可以拼成一张纵向长图。PDF 可选纸张与缩放，MusicXML / PDF / PNG 可选六线谱或五线谱。多轨谱可以只导出选中的音轨，弹唱谱可以把歌词并入吉他等其他音轨。.json 是 alphaTab 的乐谱模型格式，便于在网页端渲染或二次处理。 50MB per file. PNG is exported page by page and zipped when the score spans several pages, or stitched into one long vertical image. PDF takes paper size and scaling; MusicXML / PDF / PNG take a staff type — tablature or standard notation. Multi-track scores can be narrowed to selected tracks, and lead-sheet lyrics can be merged onto the guitar and other tracks. .json is alphaTab's score model format, handy for rendering in the browser or further processing.

特点Highlights

文件不出本机Nothing leaves your machine

无数据库、无状态，转换在本地请求内同步完成，不经过任何云端服务。 No database, no state. Conversion happens synchronously inside a local request — no cloud service involved.

自研 GP5 写出器A from-scratch GP5 writer

开源生态里没有现成的 GP5 写出实现，本项目自己写了一个，并用两套独立解析器回读校验。 No open-source GP5 writer existed, so this project ships one — verified by reading the output back with two independent parsers.

保留六线谱信息Tablature survives

Guitar Pro 转 MusicXML 走自研序列化器，保住 TAB 谱表、调弦和每个音的弦号品格。 Guitar Pro → MusicXML goes through a custom serializer that keeps TAB staves, tunings and per-note string/fret data.

快速开始Get started

需要 bun 与 MuseScore 4（作为转换引擎，需本机安装）。 You need bun and MuseScore 4, which acts as the conversion engine and must be installed locally.

git clone https://github.com/tpnet/ScoreTranslate.git
cd ScoreTranslate
bun install && bun run dev

打开 http://localhost:3000 即可使用。MuseScore 装在非默认位置时，用环境变量指定： Then open http://localhost:3000. If MuseScore lives somewhere other than the default path, point to it with an environment variable:

export MSCORE_PATH=/your/path/to/mscore

界面之外也可以直接调接口： The endpoint can also be called directly:

curl -O -J -F "file=@score.gp5" -F "target=pdf" \
  http://localhost:3000/api/convert

已知限制Known limitations

gp3 / gp4 / gpx 只能输入、不能输出。gp3 / gp4 / gpx are input-only. 能打开 gp3/gp4 的软件都能打开 gp5；gpx 是 GP6 独有的专有容器，GP6 已被官方放弃。 Anything that opens gp3/gp4 also opens gp5, and gpx is GP6's proprietary container — a version the vendor has abandoned.
GP5 输出保留演奏效果。GP5 output preserves playing techniques. 推弦、击勾弦、滑音、泛音、闷音、颤音、倚音、扫弦等随音符一并写出（GP5 格式没有的除外，如左手点弦）；和弦图不保留。 Bends, hammer-ons, slides, harmonics, palm mutes, vibrato, grace notes and strums are written alongside the notes (except what the GP5 format cannot express, e.g. left-hand taps); chord diagrams are not preserved.
MIDI 转记谱格式有质量天花板。MIDI-to-notation has a quality ceiling. MIDI 不携带谱面信息，结果由量化算法推断，演奏录制的 MIDI 通常需要手工整理。这是格式本身的限制。 MIDI carries no engraving information, so the result is inferred by quantization. Performance-recorded MIDI usually needs manual cleanup — that is inherent to the format.