Metadata-Version: 2.4
Name: MusicConverter
Version: 1.0.0
Summary: A powerful music style converter
Author-email: Ma Jianfei <1005413326@qq.com>
License: Copyright (C) 2026 [MA Jianfei]
        All Rights Reserved.
Project-URL: Homepage, https://github.com/jianfei1234/MusicConverter
Keywords: music,converter,style
Classifier: Programming Language :: Python :: 3
Classifier: License :: Free For Educational Use
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mido
Requires-Dist: numpy
Requires-Dist: sounddevice
Requires-Dist: soundfile
Requires-Dist: matplotlib
Requires-Dist: pygame
Dynamic: license-file

# MusicConverter
一个简洁易用的MIDI音乐音色转换工具，原生Python开发，支持MIDI全流程自动化处理。

## 功能特性
- 读取本地MIDI文件，解析完整音符与轨道信息
- 一键分离多轨音轨，支持单轨道单独编辑
- 自由替换任意音轨乐器音色，适配GM标准音色库
- 独立单轨音频合成，分轨导出音频文件
- 多轨音频合并，内置可调参数混响效果
- 最终合成并输出标准WAV无损音频

## 快速开始

1. 克隆项目
git clone https://github.com/jianfei1234/MusicConverter.git

2. 安装依赖
pip install mido numpy sounddevice soundfile matplotlib pygame 

3. 运行示例
python example.py

## 使用示例
安装包
```bash
pip install MusicConverter
```

初始化
```python
from MusicConverter import MusicStyleConverter
converter = MusicStyleConverter()
```

读取midi文件
```python
midi_file_path = "火红的萨日朗 (1).mid"
converter.load_midi(midi_file_path)
```

分离音轨
```python
converter.separate_tracks()
```

随机转换风格
```python
multitrack3 = converter.synthesize_multitrack()
converter.save_audio(multitrack3, "random_retro.wav")
```

转换指定风格
```python
instrument_map_8bit = {
        0: '8bit_bass',  # 主旋律 - 明亮穿透
        1: '8bit_lead',  # 贝斯 - 低音支撑
        2: '8bit_arp',  # 琶音 - 填充和声
        3: '8bit_pulse',  # 副旋律 - 对位
        4: '8bit_drum',  # 打击乐 - 节奏
    }
# 生成复古游戏音乐
multitrack = converter.synthesize_multitrack(instrument_map_8bit)
converter.save_audio(multitrack, "retro_game_music.wav")
```

## 版权说明
Copyright © 2026  【Ma Jianfei】
本库仅限个人学习使用，商业用途请购买授权。



