**music-tool-kit**，主要使用场景为提取[youtube](https://www.youtube.com)和[bilibili](https://www.bilibili.com)视频中的音频,支持**音频下载**,**元信息自动补全**,**音频截取**,**提取伴奏**,**youtube 列表批量下载**,**自定义批量下载**等.配合[spotify](https://open.spotify.com)的**本地文件**功能可以极大的提升音乐体验([教程](https://www.bilibili.com/video/BV1VL411T7mp/?vd_source=04c6a0d121b6fb871e3d3c0a2554b29b))
> [!NOTE]
>
> 本项目仅为个人使用,无任何商业用途,仅支持 mp3 格式的音乐
---
**内容目录**：
- [环境准备](#环境准备)
- [安装](#安装)
- [升级](#升级)
- [卸载](#卸载)
- [使用](#使用)
- [音乐下载](#音乐下载)
- [音乐搜索](#音乐搜索)
- [音乐剪辑](#音乐剪辑)
- [提取伴奏](#提取伴奏)
- [csv 批量模板](#csv-批量模板)
- [批量下载](#批量下载)
- [License](#license)
# 环境准备
## 安装
```bash
python -m pip install –upgrade pip
pip install -U music-tool-kit
```
> [!IMPORTANT]
>
> - [python](https://www.python.org/)版本:**3.11.0及以上**
> - 需安装[ffmpeg](https://ffmpeg.org/)并正确配置环境变量
> - 如果需要下载youtube的音乐,需要准备**科学上网**环境
> - `[]`标记的项目表示可不填
> - 为规避特殊字符导致路径识别失败,**标题**、**路径**、**URL**等相关的参数尽量使用**双引号**`""`
## 升级
```bash
pip install -U music-tool-kit
```
## 卸载
```bash
pip uninstall music-tool-kit
```
# 使用
## 音乐下载
```bash
mk "网址" "[标题]" "[封面url]"
```
**普通下载**
**列表下载**使用方法为 `mk "列表url | 列表序号"` ,**url 需要为 [youtube](https://www.youtube.com) 的列表格式(url中含有list=)**,如果想下载全部歌曲,直接输入 `mk "列表url |"` 即可!
例如:
```bash
mk "https://www.youtube.com/playlist?list=PL8B3F8A7B0A9F4DE8 | 1,2,3,4,5"
```
> [!TIP]
>
> - 标题格式为 **歌曲名-歌手(专辑名)** 输出歌曲格式默认为 **mp3**
> - music-tool-kit会根据**标题**,自动将下载的音频元信息补全,包括歌曲名,歌手(艺术家),内置封面图片,以及专辑名称.如果不遵循该标题格式,元信息可能补全失败
> - 仅支持下载 youtube 的列表下载,url|后面的列表序号之间需要用逗号分隔
## 音乐搜索
```bash
mk -s "关键字"
```
支持 youtube bilibili 输出优先级 youtube > bilibili,输入列表序号,输入标题,完成下载
> [!TIP]
>
> - 最多显示20条数据
> - 直接按`Enter`可以跳出序号选择界面,输入的序号不能超过最大返回的条目数
> - 如果不想设置标题 直接按`Enter`即可
## 音乐剪辑
```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` (一般)
> [!WARNING]
> - 默认模型为`UVR_MDXNET_Main`,具体请结合音乐类型和自己的实际听感自行调整模型
> - 伴奏提取比较吃 cpu 性能,时间比较漫长,请耐心等待,大概需要 5~10 分钟
## csv 批量模板
```bash
mk -t
```
生成的模板文件如下:
用户自行填写下载信息,保存后使用`mk "csv文件"`即可批量下载
| url | title | cover_url | start_time | end_time | instrumental |
| ---- | ----- | --------- | ---------- | -------- | ------------ |
| 网址 | 标题 | 封面 url | 开始时间 | 结束时间 | 是否生成伴奏(true or false) |
## 批量下载
```bash
mk "csv文件"
```
# License
This work is released under the MIT license. A copy of the license is provided in the [LICENSE](https://raw.githubusercontent.com/nichuanfang/music-tool-kit/main/LICENSE) file.
Raw data
{
"_id": null,
"home_page": "https://github.com/nichuanfang/music-tool-kit",
"name": "music-tool-kit",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": "",
"keywords": "mkmtkmusic,musictool,musicdownload,musicclip,musickit,musictoolkit",
"author": "Nichuan Fang",
"author_email": "f18326186224@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/63/d2/4980c384bc12d14d8a82cc08bb4cbe0c6ab9a1922e841f6abebb0deae841/music-tool-kit-1.3.4.tar.gz",
"platform": "any",
"description": "**music-tool-kit**\uff0c\u4e3b\u8981\u4f7f\u7528\u573a\u666f\u4e3a\u63d0\u53d6[youtube](https://www.youtube.com)\u548c[bilibili](https://www.bilibili.com)\u89c6\u9891\u4e2d\u7684\u97f3\u9891,\u652f\u6301**\u97f3\u9891\u4e0b\u8f7d**,**\u5143\u4fe1\u606f\u81ea\u52a8\u8865\u5168**,**\u97f3\u9891\u622a\u53d6**,**\u63d0\u53d6\u4f34\u594f**,**youtube \u5217\u8868\u6279\u91cf\u4e0b\u8f7d**,**\u81ea\u5b9a\u4e49\u6279\u91cf\u4e0b\u8f7d**\u7b49.\u914d\u5408[spotify](https://open.spotify.com)\u7684**\u672c\u5730\u6587\u4ef6**\u529f\u80fd\u53ef\u4ee5\u6781\u5927\u7684\u63d0\u5347\u97f3\u4e50\u4f53\u9a8c([\u6559\u7a0b](https://www.bilibili.com/video/BV1VL411T7mp/?vd_source=04c6a0d121b6fb871e3d3c0a2554b29b))\n\n> [!NOTE]\n>\n> \u672c\u9879\u76ee\u4ec5\u4e3a\u4e2a\u4eba\u4f7f\u7528,\u65e0\u4efb\u4f55\u5546\u4e1a\u7528\u9014,\u4ec5\u652f\u6301 mp3 \u683c\u5f0f\u7684\u97f3\u4e50\n\n---\n**\u5185\u5bb9\u76ee\u5f55**\uff1a\n- [\u73af\u5883\u51c6\u5907](#\u73af\u5883\u51c6\u5907)\n - [\u5b89\u88c5](#\u5b89\u88c5)\n - [\u5347\u7ea7](#\u5347\u7ea7)\n - [\u5378\u8f7d](#\u5378\u8f7d)\n- [\u4f7f\u7528](#\u4f7f\u7528)\n - [\u97f3\u4e50\u4e0b\u8f7d](#\u97f3\u4e50\u4e0b\u8f7d)\n - [\u97f3\u4e50\u641c\u7d22](#\u97f3\u4e50\u641c\u7d22)\n - [\u97f3\u4e50\u526a\u8f91](#\u97f3\u4e50\u526a\u8f91)\n - [\u63d0\u53d6\u4f34\u594f](#\u63d0\u53d6\u4f34\u594f)\n - [csv \u6279\u91cf\u6a21\u677f](#csv-\u6279\u91cf\u6a21\u677f)\n - [\u6279\u91cf\u4e0b\u8f7d](#\u6279\u91cf\u4e0b\u8f7d)\n- [License](#license)\n\n# \u73af\u5883\u51c6\u5907\n\n## \u5b89\u88c5\n\n```bash\npython -m pip install \u2013upgrade pip\npip install -U music-tool-kit\n```\n\n\n\n> [!IMPORTANT]\n>\n> - [python](https://www.python.org/)\u7248\u672c:**3.11.0\u53ca\u4ee5\u4e0a**\n> - \u9700\u5b89\u88c5[ffmpeg](https://ffmpeg.org/)\u5e76\u6b63\u786e\u914d\u7f6e\u73af\u5883\u53d8\u91cf\n> - \u5982\u679c\u9700\u8981\u4e0b\u8f7dyoutube\u7684\u97f3\u4e50,\u9700\u8981\u51c6\u5907**\u79d1\u5b66\u4e0a\u7f51**\u73af\u5883\n> - `[]`\u6807\u8bb0\u7684\u9879\u76ee\u8868\u793a\u53ef\u4e0d\u586b\n> - \u4e3a\u89c4\u907f\u7279\u6b8a\u5b57\u7b26\u5bfc\u81f4\u8def\u5f84\u8bc6\u522b\u5931\u8d25,**\u6807\u9898**\u3001**\u8def\u5f84**\u3001**URL**\u7b49\u76f8\u5173\u7684\u53c2\u6570\u5c3d\u91cf\u4f7f\u7528**\u53cc\u5f15\u53f7**`\"\"`\n\n## \u5347\u7ea7\n\n```bash\npip install -U music-tool-kit\n```\n\n## \u5378\u8f7d\n\n```bash\npip uninstall music-tool-kit\n```\n\n# \u4f7f\u7528\n\n## \u97f3\u4e50\u4e0b\u8f7d\n\n```bash\nmk \"\u7f51\u5740\" \"[\u6807\u9898]\" \"[\u5c01\u9762url]\"\n\n```\n\n**\u666e\u901a\u4e0b\u8f7d**\n\n\n**\u5217\u8868\u4e0b\u8f7d**\u4f7f\u7528\u65b9\u6cd5\u4e3a `mk \"\u5217\u8868url | \u5217\u8868\u5e8f\u53f7\"` ,**url \u9700\u8981\u4e3a [youtube](https://www.youtube.com) \u7684\u5217\u8868\u683c\u5f0f(url\u4e2d\u542b\u6709list=)**,\u5982\u679c\u60f3\u4e0b\u8f7d\u5168\u90e8\u6b4c\u66f2,\u76f4\u63a5\u8f93\u5165 `mk \"\u5217\u8868url |\"` \u5373\u53ef!\n\n\u4f8b\u5982:\n```bash\nmk \"https://www.youtube.com/playlist?list=PL8B3F8A7B0A9F4DE8 | 1,2,3,4,5\"\n```\n\n\n> [!TIP]\n>\n> - \u6807\u9898\u683c\u5f0f\u4e3a **\u6b4c\u66f2\u540d-\u6b4c\u624b(\u4e13\u8f91\u540d)** \u8f93\u51fa\u6b4c\u66f2\u683c\u5f0f\u9ed8\u8ba4\u4e3a **mp3**\n> - music-tool-kit\u4f1a\u6839\u636e**\u6807\u9898**,\u81ea\u52a8\u5c06\u4e0b\u8f7d\u7684\u97f3\u9891\u5143\u4fe1\u606f\u8865\u5168,\u5305\u62ec\u6b4c\u66f2\u540d,\u6b4c\u624b(\u827a\u672f\u5bb6),\u5185\u7f6e\u5c01\u9762\u56fe\u7247,\u4ee5\u53ca\u4e13\u8f91\u540d\u79f0.\u5982\u679c\u4e0d\u9075\u5faa\u8be5\u6807\u9898\u683c\u5f0f,\u5143\u4fe1\u606f\u53ef\u80fd\u8865\u5168\u5931\u8d25\n> - \u4ec5\u652f\u6301\u4e0b\u8f7d youtube \u7684\u5217\u8868\u4e0b\u8f7d,url|\u540e\u9762\u7684\u5217\u8868\u5e8f\u53f7\u4e4b\u95f4\u9700\u8981\u7528\u9017\u53f7\u5206\u9694\n\n## \u97f3\u4e50\u641c\u7d22\n\n```bash\nmk -s \"\u5173\u952e\u5b57\"\n```\n\n\u652f\u6301 youtube bilibili \u8f93\u51fa\u4f18\u5148\u7ea7 youtube > bilibili,\u8f93\u5165\u5217\u8868\u5e8f\u53f7,\u8f93\u5165\u6807\u9898,\u5b8c\u6210\u4e0b\u8f7d\n\n> [!TIP]\n>\n> - \u6700\u591a\u663e\u793a20\u6761\u6570\u636e\n> - \u76f4\u63a5\u6309`Enter`\u53ef\u4ee5\u8df3\u51fa\u5e8f\u53f7\u9009\u62e9\u754c\u9762,\u8f93\u5165\u7684\u5e8f\u53f7\u4e0d\u80fd\u8d85\u8fc7\u6700\u5927\u8fd4\u56de\u7684\u6761\u76ee\u6570\n> - \u5982\u679c\u4e0d\u60f3\u8bbe\u7f6e\u6807\u9898 \u76f4\u63a5\u6309`Enter`\u5373\u53ef\n\n## \u97f3\u4e50\u526a\u8f91\n\n```bash\nmk -c \"\u8f93\u5165\u7684mp3\u6587\u4ef6\" \u5f00\u59cb\u65f6\u95f4 \u7ed3\u675f\u65f6\u95f4\n```\n\n\n\n> Tips: \u65f6\u95f4\u683c\u5f0f\u4e3a `00:00:00`\n\n## \u63d0\u53d6\u4f34\u594f\n\n```bash\nmk -e \"\u8f93\u5165\u7684mp3\u6587\u4ef6\" [\u6a21\u578b\u540d\u79f0]\n```\n\n\u652f\u6301\u7684\u6a21\u578b:\n\n- `UVR_MDXNET_Main` (\u6574\u4f53\u8f83\u597d)\n- `UVR-MDX-NET-Inst_Main` (\u6574\u4f53\u8f83\u597d)\n- `UVR-MDX-NET-Inst_3` (\u6574\u4f53\u8f83\u597d)\n- `UVR-MDX-NET-Inst_HQ_3` (\u6574\u4f53\u8f83\u597d)\n- `UVR_MDXNET_KARA_2` (\u4e00\u822c,\u4eba\u58f0\u5254\u9664\u4e0d\u5e72\u51c0,\u58f0\u97f3\u5ffd\u9ad8\u5ffd\u4f4e)\n- `Kim_Inst` (\u4e00\u822c)\n\n\n\n> [!WARNING]\n> - \u9ed8\u8ba4\u6a21\u578b\u4e3a`UVR_MDXNET_Main`,\u5177\u4f53\u8bf7\u7ed3\u5408\u97f3\u4e50\u7c7b\u578b\u548c\u81ea\u5df1\u7684\u5b9e\u9645\u542c\u611f\u81ea\u884c\u8c03\u6574\u6a21\u578b\n> - \u4f34\u594f\u63d0\u53d6\u6bd4\u8f83\u5403 cpu \u6027\u80fd,\u65f6\u95f4\u6bd4\u8f83\u6f2b\u957f,\u8bf7\u8010\u5fc3\u7b49\u5f85,\u5927\u6982\u9700\u8981 5~10 \u5206\u949f\n\n## csv \u6279\u91cf\u6a21\u677f\n\n```bash\nmk -t\n```\n\n\u751f\u6210\u7684\u6a21\u677f\u6587\u4ef6\u5982\u4e0b:\n\n\u7528\u6237\u81ea\u884c\u586b\u5199\u4e0b\u8f7d\u4fe1\u606f,\u4fdd\u5b58\u540e\u4f7f\u7528`mk \"csv\u6587\u4ef6\"`\u5373\u53ef\u6279\u91cf\u4e0b\u8f7d\n\n| url | title | cover_url | start_time | end_time | instrumental |\n| ---- | ----- | --------- | ---------- | -------- | ------------ |\n| \u7f51\u5740 | \u6807\u9898 | \u5c01\u9762 url | \u5f00\u59cb\u65f6\u95f4 | \u7ed3\u675f\u65f6\u95f4 | \u662f\u5426\u751f\u6210\u4f34\u594f(true or false) |\n\n## \u6279\u91cf\u4e0b\u8f7d\n\n```bash\nmk \"csv\u6587\u4ef6\"\n```\n\n\n\n# License\n\nThis work is released under the MIT license. A copy of the license is provided in the [LICENSE](https://raw.githubusercontent.com/nichuanfang/music-tool-kit/main/LICENSE) file.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A tool kit for music download and clip",
"version": "1.3.4",
"project_urls": {
"Bug Tracker": "https://github.com/nichuanfang/music-tool-kit/issues",
"Documentation": "https://blog.jaychou.site/2023/12/02/music-tool-kit%E5%B7%A5%E5%85%B7/",
"Homepage": "https://github.com/nichuanfang/music-tool-kit",
"Source Code": "https://github.com/nichuanfang/music-tool-kit"
},
"split_keywords": [
"mkmtkmusic",
"musictool",
"musicdownload",
"musicclip",
"musickit",
"musictoolkit"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b615da01f9231014fb4175bef0ea48c5d2f461f4ec9af694f4ef0e571ab38c8f",
"md5": "a1dca76c8bc26fad28704405f1bdec20",
"sha256": "f2d8c4f64e05a204ae95e9316feda75f9f8ceb6e23a1346ef7ee2c200e5e9bf1"
},
"downloads": -1,
"filename": "music_tool_kit-1.3.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a1dca76c8bc26fad28704405f1bdec20",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 10654,
"upload_time": "2024-02-01T10:32:44",
"upload_time_iso_8601": "2024-02-01T10:32:44.683471Z",
"url": "https://files.pythonhosted.org/packages/b6/15/da01f9231014fb4175bef0ea48c5d2f461f4ec9af694f4ef0e571ab38c8f/music_tool_kit-1.3.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "63d24980c384bc12d14d8a82cc08bb4cbe0c6ab9a1922e841f6abebb0deae841",
"md5": "aa4fd85551a5127928b15cd1bfaea738",
"sha256": "84ad82cf8cff1c504b99d2676569157c7af6202b4eb7b42acfe0ca9b3d28c0b0"
},
"downloads": -1,
"filename": "music-tool-kit-1.3.4.tar.gz",
"has_sig": false,
"md5_digest": "aa4fd85551a5127928b15cd1bfaea738",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 10701,
"upload_time": "2024-02-01T10:32:48",
"upload_time_iso_8601": "2024-02-01T10:32:48.214742Z",
"url": "https://files.pythonhosted.org/packages/63/d2/4980c384bc12d14d8a82cc08bb4cbe0c6ab9a1922e841f6abebb0deae841/music-tool-kit-1.3.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-01 10:32:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nichuanfang",
"github_project": "music-tool-kit",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "bilibili_api_python",
"specs": [
[
"==",
"16.1.1"
]
]
},
{
"name": "rich",
"specs": [
[
"==",
"13.7.0"
]
]
},
{
"name": "setuptools",
"specs": [
[
"==",
"58.0.0"
]
]
},
{
"name": "yt_dlp",
"specs": [
[
"==",
"2023.12.30"
]
]
}
],
"lcname": "music-tool-kit"
}
JSON
