# mp

**Repository Path**: siwpan/mp

## Basic Information

- **Project Name**: mp
- **Description**: mp（自 media-collection 拆分）
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-27
- **Last Updated**: 2026-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

> ⚠️ **已不再维护 / Archived — No longer maintained**
>
> 本仓库已停止开发投入，仅作归档保留，不再接收功能更新或 issue。代码保持原样，仅供历史参考。
> _This repository is no longer maintained. It is archived as-is for historical reference only._

# musicpipeline

> 仓库：<https://gitee.com/siwpan/mp> ｜ 许可：MIT（见 [LICENSE](LICENSE)）
> 注：文中 `<PATH>` 为路径占位符，请替换为你本机实际的目录 / 可执行文件路径。

随机音乐生成器 + WMP 风格可视化，纯 Python 标准库实现（tkinter 图形界面）。
独立仓 siwpan/mp（本地 `<PATH>`）。

## 类型
代码项目（Python）

## 目录要点
- `musicpipeline/`：Python 包，拆分为多模块：
  - `core.py`：合成引擎（音符/音阶/音色/ADSR/混响/滤波/旋律·低音·铺底·鼓轨生成/`generate_music`）
  - `analysis.py`：频谱分析（Goertzel 算法 + 帧能量）
  - `visualizer.py`：tkinter GUI 与 7 种可视化效果
  - `__init__.py`：公开接口与 `__version__`
  - `__main__.py`：`python -m musicpipeline` 命令行入口
- `*.wav / *.mp3`：生成的音频产物（已 gitignore，不入库）
- `mumu/`：本地采样/素材目录（音频产物，已 gitignore）

## 用途
随机生成音乐并做可视化演示，导出 WAV 文件，无外部依赖。

## 测试状态
包通过 `py_compile` 语法检查；`import musicpipeline` 与 `generate_music(return_samples=True)` 可生成有效 WAV（非 GUI 冒烟通过）；GUI 未运行。

## 运行

```bash
python -m musicpipeline            # 启动图形界面（默认）
python -m musicpipeline --random   # 直接随机生成一首 wav（写入当前目录）
python -m musicpipeline --batch 5  # 批量生成 5 首
```

安装后也可用 console_script：

```bash
pip install musicpipeline
musicpipeline --random
```

作为库调用：

```python
from musicpipeline import generate_music
path, params = generate_music(bpm=120, n_bars=8, scale_name="大调")
```

### 向后兼容（已废弃）
历史代码 `import orc` 仍可工作：分发包顶层附带 `orc.py` 兼容垫片，重新导出全部公开接口。
导入时会发出 `DeprecationWarning`，请尽快迁移到 `import musicpipeline`（垫片将在未来主版本移除）。

```python
import orc                       # DeprecationWarning：请改用 import musicpipeline
path, params = orc.generate_music()
```

## 发布面与许可

- gitee：siwpan/mp，release `v2.0.1`（便携源码 zip）。
- PyPI：musicpipeline 2.0.1。
- 许可：MIT · Copyright (c) 2026 siwpan