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

特点

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

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

安装

Nintendo Switch

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

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

PC

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

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

注意：

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

补充信息：

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

文档

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

TODO list

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

反馈问题前要做的事

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

⚠️：PC 平台非测试所需请不要使用此方式构建，没有经过太多的测试，且不支持 PC 系统输入法。

cmake -B build -DPLATFORM_DESKTOP=ON -DUSE_SDL2=ON
cmake --build build

交叉编译 Switch 可执行文件 (wiliwili.nro)

推荐使用docker构建，本地构建配置环境略微繁琐不过可用来切换底层的ffmpeg或mpv等其他依赖库更灵活地进行调试。

Docker

docker run --rm -v $(pwd):/data devkitpro/devkita64:20230622 \
  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-4.4.4-1-any.pkg.tar.zst \
    $base_url/switch-libmpv-0.35.1-1-any.pkg.tar.zst

# 4. 可选：安装依赖库 nspmini：https://github.com/StarDustCFW/nspmini
# (1). 在resources 目录下放置：nsp_forwarder.nsp (如何生成nsp见: scripts/switch-forwarder)
# (2). cmake 构建参数添加 -DBUILTIN_NSP=ON
# 按上述配置后，从相册打开wiliwili时会增加一个安装NSP Forwarder的按钮

# 5. build
cmake -B cmake-build-switch -DPLATFORM_SWITCH=ON
make -C cmake-build-switch wiliwili.nro -j$(nproc)

应用截图

Acknowledgement

devkitpro and switchbrew
natinusala and XITRIX
- https://github.com/natinusala/borealis
- https://github.com/XITRIX/borealis
Cpasjuste, proconsule and averne
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

Special thanks

Thanks to Crowdin for supporting open-source projects.
Thanks to JetBrains for providing Open Source development licenses.

xfangfang/wiliwili

xfangfang

Reviews

Repository Details

特点

安装