Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/playboy-player/playboy

A Material You style cross-platform media player, developed with Flutter.
https://github.com/playboy-player/playboy

android dart desktop linux macos material-design material-you mobile mpv music-player video-player windows

Last synced: 1 day ago
JSON representation

A Material You style cross-platform media player, developed with Flutter.

Awesome Lists containing this project

README

        

# $Playboy$ $Media$ $Player$

[English version](./README_en.md)

> 本项目目前通过 Github Actions 自动编译 Windows 和 Android 测试版本, 可[在此](https://github.com/Playboy-Player/Playboy/actions)下载体验.

使用 [Flutter](https://flutter.dev/) 开发的媒体播放器, 界面使用 [Material You](https://m3.material.io/) 设计风格.

![](https://m3-markdown-badges.vercel.app/stars/7/2/Playboy-Player/Playboy)
![](https://m3-markdown-badges.vercel.app/issues/1/2/Playboy-Player/Playboy)

![](https://ziadoua.github.io/m3-Markdown-Badges/badges/Windows/windows3.svg)
![](https://ziadoua.github.io/m3-Markdown-Badges/badges/Linux/linux3.svg)
![](https://ziadoua.github.io/m3-Markdown-Badges/badges/macOS/macos3.svg)
![](https://ziadoua.github.io/m3-Markdown-Badges/badges/Android/android3.svg)

## 界面截图



playing


playing dark




video page


video page dark




music page


music page dark

## 功能

[查看开发计划 & 进度](https://github.com/orgs/Playboy-Player/projects/3)

- [x] 主题颜色设置 & 深色模式支持
- [x] 多语言支持
- [x] 播放本地和网络媒体
- [x] 迷你播放器模式
- [x] 设置为系统打开方式
- [x] 播放列表功能 (随机播放, 单曲循环)
- [x] 倍速调节 (0-4倍速)
- [ ] 歌词和字幕
- [ ] 解析BV链接
- [ ] 文件下载功能
- [ ] 媒体文件搜索

## 使用说明

音乐库与视频库会扫描库目录下的所有媒体文件 (包括子目录).

对于音乐, 会将同级目录下的 `cover.jpg` 设为封面.
视频则使用 `ffmpeg` 自动生成缩略图 (需要系统环境变量, android 端支持情况未知).

支持格式: `avi`, `flv`, `mkv`, `mov`, `mp4`, `mpeg`, `webm`, `wmv`, `aac`, `midi`, `mp3`, `ogg`, `wav`

## 跨平台支持情况

### Windows

需要安装 [Flutter](https://docs.flutter.dev/get-started/install/windows/desktop?tab=vscode), [Visual Studio 2022](https://visualstudio.microsoft.com/zh-hans/downloads/) C++ 工作负载 (或安装 [VS 2022 生成工具](https://aka.ms/vs/17/release/vs_BuildTools.exe))

flutter doctor 输出内容示例:

```
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.1, on Microsoft Windows [版本 10.0.22631.4037], locale zh-CN)
[✓] Windows Version (Installed version of Windows is version 10 or higher)
[✓] Visual Studio - develop Windows apps (Visual Studio 生成工具 2022 17.11.1)
[✓] Connected device (3 available)
[✓] Network resources
```

在项目文件夹下运行 `flutter build windows` 以生成 Windows 可执行程序

### Linux

> 目前 Linux 版本存在较多 Bug, 如播放时切换页面可能导致应用崩溃, 迷你播放器显示尺寸错误等

需要安装 [Flutter](https://docs.flutter.dev/get-started/install/linux), libmpv-dev.

flutter doctor 输出内容示例:

```
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.22.2, on Debian GNU/Linux 12 (bookworm) 5.15.153.1-microsoft-standard-WSL2, locale
en_US.UTF-8)
[✓] Linux toolchain - develop for Linux desktop
[✓] Connected device (1 available)
[✓] Network resources
```

在项目文件夹下运行 `flutter build linux` 以生成 Linux 可执行程序

### macOS

> [可以运行](https://github.com/Playboy-Player/Playboy/issues/3), 但需要更多适配工作, 由于无编译环境, 开发进度暂时停滞.

### android

> 针对手机的布局优化尚未完成, 建议在平板设备上体验.

flutter doctor 输出内容示例:

```
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.1, on Microsoft Windows [版本 10.0.22631.4169], locale zh-CN)
[✓] Windows Version (Installed version of Windows is version 10 or higher)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Android Studio (version 2024.2)
[✓] Connected device (3 available)
[✓] Network resources
```

建议在 [Android Studio](https://developer.android.com/studio?hl=zh-cn#get-android-studio) 中运行项目.

## 为本项目做出贡献

如果您在使用中发现 bug 或者希望添加某些功能, 请 [新建一个 issue](https://github.com/Playboy-Player/Playboy/issues/new).
也欢迎直接 Pull Request 提交代码贡献.