lywsvip/WindowsMusicPlayer-TheUntamedMusicPlayer
1
0
Fork 0
mirror of https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer.git synced 2026-05-06 19:20:18 +08:00
Code Issues Packages Projects Releases Wiki Activity

更新README

Browse Source
This commit is contained in:
LanZhan
2026-01-22 14:09:05 +08:00
parent 1aebbdfd2d
commit 9538fee094
5 changed files with 406 additions and 204 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
CONTRIBUTING.md
View File

@@ -1,16 +1,42 @@
先决条件：
- 您的计算机必须运行 Windows 10 内部版本 17763 或更高版本。
- 安装最新版本的 Visual Studio（社区版就足够了）。
- 安装“WinUI应用程序开发”工作负载。
<img width="1600" height="900" alt="image" src="https://github.com/user-attachments/assets/d91003b0-cee6-4448-a551-4589c198dd7c" />
<div align="center">
- 获取代码:
```
[English](Docs/CONTRIBUTING-en.md) | [中文](CONTRIBUTING.md)
</div>
# 开发环境配置指南
## 系统要求
- **操作系统**：Windows 10 22H2（内部版本 19041）或更高版本
- **开发工具**：Visual Studio 2026（社区版即可）
## 开发环境设置
### 1. 安装 Visual Studio 组件
安装 Visual Studio 2026 时，请勾选以下工作负载：
- **WinUI 应用程序开发**
![Visual Studio 组件安装图](/Docs/Images/VisualStudioComponent.png)
### 2. 克隆项目源码
使用 Git 克隆本项目到本地：
```bash
git clone https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer.git
```
- 在 Visual Studio 中打开 UntamedMusicPlayer.sln。
- 在 Visual Studio 中点击“工具”→”选项“→”NuGet包管理器“→”程序包源“→右上角+号。新建一个名称为Community Toolkit Labs，源为https://pkgs.dev.azure.com/dotnet/CommunityToolkit/_packaging/CommunityToolkit-Labs/nuget/v3/index.json 的包源。
<img width="1453" height="777" alt="image" src="https://github.com/user-attachments/assets/b2aee828-7ad5-4a59-a60c-bffb50699c80" />
### 3. 在 Visual Studio 中打开项目
- 重启项目并运行代码。
在 Visual Studio 中打开 `UntamedMusicPlayer.slnx` 文件。
### 4. 还原 NuGet 包
等待 Visual Studio 自动还原 NuGet 依赖包。
### 5. 编译并运行
点击工具栏中的"**▶ Untamed Music Player (Package)**"按钮开始调试和运行应用程序。

42
Docs/CONTRIBUTING-en.md Normal file
View File

@@ -0,0 +1,42 @@
<div align="center">
[English](CONTRIBUTING-en.md) | [中文](../CONTRIBUTING.md)
</div>
# Development Environment Setup Guide
## System Requirements
- **Operating System**: Windows 10 22H2 (Build 19041) or later
- **Development Tool**: Visual Studio 2026 (Community Edition is fine)
## Development Environment Setup
### 1. Install Visual Studio Components
When installing Visual Studio 2026, please select the following workload:
- **WinUI Application Development**
![Visual Studio Component Installation](Images/VisualStudioComponent.png)
### 2. Clone the Project Repository
Use Git to clone this project to your local machine:
```bash
git clone https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer.git
```
### 3. Open the Project in Visual Studio
Open the `UntamedMusicPlayer.slnx` file in Visual Studio.
### 4. Restore NuGet Packages
Wait for Visual Studio to automatically restore the NuGet dependencies.
### 5. Build and Run
Click the "**▶ Untamed Music Player (Package)**" button in the toolbar to start debugging and running the application.

98
Docs/README-en.md Normal file
View File

@@ -0,0 +1,98 @@
<div align="center">
[English](README-en.md) | [中文](../README.md)
</div>
<p align="center">
<img alt="Untamed Music Player Icon" width="128" align="center" src="Images/Icon.png">
</p>
<h1 align="center">
Untamed Music Player
</h1>
<p align="center">
A modern music player for online and local music streaming
</p>
<p align="center">
<a href="https://apps.microsoft.com/detail/9ncfn17f3lxj?referrer=appbadge&mode=direct">
<img alt="Microsoft Store Download Button" src="https://get.microsoft.com/images/en-us%20dark.svg" width="200"/>
</a>
</p>
---
## ✨ Key Features
- 🎵 **Universal Audio Format Support** - Supports 20+ audio formats including MP3, FLAC, OPUS, OGG, and more with
seamless switching between local and online music
- 🌐 **Online Music Search (Only supported in Chinese mainland)** - Integrated online music API supporting search,
playback of songs, albums, playlists, and artists
- 🗂️ **Intelligent Music Management** - Multi-dimensional classification by artist, album, and playlist with M3U8
playlist import/export support
- 📝 **Immersive Lyrics Experience** - Dual-mode lyrics display with embedded and floating options, supporting custom
fonts
- 🎛️ **Professional Audio Control** - Built-in variable speed playback with WASAPI exclusive mode output support
- 🎨 **Exquisite Visual Design** - Multiple Mica/Acrylic material themes, cover-based dynamic backgrounds, elegant and
modern interface
- 🔄 **Deep System Integration** - System Media Transport Control (SMTC) support, file association launch, and
notification push
- 📋 **Flexible Queue Management** - Shuffle, single song repeat, playlist loop, and free queue editing
## 📥 Download & Installation
| Method | Link | Notes |
|---------------------|--------------------------------------------------------------------------------------------------|-------------------------------|
| **Microsoft Store** | [Download](https://apps.microsoft.com/detail/9ncfn17f3lxj) | **Recommended**, auto updates |
| **GitHub Release** | [Download](https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer/releases) | Manual installation |
| **123 Cloud Drive** | [Download](https://www.123865.com/s/yvXSVv-j2mFd) | Mirror source for China users |
### Choose the Right Version
- **x64** - For 64-bit systems (Recommended for most users)
- **ARM64** - For ARM 64-bit systems (e.g., Surface Pro X)
- **x86** - For 32-bit systems (Less common)
## 📱 Application Interface
<div align="center">
| Preview Screenshots |
|-----------------------------------|
| ![Preview 1](Images/Preview1.png) |
| ![Preview 2](Images/Preview2.png) |
| ![Preview 3](Images/Preview3.png) |
| ![Preview 4](Images/Preview4.png) |
| ![Preview 5](Images/Preview5.png) |
| ![Preview 6](Images/Preview6.png) |
| ![Preview 7](Images/Preview7.png) |
| ![Preview 8](Images/Preview8.png) |
</div>
## 🤝 Contributing
We welcome any form of contribution! If you have the following needs, feel free to submit:
- 🐛 **Report Bugs** - Found an issue? Please submit an Issue
- 💡 **Feature Suggestions** - Have a great idea? Open a Discussion
- 🔧 **Code Contributions** - Improve the code? Submit a Pull Request
For
detailed [contribution guidelines](https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer?tab=contributing-ov-file),
please refer to our project page.
## 🙏 Acknowledgments
Special thanks to the following open-source projects and developers for their support and inspiration:
- [Disenchant UWP Music Player](https://github.com/DenryDu/Disenchant-Music-Player)
- [C# Netease Cloud Music API](https://github.com/wwh1004/NeteaseCloudMusicApi)
- [ScreenBox](https://github.com/huynhsontung/Screenbox)
## 📚 Project Dependencies
For detailed information about all dependencies and libraries used in this project, please
visit [project dependencies page](https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer/network/dependencies).

102
README.md
View File

@@ -1,54 +1,90 @@
<div align="center">
[English](Docs/README-en.md) | [中文](README.md)
</div>
<p align="center">
<img width="128" align="center" src="https://github.com/user-attachments/assets/18dcd16f-f253-408f-a876-b7ecbc6c2e17">
<img alt="无羁 音乐播放器图标" width="128" align="center" src="/Docs/Images/Icon.png">
</p>
<h1 align="center">
无羁 音乐播放器
</h1>
<p align="center">
一款现代化的在线和本地音乐播放器
</p>
<p align="center">
<a href="https://apps.microsoft.com/detail/9ncfn17f3lxj?referrer=appbadge&mode=direct">
<img src="https://get.microsoft.com/images/en-us%20dark.svg" width="200"/>
<img alt="Microsoft Store 下载按钮" src="https://get.microsoft.com/images/zh-cn%20dark.svg" width="200"/>
</a>
</p>
## 功能
- 播放在线音乐和本地音乐，支持多种音频格式。
- 对本地音乐音乐进行各种排序显示。
- 歌曲、专辑、艺术家、歌单等信息一目了然。
- 更改应用主题、背景和材质。
- 显示歌曲内嵌歌词，并含有更改字体、灵动词岛功能。
- 将歌曲添加到播放队列和播放列表中。
---
## 下载
|分发方式|分发链接|
|-------|-------|
| Microsoft Store（**推荐**） | [商店链接](https://apps.microsoft.com/detail/9ncfn17f3lxj)
| Github Release | [分发链接](https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer/releases)
| 123云盘 | [分发链接](https://www.123865.com/s/yvXSVv-j2mFd)
## ✨ 主要功能
从 [Github Release](https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer/releases) 或 [123云盘](https://www.123865.com/s/yvXSVv-j2mFd) 下载时请注意：
- 如果您的电脑是64位系统（绝大多数人都是），请下载带有x64字样的安装包。
- 如果您的电脑是arm64处理器，请下载带有arm64字样的安装包。
- 如果您的电脑是32位系统，请下载带有x86字样的安装包。
- 🎵 **全格式音频播放** - 支持 MP3、FLAC、OPUS、OGG 等 20+ 种音频格式，本地与在线音乐无缝切换
- 🌐 **在线音乐搜索** - 集成在线音乐 API，支持在线搜索、播放歌曲、专辑、歌单及艺术家
- 🗂️ **智能音乐管理** - 按艺术家、专辑、歌单多维度分类，支持 M3U8 播放列表导入导出
- 📝 **沉浸歌词体验** - 内嵌与灵动词岛双模式歌词显示，支持字体自定义
- 🎛️ **专业音效控制** - 内置变速播放，支持 WASAPI 独占模式输出
- 🎨 **精致视觉设计** - 多种 云母/亚克力 材质主题，封面取色动态背景，优雅现代的界面
- 🔄 **系统深度整合** - 系统媒体传输控制（SMTC）支持，文件关联启动，通知推送
- 📋 **灵活队列管理** - 随机播放、单曲循环、列表循环，支持播放队列自由编辑
## 界面
![屏幕截图 2025-02-25 105404](https://github.com/user-attachments/assets/03e0d718-0605-4e3e-8fc7-7596224f38cb)
![屏幕截图 2025-02-25 105610](https://github.com/user-attachments/assets/7d571d7b-8cec-43ac-bdfe-31b47d8baaee)
![屏幕截图 2025-02-25 105633](https://github.com/user-attachments/assets/e4e5274e-c42c-4c13-ab94-0825fff32425)
![屏幕截图 2025-02-25 105725](https://github.com/user-attachments/assets/6a5344c2-eea6-4b80-834b-d69c36016a4a)
![屏幕截图 2025-02-25 105711](https://github.com/user-attachments/assets/a069996a-a905-44b4-ad23-f372f4f58f5c)
![屏幕截图 2025-02-25 105740](https://github.com/user-attachments/assets/a9c4deff-fe93-4bc4-9fc5-8d1506e4435a)
![屏幕截图 2025-02-25 105752](https://github.com/user-attachments/assets/3c782da7-5216-4cb8-b7e9-c674d3310484)
## 📥 下载安装
## 贡献
[请点击此链接查看教程](https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer?tab=contributing-ov-file)<br>
如果您想报告错误、提供反馈或提出问题，欢迎随时提交议题（Issue）！也非常欢迎您提交拉取请求（Pull Request）！
| 方式 | 链接 | 说明 |
|--------------------|--------------------------------------------------------------------------------------------|-------------|
| **微软应用商店** | [下载](https://apps.microsoft.com/detail/9ncfn17f3lxj) | **推荐**，自动更新 |
| **Github Release** | [下载](https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer/releases) | 手动下载安装包 |
| **123 云盘** | [下载](https://www.123865.com/s/yvXSVv-j2mFd) | 国内镜像源 |
### 选择合适的版本
- **x64** - 适用于 64 位系统（推荐，大多数用户）
- **ARM64** - 适用于 ARM 64 位系统（如 Surface Pro X）
- **x86** - 适用于 32 位系统（较少使用）
## 📱 应用界面
<div align="center">
| 预览截图 |
|------------------------------------|
| ![预览图1](/Docs/Images/Preview1.png) |
| ![预览图2](/Docs/Images/Preview2.png) |
| ![预览图3](/Docs/Images/Preview3.png) |
| ![预览图4](/Docs/Images/Preview4.png) |
| ![预览图5](/Docs/Images/Preview5.png) |
| ![预览图6](/Docs/Images/Preview6.png) |
| ![预览图7](/Docs/Images/Preview7.png) |
| ![预览图8](/Docs/Images/Preview8.png) |
</div>
## 🤝 参与贡献
我们欢迎任何形式的贡献！如果您有以下需求，欢迎提交：
- 🐛 **报告 Bug** - 发现问题？请提交 Issue
- 💡 **功能建议** - 有好的想法？请打开 Discussion
- 🔧 **代码贡献** - 改进代码？提交 Pull Request
详细的[贡献指南](https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer?tab=contributing-ov-file)
请参考我们的项目页面。
## 🙏 致谢
特别感谢以下开源项目和开发者的支持和灵感：
## 代码参考及致谢
- [离幻 UWP 音乐播放器](https://github.com/DenryDu/Disenchant-Music-Player)
- [C# 版网易云音乐 API](https://github.com/wwh1004/NeteaseCloudMusicApi)
- [ScreenBox](https://github.com/huynhsontung/Screenbox)
## 依赖及引用
[请点击此链接查看](https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer/network/dependencies)
## 📚 项目依赖
本项目使用的所有依赖库和引用详情，请访问[项目依赖页面](https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer/network/dependencies)。