#  python-MIDI-Simplified Music Notation Player-v2.2

**Repository Path**: YHN282615109/python-midi-simplified-music-notation-player-v2.2

## Basic Information

- **Project Name**:  python-MIDI-Simplified Music Notation Player-v2.2
- **Description**: MIDI简谱播放器 v2.2 是一款由Python开发、功能强大的音乐创作与播放软件。它将传统的简谱记谱法与现代化的MIDI技术、AI作曲技术相结合，为用户提供了一个集乐谱编辑、多轨播放、智能作曲、录音导出于一体的综合性音乐工作站。软件定位于音乐教育、作曲启蒙、业余创作及专业辅助，旨在降低音乐创作的门槛，让每个人都能轻松地将灵感转化为动听的旋律。
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/YHN282615109/python-midi-simplified-music-notation-player-v2.2
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-01
- **Last Updated**: 2026-08-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MIDI简谱播放器

## README

README.md - MIDI简谱播放器 v2.2

```markdown
🎵 MIDI简谱播放器 v2.2

一个功能强大的MIDI简谱播放器，支持多音轨编辑、AI作曲、录音等功能。

![Python](https://img.shields.io/badge/Python-3.9+-blue.svg)
![License](https://img.shields.io/badge/License-GPLv3-green.svg)
![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)



📖 目录

- [功能特点](功能特点)
- [安装指南](安装指南)
- [快速开始](快速开始)
- [简谱语法](简谱语法)
- [录音功能](录音功能)
- [AI作曲功能](ai作曲功能)
- [快捷键](快捷键)
- [常见问题](常见问题)
- [更新日志](更新日志)
- [联系方式](联系方式)



✨ 功能特点

🎼 多音轨简谱编辑
- 支持 **16个音轨**（最多可扩展至360个）
- 每个音轨独立设置：调式、乐器、速度
- 音轨添加/删除/插入/移动
- 一键删除所有空音轨

🎙️ 录音功能（v2.2新增）
- 支持系统内录 + 麦克风录音
- 录音暂停/恢复功能
- 导出多音轨MIDI（保持音轨结构）
- 导出WAV音频（自动归一化音量）

🤖 AI作曲功能（v2.2新增）
支持8种经典作曲技术：
- 旋律生成 - 基于风格参数的随机旋律
- 对位法 - 二声部/三声部对位、卡农、赋格
- 和声学 - 四部和声、爵士和弦进行
- 曲式学 - 二段式、三段式、回旋曲、变奏、奏鸣曲
- 配器法 - 乐器分配、织体生成、音域控制
- 十二音 - 序列主义作曲、音列变形
- 节奏技法 - 复节奏、切分、律动生成
- 偶然音乐 - 掷骰子作曲、元胞自动机

📥 MIDI文件导入/导出
- 导入标准MIDI文件，自动转换为简谱文本
- 多音轨分别导入到不同音轨
- 导出多音轨MIDI文件
- 导出简谱图片（简单版/专业版）

🎹 简谱格式
- 支持新格式：`[乐器,速度,调式]`
- 兼容旧格式：`调式,乐器,速度`
- 12种调式支持
- 完整的简谱语法（八度、升号、时值）



📦 安装指南

环境要求
- Python 3.9 或更高版本
- Windows / macOS / Linux

1. 克隆项目
```bash
git clone https://gitee.com/YHN282615109/midi-jianpu-player.git
cd midi-jianpu-player
```

2. 安装依赖
```bash
pip install pygame mido pillow numpy soundcard soundfile
```

可选依赖（用于录音）：
```bash
pip install pyaudio
```

3. 运行程序
```bash
python main.py
```

4. 打包为exe（Windows）
```bash
pip install pyinstaller
pyinstaller --onefile --icon=1.ico main.py
```



🚀 快速开始

1. 编辑简谱
```
[0,120,C 大调]
5-351'--76-1'-55-123-212-
```

2. 点击播放
点击 **▶ 播放全部** 按钮播放所有音轨

3. 导出乐谱
点击 **💾 导出** 导出为MIDI文件

4. 使用AI作曲
点击 **🎼 AI作曲** 打开作曲助手



📝 简谱语法

基本音符
| 符号 | 说明 | 示例 |
||||
| `1 2 3 4 5 6 7` | do re mi fa sol la si | `1 2 3` |
| `'` | 高八度 | `1'` |
| `.` | 低八度 | `1.` |
| `` | 升号 | `1` |
| `-` | 延长时值 | `5--` |
| `0` | 休止符 | `0` |
| `[ ]` | 音符组（占一拍） | `[123]` |
| `( )` | 括号组（拍长减半） | `(56)` |

示例
```
[0,120,C 大调]
5-351'--76-1'-5
```



🎙️ 录音功能

录音类型
| 类型 | 说明 |
|||
| 系统内录 | 录制电脑播放的声音（需启用立体声混音） |
| 麦克风录音 | 录制麦克风输入的声音 |

使用方法
1. 点击 **🎙️ 开始录音**
2. 播放简谱或弹奏MIDI键盘
3. 点击 **⏹️ 停止录音**
4. 导出录音：
   - 文件 → 导出录音MIDI（多音轨）
   - 文件 → 导出录音WAV（音频）



🤖 AI作曲功能

支持的作曲技术
| 技术 | 子类型 | 说明 |
||--||
| 旋律生成 | 单旋律/多声部 | 基于风格参数生成旋律 |
| 对位法 | 二声部/三声部/卡农/赋格 | 经典对位写作 |
| 和声学 | 四部和声/爵士和弦 | 和弦进行与和声配置 |
| 曲式学 | 二段式/三段式/回旋曲/变奏/奏鸣曲 | 完整曲式结构 |
| 配器法 | 弦乐四重奏/钢琴三重奏/管弦乐队 | 乐器分配与织体 |
| 十二音 | 基础序列/完整作品 | 序列主义作曲 |
| 节奏技法 | 复节奏/切分/律动 | 复杂节奏生成 |
| 偶然音乐 | 掷骰子/随机/元胞自动机 | 随机音乐创作 |

使用方法
1. 点击 **🎼 AI作曲**
2. 选择调式、风格、小节数
3. 选择作曲技术和子类型
4. 点击 **🎵 生成作品**
5. 点击 **📥 导入到播放器** 试听



⌨️ 快捷键

播放控制
| 按键 | 功能 |
|||
| `F5` | 开始播放全部音轨 |
| `Space` | 暂停/继续播放 |
| `Esc` | 停止播放 |

录音控制
| 按键 | 功能 |
|||
| `F5` | 开始录音 |
| `F6` | 停止录音 |
| `F7` | 暂停录音 |
| `F8` | 恢复录音 |

编辑
| 按键 | 功能 |
|||
| `Ctrl+A` | 全选 |
| `Ctrl+C` | 复制 |
| `Ctrl+V` | 粘贴 |
| `Ctrl+X` | 剪切 |
| `右键` | 编辑菜单 |



❓ 常见问题

Q: 播放没有声音怎么办？
**A:** 
1. 点击 设置/选项 → MIDI设备设置
2. 选择正确的MIDI输出设备
3. 如果没有设备，安装 [VirtualMIDISynth](https://coolsoft.altervista.org/en/virtualmidisynth)

Q: 录音没有声音怎么办？
**A:**
1. 系统内录：Windows需启用"立体声混音"
2. 检查麦克风是否正常工作（麦克风模式）
3. 检查系统音量设置

Q: 如何导入MIDI文件？
**A:** 文件 → 导入MIDI文件（多音轨），选择要导入的音轨

Q: 如何导出多音轨MIDI？
**A:** 点击 **💾 导出** 或 文件 → 导出MIDI



📋 更新日志

v2.2 (2026-07-31)
- 🎙️ 新增录音功能（系统内录+麦克风）
- 🎙️ 录音暂停/恢复
- 🎙️ 导出多音轨MIDI
- 🎙️ 导出WAV音频
- 🤖 AI作曲功能（8种作曲技术）
- 🎼 支持新简谱格式 `[乐器,速度,调式]`
- 🐛 修复MIDI设备初始化问题
- 🐛 修复录音MIDI导出错误

v2.1 (2026-07-27)
- 🎼 MIDI文件导入（多音轨）
- 🖼️ 简谱图片导出（简单版/专业版）
- 🎹 音轨管理增强

v2.0 (2026-07-20)
- 🎵 16音轨多声部编辑
- 🎼 12种调式支持
- 🤖 AI作曲助手



📧 联系方式

作者
- **叶海宁**
- 微信: `17876586815`
- QQ1: `791687349`
- QQ2: `282615109`
- Email: `791687349@qq.com`

代码仓库
- GitHub: [github.com/YHN282615109](https://github.com/YHN282615109)
- Gitee: [gitee.com/YHN282615109](https://gitee.com/YHN282615109)

交流群
- QQ群1: `1040271049`
- QQ群2: `954811008`



📄 许可证

```
【版权声明】

本软件为作者原创独立开发，保留所有权利。

【使用许可】
1. 个人使用：免费使用，禁止用于商业用途
2. 二次开发：需要保留原始版权信息
3. 禁止行为：
   - 未经授权二次上传
   - 倒卖软件
   - 修改后冒充原创
   - 用于非法用途

【免责声明】
本软件仅供个人学习/交流使用，作者不对因使用本软件造成的任何损失承担责任。

© 2024-2026 叶海宁 保留所有权利
```



⭐ 支持项目

如果这个项目对你有帮助，请给个 Star ⭐

[![Star](https://img.shields.io/github/stars/YHN282615109/midi-jianpu-player?style=social)](https://github.com/YHN282615109/midi-jianpu-player)
```



📁 文件说明

| 文件 | 说明 |
|||
| `README.md` | 项目介绍文档 |
| `main.py` | 主程序代码 |
| `1.ico` | 程序图标 |
| `微信收款码.png` | 微信捐赠码 |
| `支付宝收款码.jpg` | 支付宝捐赠码 |