{"id":13844220,"url":"https://github.com/codezjx/netease-cloud-music-dl","last_synced_at":"2026-01-31T10:37:16.809Z","repository":{"id":44384825,"uuid":"97240202","full_name":"codezjx/netease-cloud-music-dl","owner":"codezjx","description":"Netease cloud music song downloader, with full ID3 metadata, eg: front cover image, artist name, album name, song title and so on.","archived":false,"fork":false,"pushed_at":"2024-06-07T12:23:31.000Z","size":545,"stargazers_count":547,"open_issues_count":15,"forks_count":85,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-07-11T22:32:06.842Z","etag":null,"topics":["cloud-music","downloader","id3-tags","netease"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codezjx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-07-14T14:05:27.000Z","updated_at":"2025-07-03T03:46:11.000Z","dependencies_parsed_at":"2024-06-07T13:54:48.528Z","dependency_job_id":"767567a5-61d8-4380-94d7-29cc24ad16a6","html_url":"https://github.com/codezjx/netease-cloud-music-dl","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codezjx/netease-cloud-music-dl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codezjx%2Fnetease-cloud-music-dl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codezjx%2Fnetease-cloud-music-dl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codezjx%2Fnetease-cloud-music-dl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codezjx%2Fnetease-cloud-music-dl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codezjx","download_url":"https://codeload.github.com/codezjx/netease-cloud-music-dl/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codezjx%2Fnetease-cloud-music-dl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28938800,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T10:18:23.202Z","status":"ssl_error","status_checked_at":"2026-01-31T10:18:22.693Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud-music","downloader","id3-tags","netease"],"created_at":"2024-08-04T17:02:37.695Z","updated_at":"2026-01-31T10:37:16.779Z","avatar_url":"https://github.com/codezjx.png","language":"Python","funding_links":[],"categories":["Python (1887)","Python"],"sub_categories":[],"readme":"# 网易云音乐下载器\n基于Python3.X编写的网易云音乐命令行下载器，自动下载专辑封面，记录歌手名、音乐标题、专辑名等元数据，并写入[ID3 Tags][1] metadata容器。在github上试了几个高星的下载器都没有写入专辑封面，对于强迫症患者简直不能忍，于是一怒之下决定自己写。\n\n## Preview\n![Preview](preview.gif)\n\n## Installation\n\n若没有安装Python3，请先到官网下载并安装：\n\u003e https://www.python.org/download/releases/3.0/\n\n\n首先下载源码：\n```bash\n$ git clone https://github.com/codezjx/netease-cloud-music-dl.git\n```\n\n进入根目录，然后执行：\n```bash\n$ python3 setup.py install\n```\n\n最终显示以下log，表示顺利安装：\n```\nrunning install\nrunning bdist_egg\nrunning egg_info\n...\n...\nFinished processing dependencies for netease-cloud-music-dl==x.x.x\n```\n\n后续直接在命令行中通过`ncm`指令即可快速调用相关功能，**Warning: 目前只支持Python3.x版本**\n\n## Feature\n- 支持下载专辑封面并嵌入MP3文件\n- 支持写入歌手名、音乐标题、专辑名等信息至[ID3 Tags][1]\n- 支持跳过已下载的音频文件\n- 支持常见设置选项，如：保存路径、音乐命名格式、文件智能分类等\n- 默认下载比特率为320k的高品质音乐（若木有320k则会自动下载最高比特率）\n- 支持下载单首/多首歌曲\n- 支持下载歌手热门单曲（可配置最大下载数）\n- 支持下载专辑所有歌曲\n- 支持下载公开歌单所有歌曲\n\n**（注意：已下架的音乐暂时无法下载）**\n\n通过`ncm -h`即可查看所支持的参数列表：\n```\n$ ncm -h\nusage: ncm [-h] [-s song_id] [-ss song_ids [song_ids ...]] [-hot artist_id]\n           [-a album_id] [-p playlist_id]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -s song_id            Download a song by song_id\n  -ss song_ids [song_ids ...]\n                        Download a song list, song_id split by space\n  -hot artist_id        Download an artist hot 50 songs by artist_id\n  -a album_id           Download an album all songs by album_id\n  -p playlist_id        Download a playlist all songs by playlist_id\n```\n\n## Usage\n\n### 下载单曲\n\n使用参数`-s`，后加歌曲id或者歌曲完整url，如：\n```bash\n$ ncm -s 123123\nor\n$ ncm -s http://music.163.com/#/song?id=123123\n```\n\n### 下载多首歌曲\n\n使用参数`-ss`，后加歌曲ids或者歌曲完整urls(id或url之间通过空格隔开)，如：\n```bash\n$ ncm -ss 123123 456456 789789\nor\n$ ncm -ss url1 url2 url3\n```\n\n### 下载某歌手的热门单曲(默认下50首，可配置)\n\n使用参数`-hot`，后加歌手id或者完整url，如：\n```bash\n$ ncm -hot 123123\nor\n$ ncm -hot http://music.163.com/#/artist?id=123123\n```\n\n### 下载某张专辑的所有歌曲\n\n使用参数`-a`，后加专辑id或者完整url，使用方法同上。\n\n### 下载某个公开的歌单\n\n使用参数`-p`，后加歌单id或者完整url，使用方法同上，必须确认是**公开**的歌单才能下载哦。\n\n## Settings\n\n配置文件在在用户目录下自动生成，路径如下：\n```\n/Users/yourUserName/.ncm/ncm.ini\n```\n\n目前支持以下几项设置：\n```\n[settings]\n\n#--------------------------------------\n# 热门音乐的最大下载数，默认50\n# Range: 0 \u003c hot_max \u003c= 50\n#--------------------------------------\ndownload.hot_max = 50\n\n#--------------------------------------\n# 音乐文件的下载路径，默认在用户目录.ncm/download目录下\n#--------------------------------------\ndownload.dir = /Users/yourUserName/.ncm/download\n\n#--------------------------------------\n# 音乐命名格式，默认1\n# 1: 歌曲名\n# 2: 歌手 - 歌曲名\n# 3: 歌曲名 - 歌手\n#--------------------------------------\nsong.name_type = 1\n\n#--------------------------------------\n# 文件智能分类，默认1\n# 1: 不分文件夹\n# 2: 按歌手分文件夹\n# 3: 按歌手/专辑分文件夹\n#--------------------------------------\nsong.folder_type = 1\n```\n\n**Warning:** 智能分类设置目前只针对`-s`和`-ss`参数有效，`-hot/-a/-p`分别会存于后缀为：`-hot50/-album/-playlist`的文件夹中，方便管理本地音乐。\n\n## Feedback\n\n如果遇到Bugs，欢迎提issue或者PR，谢谢各位支持~\n\n## License\n\nMIT License\n\nCopyright (c) 2017 codezjx \u003ccode.zjx@gmail.com\u003e\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n[1]: https://zh.wikipedia.org/wiki/ID3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodezjx%2Fnetease-cloud-music-dl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodezjx%2Fnetease-cloud-music-dl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodezjx%2Fnetease-cloud-music-dl/lists"}