# DesktopPlayer

**Repository Path**: htswei/desktop-player

## Basic Information

- **Project Name**: DesktopPlayer
- **Description**: 一款轻量级桌面音视频播放器，支持主流格式与本地文件播放，开源免费，专注简洁高效体验。
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-12
- **Last Updated**: 2026-07-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DesktopPlayer

一款轻量级桌面动态壁纸播放器，支持将视频设置为桌面壁纸，开源免费，专注简洁高效体验。

## 功能特性

- ✅ 将视频设置为桌面动态壁纸
- ✅ 支持主流视频格式：MP4、AVI、MKV、MOV、WMV、FLV、M4V、RMVB
- ✅ 静态壁纸切换（播放停止后恢复）
- ✅ 系统托盘最小化支持
- ✅ 自定义圆角按钮界面
- ✅ 播放列表管理（添加、移除、清空）
- ✅ 快捷键支持（ESC 停止播放）
- ✅ 智能全屏/最大化检测（自动暂停/恢复播放）

## 编译环境

- Windows 操作系统
- .NET Framework 4.0 或更高版本（已预装在 Windows 7+）

## 编译方法

### 方法一：使用构建脚本（推荐）

双击运行 `build.bat` 文件，脚本会自动：

1. 查找系统中的 csc.exe 编译器
2. 编译生成 DesktopPlayer.exe
3. 可选运行程序

```batch
build.bat
```

### 方法二：手动编译

打开命令提示符（CMD），进入项目目录，执行以下命令：

```batch
"C:\Windows\Microsoft.NET\Framework\v4.0.30319\csc.exe" /target:winexe /out:DesktopPlayer.exe /reference:System.dll /reference:System.Drawing.dll /reference:System.Windows.Forms.dll Program.cs
```

## 使用说明

1. **添加视频**：点击「添加视频」按钮，选择一个或多个视频文件
2. **选择静态壁纸（可选）**：点击「选择壁纸」按钮，设置播放停止后恢复的静态壁纸
3. **开始播放**：点击「开始播放」按钮，视频将作为桌面壁纸全屏播放
4. **停止播放**：点击「停止播放」按钮或按 ESC 键停止播放，恢复静态壁纸
5. **最小化**：点击窗口右上角最小化按钮，程序将最小化到系统托盘
6. **全屏检测**：当检测到其他程序进入全屏模式时，视频播放会自动暂停；退出全屏后自动恢复播放

## 技术实现

- **开发语言**：C#
- **UI 框架**：Windows Forms
- **视频播放**：Windows Media Player ActiveX 控件
- **壁纸设置**：通过 Windows API 设置桌面壁纸
- **窗口层级**：通过 Progman/WorkerW 窗口嵌入实现壁纸效果

## 项目结构

```
uploadDP/
├── Program.cs       # 主程序源代码
├── build.bat        # 编译脚本
├── DesktopPlayer.exe # 编译输出（已包含）
├── README.md        # 中文说明文档
└── README.en.md     # 英文说明文档
```

## 注意事项

- 需要 Windows Media Player 支持（Windows 系统默认已安装）
- 视频文件路径不能包含特殊字符或过长路径
- 建议使用分辨率与屏幕分辨率匹配的视频以获得最佳效果
- 播放过程中按 ESC 键可直接停止并恢复原壁纸

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request