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

cross-platform desktop media player based on libmpv
https://github.com/playboy-player/playboy

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

Last synced: 3 months ago
JSON representation

cross-platform desktop media player based on libmpv

• Host: GitHub
• URL: https://github.com/playboy-player/playboy
• Owner: Playboy-Player
• License: apache-2.0
• Created: 2024-03-05T16:52:13.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-04-04T11:48:18.000Z (3 months ago)
• Last Synced: 2025-04-04T12:31:19.289Z (3 months ago)
• Topics: android, dart, desktop, flutter, linux, macos, material-design, material-you, mpv, music-player, video-player, windows
• Language: Dart
• Homepage:
• Size: 34.1 MB
• Stars: 177
• Watchers: 4
• Forks: 9
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Playboy

中文 | [English](./README_en.md)  

基于 `libmpv` 的 Material 3 风格跨平台媒体播放器.

[![build](https://img.shields.io/github/actions/workflow/status/Playboy-Player/Playboy/build.yml?style=for-the-badge)](https://github.com/Playboy-Player/Playboy/actions) 

[![release](https://img.shields.io/badge/beta-2025.3-gold?style=for-the-badge)](https://github.com/Playboy-Player/Playboy/releases) ![downloads](https://img.shields.io/github/downloads/Playboy-Player/Playboy/total?style=for-the-badge&color=blue) [![project](https://img.shields.io/badge/project-grey?style=for-the-badge)](https://github.com/orgs/Playboy-Player/projects/3)

![](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)

## 界面截图

  

    

      

    

    

      

    

  

  

    

      

    

    

      

    

  

  

    

      

    

    

      

    

  

## 功能

> 可以通过[键盘快捷键](https://github.com/mpv-player/random-stuff/blob/master/key_bindings_chart/mpbindings.png)访问所有 mpv 功能, 在播放界面按 `SHIFT+O` 可显示 mpv OSD

- [x] 自定义主题 & 深色模式

- [x] 播放本地和网络媒体

- [x] 迷你播放器模式 (Windows & macOS)

- [x] 设置为系统打开方式 (Windows)

- [x] 播放列表功能 (随机播放, 单曲循环)

- [x] 章节和 AB 循环 (命令行)

- [x] 任意倍速调节

- [x] 搜索媒体文件和播放列表

- [x] 多语言支持

- [x] 字幕 (libass)

- [x] 着色器支持

- [x] 自定义快捷键映射 (input.conf 支持)

- [x] 兼容 mpv.conf 配置文件

- [ ] 自定义 mpv 初始化参数

- [ ] 自动生成字幕 (Whisper)

### 使用 Anime4K 着色器

参考 [Anime4K](https://github.com/bloc97/Anime4K) 官方的 GLSL/MPV 安装教程, 下载 template files.

**顶部菜单 -> 应用偏好设置 -> 存储 -> 打开应用数据文件夹**, 把 `mpv.conf`, `input.conf`, `shaders 文件夹` 复制到数据文件夹下.

启用 **应用偏好设置 -> 播放器 -> 允许 libmpv 使用配置文件** 选项, 重启应用.

## For Developers

首先, 根据 [官方教程](https://docs.flutter.dev/get-started/install/) 配置 flutter 环境. 请使用不低于 **3.29.0** 的 flutter 版本.

终端进入项目根目录, 运行 `flutter pub get` 以获取依赖项.  

运行 `dart run whisper4dart:setup --prebuilt`

### Windows

运行 `dart run libmpv_dart:setup --platform windows` 获取 mpv 库依赖  

运行 `flutter build windows` 以生成 Windows 可执行程序

### Linux

配置完 flutter 后, 请通过系统包管理器或其他途径安装 `libmpv-dev`.

运行 `flutter build linux` 以生成 Linux 可执行程序

### macOS

运行 `flutter build macos` 以生成 macOS 可执行程序  

### android

> 请在平板设备上运行.

运行 `flutter build apk` 以生成 apk 安装包文件

## 为本项目做出贡献

如果您在使用中发现 bug 或者希望添加某些功能, 请 [新建一个 issue](https://github.com/Playboy-Player/Playboy/issues/new).  

也欢迎直接 Pull Request 提交代码贡献.

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=Playboy-Player/Playboy&type=Date)](https://star-history.com/#Playboy-Player/Playboy&Date)