Metadata-Version: 2.1
Name: music-tool-kit
Version: 1.1.7
Summary: A tool kit for music download and clip
Home-page: https://github.com/nichuanfang/music-tool-kit
Author: Nichuan Fang
Author-email: f18326186224@gmail.com
License: MIT
Project-URL: Source Code, https://github.com/nichuanfang/music-tool-kit
Project-URL: Bug Tracker, https://github.com/nichuanfang/music-tool-kit/issues
Project-URL: Documentation, https://github.com/nichuanfang/music-tool-kit#music-tool-kit-%E9%9F%B3%E4%B9%90%E5%B7%A5%E5%85%B7%E7%AE%B1
Keywords: mkmtkmusic,musictool,musicdownload,musicclip,musickit,musictoolkit
Platform: any
Classifier: Development Status :: 1 - Planning
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE

# music-tool-kit 音乐工具箱

music-tool-kit，主要使用场景为提取[youtube](https://www.youtube.com)和[bilibili](https://www.bilibili.com)视频中的音频,支持音频下载,音频截取,提取伴奏,youtube 列表批量下载等.

> **Note**
>
> 本项目仅为个人使用,无任何商业用途,仅支持 mp3 格式的音乐

## 安装

```bash
pip install -U music-tool-kit
```

![help](example/help.png)

> Tips: python 版本: 3.11.0 及以上,需安装 ffmpeg

## 使用

### 音乐下载

```bash
mk  "网址" [输出] "[封面url]"

```

![download ](./example/download.png)

- 输出格式为 歌曲名-歌手(专辑名) 输出歌曲格式为 mp3 可选, 封面 url 也可选

- 支持下载 youtube 的列表 使用方法为 `mk "列表url | 列表序号"` url 需要为 [youtube](https://www.youtube.com) 的列表 url 序号之间需要用逗号分隔 如果想下载全部歌曲 直接输入 `mk "列表url |"` 即可!例如: `mk "https://www.youtube.com/playlist?list=PL8B3F8A7B0A9F4DE8 | 1,2,3,4,5"`

### 音乐搜索

```bash
mk -s "关键字"
```

![search](./example/search.png)
支持 youtube bilibili 输出优先级 youtube > bilibili

### 音乐剪辑

```bash
mk -c "输入的mp3文件" 开始时间 结束时间
```

> Tips: 时间格式为 `00:00:00`

### 提取伴奏

```bash
mk -e "输入的mp3文件" [模型名称]
```

支持的模型:

- `UVR_MDXNET_Main` (整体较好)
- `UVR-MDX-NET-Inst_Main` (整体较好)
- `UVR-MDX-NET-Inst_3` (整体较好)
- `UVR-MDX-NET-Inst_HQ_3` (整体较好)
- `UVR_MDXNET_KARA_2` (一般,人声剔除不干净,声音忽高忽低)
- `Kim_Inst` (一般)

> **Note**
>
> 默认模型为`UVR_MDXNET_Main`,具体请结合音乐类型和自己的实际听感自行调整模型

### 生成批量下载 csv 模板文件

```bash
mk -t
```

### 批量下载

```bash
mk "csv文件"
```

> Tips: 格式为 `下载 url,标题,封面 url,截取开始时间,截取终止时间,是否生成伴奏(true 或 false)`

## License

This work is released under the MIT license. A copy of the license is provided in the [LICENSE](./LICENSE) file.
