Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xfangfang/wiliwili
第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上
https://github.com/xfangfang/wiliwili
bilibili mpv nanovg nintendo-switch nintendo-switch-homebrew opencc opengl ps4 psv xbox
Last synced: about 1 month ago
JSON representation
第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上
- Host: GitHub
- URL: https://github.com/xfangfang/wiliwili
- Owner: xfangfang
- License: gpl-3.0
- Created: 2021-01-17T09:27:58.000Z (almost 4 years ago)
- Default Branch: yoga
- Last Pushed: 2024-09-12T15:01:30.000Z (about 2 months ago)
- Last Synced: 2024-09-26T23:41:41.233Z (about 1 month ago)
- Topics: bilibili, mpv, nanovg, nintendo-switch, nintendo-switch-homebrew, opencc, opengl, ps4, psv, xbox
- Language: C++
- Homepage: https://xfangfang.github.io/wiliwili
- Size: 25.8 MB
- Stars: 3,207
- Watchers: 20
- Forks: 147
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-bilibili-extra - Wiliwili - 专为手柄控制设计的第三方跨平台 B 站客户端，目前可以运行在 PC 全平台和 Nintendo Switch 上.    (第三方客户端 / 直播脚本)
README
一个专为手柄用户设计的第三方 B站 客户端
- - -
[](https://github.com/xfangfang/wiliwili/releases)
[](https://crowdin.com/project/wiliwili)
[](https://copr.fedorainfracloud.org/coprs/mochaa/wiliwili/)
[](https://scoop.sh/#/apps?q=wiliwili)
[](https://aur.archlinux.org/packages/wiliwili-git/)
[](https://flathub.org/apps/cn.xfangfang.wiliwili)
[](https://nightly.link/xfangfang/wiliwili/workflows/build.yaml/dev)
[](https://github.com/xfangfang/wiliwili_theme)
# 特点
wiliwili 拥有非常接近官方PC客户端的B站浏览体验
同时支持**触屏**、**鼠标**、**键盘** 与 **手柄**操控
无论是电脑还是游戏掌机都能获得全新的使用体验
多语言：简、繁、日、韩、英 ...
搜索页：热搜 视频 番剧 影视
筛选页：快速找到想看的影视内容
动态页：关注的UP主最近视频动态
直播页：关注的主播与其他系统推荐
播放页：视频 番剧 电影 纪录片 综艺，支持弹幕与评论
个人页：扫码登录 历史记录 个人收藏 我的追番 我的追剧
主题色：拥有深浅两色主题，跟随系统自动切换
# 安装
### Nintendo Switch
1. 下载 `wiliwili-NintendoSwitch.zip`：[wiliwili releases](https://github.com/xfangfang/wiliwili/releases)
2. 将 wiliwili.nro 放置在**内存卡** `switch` 目录下。
3. 在主页 `按住` R键打开任意游戏进入 hbmenu，在列表中选择 wiliwili 点击打开即可。
4. [可选] 在应用内安装桌面图标，入口：设置/实用工具/使用教程
桌面图标会优先尝试打开 `switch/wiliwili.nro`，如果其不存在，则尝试打开 `switch/wiliwili/wiliwili.nro`，如果这两个路径都不存在，则打开
hbmenu 自行选择路径。
默认提供的为 OpenGL 版本，最高只能播放 4k@30，你也可以下载到支持原生图形 api
的 [deko3d 版本](https://nightly.link/xfangfang/wiliwili/workflows/build.yaml/dev)，可以流畅播放 4k@60，不过可能会偶尔崩溃。
### PSVita
下载 `wiliwili-PSVita.vpk` 安装即可：[wiliwili releases](https://github.com/xfangfang/wiliwili/releases)
目前只推荐观看 360P 分辨率使用，不过仍有相当大的提升空间，如果你愿意为此贡献欢迎开一个 PR 讨论了解更多。
### PS4
下载 `wiliwili-PS4.pkg` 安装即可：[wiliwili releases](https://github.com/xfangfang/wiliwili/releases)
只支持软解，对于 ps4 推荐关闭设置中的低画质解码；ps4 pro 如果想勉强播放 4k@60 需要开启低画质解码。
### PC
PC客户端支持切换硬件解码、秒开流畅适合老电脑、支持鼠标操控（左键点击 右键返回 中键刷新）
下载对应系统的安装包运行即可：[wiliwili releases](https://github.com/xfangfang/wiliwili/releases)
> [!TIP]
> 现在 Linux & Steam Deck 用户可以通过系统自带的软件商店（如Discover、GNOME Software）搜索 `wiliwili` 进行下载。
注意：
1. 显卡驱动需要支持 `OpenGL 3.2` 以运行此程序，OpenGL 2.0+, OpenGL ES 2.0+
设备需要自行编译，请参考 [项目 WIKI](https://github.com/xfangfang/wiliwili/wiki)
2. Linux: 如有其他打包需求欢迎提交完善的打包脚本
3. macOS: 欢迎 macOS 用户提交 Homebrew 安装方式到官方仓库
4. 支持诸多包管理器，请参考 [项目 WIKI](https://github.com/xfangfang/wiliwili/wiki)
# 文档
在各位开发者的帮助下，wiliwili 支持了一系列包管理器，同时 wiliwili 还拥有丰富的自定义选项，包括：使用 Anime4K
提升观感，自定义字体及图标等等
前往 [项目 WIKI](https://github.com/xfangfang/wiliwili/wiki) 查看更多使用技巧
# TODO list
如果你有其他改进的想法或创意，欢迎在讨论区交流：[Discussions](https://github.com/xfangfang/wiliwili/discussions/categories/ideas)
- [x] 初步完成底层基础组件、首页各类推荐视频、用户视频播放页
- [x] 微调页面、解决播放器启动速度慢、解决播放页面退出卡顿
- [x] 临时解决异步加载导致的空指针问题（图片异步加载某些情况还会出现问题，待修复）
- [x] 添加番剧/影视播放、添加扫码登录、播放历史、用户收藏夹（收藏夹相关部分工作不稳定）
- [x] 初步添加搜索
- [x] 播放页新增分集与UP主最新投稿
- [x] 完善视频播放页用户评论内容
- [x] 重构图片异步加载逻辑
- [x] 解决收藏夹、搜索页某些情况导致闪退的问题
- [x] 完善搜索页：番剧、影视 转为竖图
- [x] 完善播放页投稿列表：调整结构、自动加载下一页
- [x] 播放页展示合集与推荐
- [x] 添加动态页
- [x] 添加视频检索页
- [x] 完善设置页
- [x] 弹幕相关设置
- [x] 点赞、投币、收藏
- [x] 拖拽调节进度
- [x] 增加单手模式使用一个手柄来控制播放器
- [x] NSP forwarder自动检查多个位置的nro文件，避免无法打开
- [x] 增加设置使首页无法通过返回退出，避免误触
- [x] 使用教程添加未指明的快捷键说明
- [x] 重压摇杆临时快进
- [x] 支持切换按键图标
- [x] 应用内多语言切换
- [x] 重构搜索页面
- [x] 评论@显示不同颜色
- [x] 完善评论图片
- [x] 评论大表情包所在行增加行高
- [x] 支持webp图片
- [ ] 搜索支持搜索用户
- [ ] 长按一键三连
- [ ] 支持个人主页
- [ ] 评论跳转进度
- [ ] 评论跳转搜索
- [ ] 评论下方的更多信息 (up主点赞等内容)
- [ ] 投票评论
- [ ] 互动视频
# 反馈问题前要做的事
1. 网络相关的问题附加 `网络诊断截图`，入口：应用内设置/实用工具/网络诊断
2. [Switch用户] 要确保 `大气层`和`系统固件` 更新到 **最新** ，`内存卡`为 **FAT32**
3. [Switch用户] 如果打开应用黑屏时间过长，可以尝试删除内存卡目录 `config/wiliwili` 重新进入
4. 确保 `系统时间`正确、系统`网络设置`正确（主要是DNS）、如果使用了`网络代理`请在反馈前关闭并重新测试
5. 查找有没有其他人出现过类似的问题：[Issues](https://github.com/xfangfang/wiliwili/issues?q=is%3Aissue)
6. **完整且详细地** 描述你的问题，最好附加演示视频、截图。
7. 尝试复现问题，尽力找到BUG出现的规律
# 贡献
### 软件移植
本应用基于 nanovg 绘制界面，nanovg 底层可移植切换到任意图形库，视频播放部分则使用 MPV + FFMPEG 通过 OpenGL 绘制。
所以按照我的理解 wiliwili 应该可以移植到任何一个内存大于500MB，支持OpenGL（ES）的设备。如果你有想要移植的设备欢迎发一条
issue 讨论。
### 新功能
如果你有想完成的创意，请在开发前发布一个 issue 讨论，避免和别人的创意撞车浪费了时间
### 多语言支持
如果你想为软件添加多语言的翻译支持，或者发现了某些翻译存在问题需要订正，请查看 [#52](https://github.com/xfangfang/wiliwili/issues/52)
了解如何贡献翻译
### 代码分支
主分支 yoga 为保证编译无误的最新代码
开发分支 dev 为正在开发中的代码，任何新的 PR 都需要向 dev 分支提交
# 开发
```shell
# 拉取代码
git clone --recursive https://github.com/xfangfang/wiliwili.git
cd wiliwili
```
### PC本地运行
目前 wiliwili 支持运行在 Linux macOS 和 Windows上
#### macOS
```shell
# macOS: install dependencies
brew install mpv webp
cmake -B build -DPLATFORM_DESKTOP=ON
make -C build wiliwili -j$(sysctl -n hw.ncpu)
```
#### Linux
不同 Linux 的编译过程或依赖可能不同，这里是一份总结：[#89](https://github.com/xfangfang/wiliwili/discussions/89)
欢迎在上面的链接中写出你所使用系统的编译过程供大家参考。
```shell
# Ubuntu: install dependencies
sudo apt install libcurl4-openssl-dev libmpv-dev libwebp-dev
cmake -B build -DPLATFORM_DESKTOP=ON
make -C build wiliwili -j$(nproc)
```
```shell
# 如果你想安装在系统路径，并生成一个桌面图标，请使用如下内容编译
cmake -B build -DPLATFORM_DESKTOP=ON -DINSTALL=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr
make -C build wiliwili -j$(nproc)
sudo make -C build install
# uninstall (run after install)
sudo xargs -a build/install_manifest.txt rm
```
#### Windows
```shell
# Windows: install dependencies (MSYS2 MinGW64)
pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake mingw-w64-x86_64-make \
git mingw-w64-x86_64-mpv mingw-w64-x86_64-libwebp
cmake -B build -G "MinGW Makefiles" -DPLATFORM_DESKTOP=ON
mingw32-make -C build wiliwili -j$(nproc)
```
#### SDL2
wiliwili 在 switch 和 PC 平台默认使用 GLFW, 由于 SDL2 支持的平台更多，考虑到向更多平台移植 (比如 PSV PS4 等)，所以
wiliwili 也支持切换到 SDL2 环境构建。
```shell
cmake -B build -DPLATFORM_DESKTOP=ON -DUSE_SDL2=ON
cmake --build build
```
### 交叉编译 Switch 可执行文件 (wiliwili.nro)
推荐使用docker构建，本地构建配置环境略微繁琐不过可用来切换底层的ffmpeg或mpv等其他依赖库更灵活地进行调试。
以下介绍 OpenGL 下的构建方法，deko3d (更好的硬解支持)请参考：`scripts/build_switch_deko3d.sh`
#### Docker
```shell
docker run --rm -v $(pwd):/data devkitpro/devkita64:20240202 \
bash -c "/data/scripts/build_switch.sh"
```
#### 本地编译
```shell
# 1. 安装devkitpro环境: https://github.com/devkitPro/pacman/releases
# 2. 安装依赖
sudo dkp-pacman -S switch-glfw switch-libwebp switch-cmake switch-curl devkitA64
# 3. 安装自定义依赖
# devkitpro提供的部分依赖版本过低, 提供的 ffmpeg 无法播放网络视频
# 手动编译方法请参考：scripts/README.md
base_url="https://github.com/xfangfang/wiliwili/releases/download/v0.1.0"
sudo dkp-pacman -U \
$base_url/switch-libass-0.17.1-1-any.pkg.tar.zst \
$base_url/switch-ffmpeg-6.1-5-any.pkg.tar.zst \
$base_url/switch-libmpv-0.36.0-2-any.pkg.tar.zst
# 4. build
cmake -B cmake-build-switch -DPLATFORM_SWITCH=ON
make -C cmake-build-switch wiliwili.nro -j$(nproc)
```
### 交叉编译 PSV 可执行文件
使用本地环境来编译请参考 `.github/workflows/build.yaml` 。
额外参考：[borealis 示例](https://github.com/xfangfang/borealis#building-the-demo-for-psv)
和 [wiliwili_vita 编译指南](https://gist.github.com/xfangfang/305da139721ad4e96d7a9d9a1a550a9d)
同样可以更方便地使用 docker 进行编译, 在 Apple Silicon 上编译，推荐使用 [OrbStack](https://orbstack.dev) 代替 Docker Desktop，因为前者支持 Rosetta 运行 x86_64 的
Docker 镜像。
```shell
docker run --rm -v $(pwd):/src/ xfangfang/wiliwili_psv_builder:latest \
"cmake -B cmake-build-psv -G Ninja -DPLATFORM_PSV=ON \
-DMPV_NO_FB=ON -DUSE_SYSTEM_CURL=ON -DUSE_SYSTEM_SDL2=ON \
-DCMAKE_BUILD_TYPE=Release && \
cmake --build cmake-build-psv"
```
### 交叉编译 PS4 可执行文件
参考 `.github/workflows/build.yaml` 使用 docker 来编译。
或本地安装 [PacBrew](https://github.com/PacBrew/pacbrew-packages) 环境（只支持 x86_64
Linux），并手动添加依赖库，请参考：[scripts/ps4/Dockerfile](https://github.com/xfangfang/wiliwili/blob/dev/scripts/ps4/Dockerfile)
在 Apple Silicon 上编译，推荐使用 [OrbStack](https://orbstack.dev) 代替 Docker Desktop，因为前者支持 Rosetta 运行 x86_64 的
Docker 镜像。
```shell
docker run --rm -v $(pwd):/src/ xfangfang/wiliwili_ps4_builder:latest \
"cmake -B cmake-build-ps4 -DPLATFORM_PS4=ON \
-DMPV_NO_FB=ON \
-DUSE_SYSTEM_CPR=ON && \
make -C cmake-build-ps4 -j$(nproc)"
```
# 应用截图
# Acknowledgement
The development of wiliwili cannot do without the support of the following open source projects.
- Toolchain: devkitpro, switchbrew, vitasdk OpenOrbis and PacBrew
- https://github.com/devkitPro
- https://github.com/switchbrew/libnx
- https://github.com/vitasdk
- https://github.com/OpenOrbis
- https://github.com/PacBrew
- UI Library: natinusala and XITRIX
- https://github.com/natinusala/borealis
- https://github.com/XITRIX/borealis
- Video Player: Cpasjuste, proconsule fish47 and averne
- https://github.com/Cpasjuste/pplay
- https://github.com/proconsule/nxmp
- https://github.com/fish47/FFmpeg-vita
- https://github.com/averne
- Misc
- https://github.com/libcpr/cpr
- https://github.com/nlohmann/json
- https://github.com/nayuki/QR-Code-generator
- https://github.com/BYVoid/OpenCC
- https://github.com/imageworks/pystring
- https://github.com/sammycage/lunasvg
- https://github.com/cesanta/mongoose
- https://chromium.googlesource.com/webm/libwebp
- https://github.com/fancycode/MemoryModule
- https://github.com/dacap/clip
# Special thanks
- Thanks to Crowdin for supporting [open-source projects](https://crowdin.com/page/open-source-project-setup-request).
- Thanks to JetBrains for providing [Open Source development licenses](https://jb.gg/OpenSourceSupport).
