MCPcopy Index your code
hub / github.com/Sherlockouo/music

github.com/Sherlockouo/music @v2.8.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.8.0 ↗ · + Follow
868 symbols 2,415 edges 276 files 33 documented · 4%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
<h2 align="center" style="font-weight: 800">R3PLAYX</h2>
<h2 align="center">
    <a href="https://t.me/+MrhsgG741wQxNjg9">💻 加入TG群组,参与开发讨论 👊</a>




    <a href="https://github.com/Sherlockouo/music/wiki/For-Developers">🧭 开发指南 👆 点这里,查看wiki </a>
</h2>



    高颜值的第三方音乐播放器



    <a href="https://music.xtify.top/" target="blank"><strong>🌎 访问最新DEMO</strong></a>&nbsp;&nbsp;|&nbsp;&nbsp;
    <a href="https://r3play.app/" target="blank"><strong>🌎 访问原版DEMO</strong></a>&nbsp;&nbsp;|&nbsp;&nbsp;
    <a href="https://github.com/Sherlockouo/music/releases" target="blank"><strong>📦️ 下载安装包</strong></a>












<img src="https://github.com/sherlockouo/music/actions/workflows/build-dev.yml/badge.svg" />
<img src="https://img.shields.io/badge/downloads-5.0k-deepgreen" />
<img src="https://img.shields.io/badge/latest_version-2.7.4-deepgreen" />
<img src="https://img.shields.io/badge/Ask_Zread-_.svg?style=flat-square&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/Sherlockouo/music" />

关于 Beta 版本

目前 R3PLAYX 处于 Beta 阶段,仍在开发中,功能尚未完善。建议每次更新时,先卸载旧版本的 R3PLAY,再重新安装。如遇到问题,欢迎提 issue。

✨ 特性

  • ✅ 使用 React + Electron 开发
  • 🔴 网易云账号登录(扫码/手机/邮箱登录)
  • 📺 支持 MV 播放
  • 🚫🤝 无任何社交功能
  • 📖 支持歌词展示
  • 🎨 新增全局背景
  • 🎵 支持更多音源
  • 🐳 支持 docker 部署
  • 🔊 支持私人 FM
  • 🔧 更多特性,期待你的建议和加入

📦️ 安装

访问本项目的 Releases 页面下载安装包。

对于 NixOS 上的安装,请参考 EndCredits/R3PLAYX-nix

📜 开源许可

API 源代码来自 Binaryify/NeteaseCloudMusicApi

本项目仅供个人学习研究之目的,不得用于任何商业或非法活动。

基于 AGPL license 许可进行开源。

任何基于此项目开发的项目都必须遵守开源协议,在项目 README/应用内的关于页面和介绍网站中明确说明基于此项目开发,并附上此项目 GitHub 页面的链接。

截图

  • 主页 image
  • 发现 image
  • 新增歌词展示功能 lyrics-screenshot
  • 新增音源,全局背景 background
  • ~~新增歌词特效~~ 由于性能问题被干掉了

如果你遇到了任何问题,我会尽力帮助你解决。以下是一些常见问题的解决方案:

  1. 无法登录网易云账号:请确保你的账号和密码输入正确,如果是扫码登录,请扫描二维码并在手机上确认登录。

  2. 如何播放MV:在播放器界面的右下角有一个 "MV" 按钮,点击它即可打开 MV 播放器。

  3. 找不到歌词:在播放器界面的右上角有一个 "歌词" 按钮,点击它即可显示当前歌曲的歌词。如果歌曲没有歌词信息,可能是因为该歌曲没有提供歌词。

  4. 如何更改全局背景:你可以在设置中选择一个背景图像作为全局背景。在播放器界面的右上角有一个 "设置" 按钮,点击它并在 "主题" 选项卡中选择一个背景图像。

如果你的问题不在上述范围内,请提供更多详细信息,我会尽力提供帮助。同时,你也可以加入我们的开发讨论群组,与其他开发者一起讨论问题和分享经验。

希望以上解决方案对你有帮助!如果你还有其他问题,随时提问。

赞赏(这将被用于为开发者充能,进行更加激情的创造)

赞赏

免责声明 Disclaimer

  • 本代码库仅供个人用于在线学习和研究使用,不得用于商业用途。
  • 除了许可条款中规定的事项外,您还知道将本代码库用于商业或其他竞争行为可能会产生法律风险。
  • 如果您认为本代码库侵犯了您的知识产权,请发布 PR, Issue 或 DMCA 请求,表达您删除相关引擎或代码的意图。

Star History

<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Sherlockouo/music&type=Date" />

Credit

Designed by JACKCRING

Extension points exported contracts — how you extend this code

Thumbar (Interface)
(no doc) [3 implementers]
packages/desktop/main/windowsTaskbar.ts
CacheAPIsParams (Interface)
(no doc)
packages/shared/CacheAPIs.ts
CommonTableStructure (Interface)
(no doc)
packages/server/src/utils/db.ts
Window (Interface)
(no doc)
packages/web/global.d.ts
YPMTray (Interface)
(no doc) [2 implementers]
packages/desktop/main/tray.ts
CacheAPIsResponse (Interface)
(no doc)
packages/shared/CacheAPIs.ts
TablesStructures (Interface)
(no doc)
packages/server/src/utils/db.ts
CoverRowProps (Interface)
(no doc)
packages/web/components/CoverRowVirtual.tsx

Core symbols most depended-on inside this repo

request
called by 58
packages/web/utils/request.ts
get
called by 43
packages/desktop/main/cache.ts
find
called by 39
packages/desktop/main/db.ts
get
called by 34
packages/web/states/scrollPositions.ts
resizeImage
called by 33
packages/web/utils/common.ts
on
called by 23
packages/desktop/main/ipcMain.ts
useUser
called by 20
packages/web/api/hooks/useUser.ts
formatDuration
called by 19
packages/web/utils/common.ts

Shape

Function 531
Interface 146
Method 145
Class 24
Enum 22

Languages

TypeScript100%

Modules by API surface

packages/web/utils/player.ts52 symbols
packages/desktop/main/db.ts23 symbols
packages/server/src/utils/db.ts22 symbols
packages/desktop/main/tray.ts21 symbols
packages/shared/api/User.ts17 symbols
packages/shared/api/Playlists.ts17 symbols
packages/web/api/auth.ts15 symbols
packages/web/api/user.ts14 symbols
packages/desktop/main/youtube.ts14 symbols
packages/desktop/main/index.ts14 symbols
packages/web/utils/common.ts13 symbols
packages/web/pages/Settings/KeyboardShortcuts.tsx13 symbols

For agents

$ claude mcp add music \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact