{"id":27876590,"url":"https://github.com/holgerhuo/telegram-netease-bot","last_synced_at":"2025-05-05T02:50:13.672Z","repository":{"id":196621880,"uuid":"474282901","full_name":"HolgerHuo/telegram-netease-bot","owner":"HolgerHuo","description":"Telegram 网易云音乐 Bot","archived":false,"fork":false,"pushed_at":"2023-11-22T06:23:37.000Z","size":42,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2023-11-22T07:27:38.554Z","etag":null,"topics":["bot","netease-cloud-music","python","telegram"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HolgerHuo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-03-26T08:07:59.000Z","updated_at":"2023-11-02T11:47:39.000Z","dependencies_parsed_at":"2023-09-26T15:54:14.813Z","dependency_job_id":null,"html_url":"https://github.com/HolgerHuo/telegram-netease-bot","commit_stats":null,"previous_names":["holgerhuo/telegram-netease-bot"],"tags_count":6,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HolgerHuo%2Ftelegram-netease-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HolgerHuo%2Ftelegram-netease-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HolgerHuo%2Ftelegram-netease-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HolgerHuo%2Ftelegram-netease-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HolgerHuo","download_url":"https://codeload.github.com/HolgerHuo/telegram-netease-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252429956,"owners_count":21746571,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bot","netease-cloud-music","python","telegram"],"created_at":"2025-05-05T02:50:12.653Z","updated_at":"2025-05-05T02:50:13.650Z","avatar_url":"https://github.com/HolgerHuo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Telegram Netease Bot - Telegram 网易云音乐 Bot\n\n~~Note: As the initial version of this bot is of low quality and is hard to extent horizontally, future development on this version may be dropped. A rewrite of this program is expected to be born some time around Jan. 2023.~~\n\nThe rewrite is pending.\n\n---\n\n![GitHub last commit](https://img.shields.io/github/last-commit/holgerhuo/telegram-netease-bot)![GitHub release (latest by date)](https://img.shields.io/github/v/release/holgerhuo/telegram-netease-bot)![GitHub](https://img.shields.io/github/license/holgerhuo/telegram-netease-bot)![GitHub all releases](https://img.shields.io/github/downloads/holgerhuo/telegram-netease-bot/total)![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/holgerhuo/telegram-netease-bot)\n\nA python telegram bot enabling you to send **Netease Cloud Music** and **YouTube music (extracted from videos)** in chats\n\n## ✨ Features\n\n- Ease-of-use: No need to type \"/\" for command\n- Extensible: Built on Python3 with [pyTelegramBotAPI](https://github.com/eternnoir/pyTelegramBotAPI)\n- Elastic Netease Backend: Powered by [NodeJS NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi)\n- Embed music tags automatically\n- Enhanced caching system\n- Web UI allow admins to easily update expired netease cloud music tokens\n\n## 👷‍♂️ QuickStart\n\nAdd example Radio 669 by going to [@radio_669_bot](https://t.me/radio669_bot).\n\nPress `Start`\n\nChoose your music by sending \n\"**点歌** \u003csong_name\u003e\"\n\nAdd r669 bot to your favorite groups, ...\n\nEnjoy it!\n\n## 💻 Deployment \n\n### Prerequisites\n\n**telegram-netease-bot requires `Python3.7+`, which means you'll have to compile Python3.7 yourself if you are on CentOS 7**\n\n- A working NodeJS [NeteaseCloudMusicAPI](https://github.com/Binaryify/NeteaseCloudMusicApi) (Can be deployed on Vercel)\n- Python 3.7+ and pip3\n- Bot token obtained from [BotFather](https://t.me/botfather)\n- Obtain your NCM UserID\n- If you want to use the webui for updating tokens on the fly, a reverse proxy can be set up\n\n#### How-to: Obtain NCM UserID\n1. Login to your NodeJS NCMApi using the methods in the [documentation](https://binaryify.github.io/NeteaseCloudMusicApi/#/?id=%e7%99%bb%e5%bd%95) (It is recommended to login using SMS code)\n2. Use your browser to inspect cookies and find the value of `MUSIC_U`\n3. That's it!\n\nor a much easier way:\n\n1. open the web ui (by default: http://localhost:5000)\n2. scan the qr code with NCM app\n\n### Install\n\n```bash\ngit clone https://github.com/HolgerHuo/telegram-netease-bot.git r669\ncd r669\npip3 install -r requirements.txt\npython3 run.py\n```\n\nA sample systemd service is shipped at r669.service. Add it to your system if you like.\n\nDon't forget to change your bot's name, avatar, and about info and enjoy it!\n\nTo use the webui, you also need to start the uwsgi server as shown in systemd file.\n\nTo securely access the web ui, you need to setup firewall rules and reverse proxy.\n\n## 💖 Credits\n- [pyTelegramBotAPI](https://github.com/eternnoir/pyTelegramBotAPI)\n- [NeteaseCloudMusicAPI](https://github.com/Binaryify/NeteaseCloudMusicApi)\n- [Flask](https://github.com/pallets/flask/)\n\n## 📜 License\n\nGNU General Public License v3.0\n\n©️ Holger Huo\n\n[@holgerhuo@dragon-fly.club](https://mast.dragon-fly.club/@holgerhuo)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholgerhuo%2Ftelegram-netease-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fholgerhuo%2Ftelegram-netease-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholgerhuo%2Ftelegram-netease-bot/lists"}