Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
K

KMusic

> 编程语言
Open source

一款基于 SwiftUI 开发的多源音乐聚合播放器,支持 iOS/macOS 平台。

377 stars0 likes0 views
WebsiteGitHub

About

一款基于 SwiftUI 开发的多源音乐聚合播放器,支持 iOS/macOS 平台。

KMusic

一款基于 SwiftUI 开发的多源音乐聚合播放器,支持 iOS/macOS 平台。

✨ 功能特性

  • 多音源支持 - 内置酷我、酷狗、QQ音乐、网易云、咪咕等主流音乐平台
  • 歌词同步 - 支持 LRC 歌词解析与实时滚动显示
  • 自定义源 - 支持通过 URL/本地文件导入第三方 JS 脚本扩展音源
  • 全局搜索 - 跨平台搜索歌曲
  • 后台播放 - 支持后台持续播放音乐
  • 深色主题 - 精心设计的深色 UI,支持毛玻璃效果

截图

发现页 播放器 搜索
歌单广场 歌词同步 多源搜索

项目结构

KMusic/
├── Core/
│   ├── API/              # 各平台 API 服务
│   ├── Engine/           # JS 引擎 & 音源管理
│   ├── Models/           # 数据模型
│   └── Player/           # 音频播放器
└── UI/
    ├── Home/             # 首页歌单
    ├── Search/           # 搜索页
    ├── Player/           # 播放器界面
    └── Settings/         # 设置页

快速开始

环境要求

  • Xcode 15.0+
  • iOS 15.0+ / macOS 12.0+
  • Swift 5.9+

安装运行

  1. 克隆项目
bash
git clone https://github.com/Mac-XK/KMusic.git
cd KMusic
  1. 打开 Xcode 项目
bash
open KMusic.xcodeproj
  1. 选择目标设备,点击运行

自定义音源

KMusic 支持导入兼容 lx-music 格式的自定义音源脚本。

导入方式

  1. URL 导入 - 在设置 → 自定义源管理中输入脚本 URL(支持 GitHub/Gitee/GitLab 链接自动转换)
  2. 本地导入 - 选择本地 .js 脚本文件导入

脚本格式

脚本需包含以下元信息:

javascript
// @name        音源名称
// @version     1.0.0

技术实现

  • SwiftUI - 声明式 UI 框架
  • AVFoundation - 音频播放
  • JavaScriptCore - JS 脚本引擎
  • Combine - 响应式编程
  • URLSession - 网络请求

开源协议

本项目基于 MIT License 开源。

⚠️ 免责声明

本项目仅供学习交流使用,请勿用于商业用途。音乐版权归原作者所有。


如果觉得这个项目对你有帮助,欢迎 ⭐️ Star 支持!

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

JavaScript

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言