wiliwili

logo

一个专为手柄用户设计的第三方 B站 客户端

特点 | 安装 | 文档 | 开发

GitHub release (latest by date) GitHub All Releases GitHub stars GitHub forks Crowdin NS PSV PS4 MS mac Linux fedora Scoop Version (extras bucket) aur Flathub nightly.link layout


特点

wiliwili 拥有非常接近官方PC客户端的B站浏览体验
同时支持触屏、鼠标、键盘 与 手柄操控
无论是电脑还是游戏掌机都能获得全新的使用体验

多语言：简、繁、日、韩、英 …
搜索页：热搜 视频 番剧 影视
筛选页：快速找到想看的影视内容
动态页：关注的UP主最近视频动态
直播页：关注的主播与其他系统推荐
播放页：视频 番剧 电影 纪录片 综艺，支持弹幕与评论
个人页：扫码登录 历史记录 个人收藏 我的追番 我的追剧
主题色：拥有深浅两色主题，跟随系统自动切换


安装

Nintendo Switch

  1. 下载 wiliwili-NintendoSwitch.zip：wiliwili releases
  2. 将 wiliwili.nro 放置在内存卡 switch 目录下。
  3. 在主页 按住 R键打开任意游戏进入 hbmenu，在列表中选择 wiliwili 点击打开即可。
  4. [可选] 在应用内安装桌面图标，入口：设置/实用工具/使用教程


桌面图标会优先尝试打开 switch/wiliwili.nro，如果其不存在，则尝试打开 switch/wiliwili/wiliwili.nro，如果这两个路径都不存在，则打开 hbmenu 自行选择路径。

默认提供的为 OpenGL 版本，最高只能播放 4k@30，你也可以下载到支持原生图形 api 的 deko3d 版本，可以流畅播放 4k@60，不过可能会偶尔崩溃。

PSVita

下载 wiliwili-PSVita.vpk 安装即可：wiliwili releases

目前只推荐观看 360P 分辨率使用，不过仍有相当大的提升空间，如果你愿意为此贡献欢迎开一个 PR 讨论了解更多。

PS4

下载 wiliwili-PS4.pkg 安装即可：wiliwili releases

只支持软解，对于 ps4 推荐关闭设置中的低画质解码；ps4 pro 如果想勉强播放 4k@60 需要开启低画质解码。

PC

PC客户端支持切换硬件解码、秒开流畅适合老电脑、支持鼠标操控（左键点击 右键返回）

下载对应系统的安装包运行即可：wiliwili releases

现在Linux & Steam Deck 用户可以通过系统自带的软件商店（如Discover、GNOME Software）搜索wiliwili进行下载。


注意：

  1. 显卡驱动需要支持 OpenGL 3.2 以运行此程序
  2. Linux: 对于 Linux 系统只提供 Flatpak 安装包供 Steam Deck 安装，如有其他打包需求欢迎提交完善的打包脚本
  3. macOS: 欢迎 macOS 用户提交 Homebrew 安装方式到官方仓库
  4. Windows: 不提供 x86 安装包，如有需求可以自行编译

补充信息：

  1. 可以从 Github-Actions 下载自动构建的测试版客户端
  2. 如果不知道如何从 Github-Actions 下载软件，这里是 教程
  3. 你也可以从 nightly.link 免登录下载测试版 （可能不稳定）
  4. Windows用户可以通过下载 debug版 来查看log
  5. 自定义字体或按键图标：#38
  6. 目前支持的键盘映射见：#47
  7. Steam Deck 安装教程：#41
  8. 从包管理安装 wiliwili: #92


文档

在各位开发者的帮助下，wiliwili 支持了一系列包管理器，同时 wiliwili 还拥有丰富的自定义选项，包括：使用 Anime4K 提升观感，自定义字体及图标等等
前往 项目 WIKI 查看更多使用技巧


TODO list

如果你有其他改进的想法或创意，欢迎在讨论区交流：Discussions


反馈问题前要做的事

  1. 网络相关的问题附加 网络诊断截图，入口：应用内设置/实用工具/网络诊断
  2. [Switch用户] 要确保 大气层和系统固件 更新到 最新 ，内存卡为 FAT32
  3. [Switch用户] 如果打开应用黑屏时间过长，可以尝试删除内存卡目录 config/wiliwili 重新进入
  4. 确保 系统时间正确、系统网络设置正确（主要是DNS）、如果使用了网络代理请在反馈前关闭并重新测试
  5. 查找有没有其他人出现过类似的问题：Issues
  6. 完整且详细地 描述你的问题，最好附加演示视频、截图。
  7. 尝试复现问题，尽力找到BUG出现的规律


贡献

软件移植

本应用基于 nanovg 绘制界面，nanovg 底层可移植切换到任意图形库，视频播放部分则使用 MPV + FFMPEG 通过 OpenGL 绘制。 所以按照我的理解 wiliwili 应该可以移植到任何一个内存大于500MB，支持OpenGL（ES）的设备。如果你有想要移植的设备欢迎发一条 issue 讨论。

新功能

如果你有想完成的创意，请在开发前发布一个 issue 讨论，避免和别人的创意撞车浪费了时间

多语言支持

如果你想为软件添加多语言的翻译支持，或者发现了某些翻译存在问题需要订正，请查看 #52 了解如何贡献翻译

代码分支

主分支 yoga 为保证编译无误的最新代码
开发分支 dev 为正在开发中的代码，任何新的 PR 都需要向 dev 分支提交


开发

# 拉取代码
git clone --recursive https://github.com/xfangfang/wiliwili.git
cd wiliwili

PC本地运行

目前 wiliwili 支持运行在 Linux macOS 和 Windows上

macOS

# 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

欢迎在上面的链接中写出你所使用系统的编译过程供大家参考。

# 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)

# 如果你想安装在系统路径，并生成一个桌面图标，请使用如下内容编译
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

# 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 （测试支持）

由于 SDL2 支持的平台更多，考虑到未来向其他平台移植，所以 wiliwili 也支持切换到 SDL2 环境构建。

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

docker run --rm -v $(pwd):/data devkitpro/devkita64:20231108 \
  bash -c "/data/scripts/build_switch.sh"

本地编译

# 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 使用 docker 来编译。
编译时，请不要忘记将需要的四个 suprx 文件放入 scripts/psv/module 目录下。 详情请参考：borealis 示例 和 wiliwili_vita 编译指南

在 Apple Silicon 上编译，推荐使用 OrbStack 代替 Docker Desktop，因为前者支持 Rosetta 运行 x86_64 的 Docker 镜像。

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 环境（只支持 x86_64 Linux），并手动添加依赖库，请参考：scripts/ps4/Dockerfile

在 Apple Silicon 上编译，推荐使用 OrbStack 代替 Docker Desktop，因为前者支持 Rosetta 运行 x86_64 的 Docker 镜像。

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)"


应用截图

screenshot screenshot

Acknowledgement

The development of wiliwili cannot do without the support of the following open source projects.

Special thanks

This site is open source. Improve this page.