三步把 Switch 变成客厅 B 站大屏:wiliwili 客户端安装与上手
【免费下载链接】wiliwili第三方B站客户端,目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
wiliwili 是一款开源的第三方 B 站客户端,装到 Nintendo Switch 上就能刷视频、追番剧、看直播、发弹幕,同一套代码还能跑在 PSVita、PS4、Xbox 和 Windows、macOS、Linux 的电脑上。它把界面做成了手柄优先:十字键挪焦点、A 键确认、B 键返回,窝在沙发里不用举着手机就能把 B 站刷到底。
项目一览:10 秒判断它值不值得装
- 平台覆盖广:Switch、PSVita、PS4、Xbox 和 PC 全平台,一份代码多端共用
- 功能接近官方 PC 端:首页推荐、搜索(视频/番剧/影视/热搜)、动态、直播、弹幕、评论、一键三连、扫码登录、历史记录、收藏夹、追番追剧都在
- 手柄操作是主业:整套交互围绕十字键 + 确认/返回设计,电视模式大屏使用没有障碍
- 开源免费:代码公开,支持简中、繁中、日、韩、英等多语言切换
- 画质可调:最高 4K@60,支持 Anime4K 滤镜、自定义主题、深浅双色跟随系统
三步跑起来:下载、拷贝、hbmenu 启动
- 到项目的发布页,下载 Switch 平台的
wiliwili-NintendoSwitch.zip,解压出wiliwili.nro - 把
wiliwili.nro拷到内存卡的switch/目录下 - 游戏主界面按住R键打开 hbmenu(HB App Store),在列表里找到 wiliwili 按 A 启动
首次启动可以顺手在「设置/实用工具/使用教程」里安装桌面图标,以后直接在 Switch 主界面点开,不用每次进 hbmenu。想改代码自己编译的话,仓库拉下来跑一键脚本就行:
git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili cd wiliwili && docker run --rm -v $(pwd):/data devkitpro/devkita64:latest bash -c "/data/scripts/build_switch.sh"Docker 方式会自动装好 Switch 交叉编译环境和依赖,产物在cmake-build-switch目录里。
按场景体验:追番、直播、搜索分别是什么手感
客厅追番和影视库:十字键选集、A 键开播
影视页按地区、年份、类型、配音、版权状态层层筛,番剧列表竖图排布,进播放页可以直接看分集、UP 主其他投稿和评论区。你很快会习惯的操作是:十字键挪动焦点,A 键进入卡片,B 键随时退回来,拖进度用滑杆。
看直播和刷首页:弹幕侧边栏 + 多标签切换
直播页能进关注的主播和系统推荐的房间,画面里的弹幕、评论与直播同步滚动,侧边栏还会贴出最新的聊天内容。首页顶部一排标签页(推荐、热门、追番、影视)来回切,状态栏能看到当前时间和 FPS,方便你判断网络状态。
搜索:热搜、历史和筛选页一步到位
搜索页顶部有热搜榜和搜索历史,可一键清空或单条删除。影视筛选页把综合排序、地区、年代、番剧类型、付费类型、配音类型、版权状态、完结状态这些条件铺成网格,手柄按几个键就能把范围缩到个位数。
把它调得更顺手:弹幕、画质、网络与外观
- 弹幕刷得太满挡住画面,进播放页弹幕设置调显示区域占比、透明度、滚动速度,也能按顶部/滚动/底部分别过滤,并开启智能遮挡。相关逻辑在 wiliwili/include/view/danmaku_core.hpp
- 想要 4K@60 更稳:默认发布的 OpenGL 版上限是 4K@30,追求高帧率可以换 deko3d 版(scripts/build_switch_deko3d.sh),代价是偶发崩溃的概率变高。PS4 是纯软解,播 4K@60 要在设置里开低画质解码
- 网络环境特殊时,设置里能配代理和 DNS,跑一遍「实用工具/网络诊断」可以看到 API 连通性、时差、WiFi 和 DNS 状态,比盲猜快
- 外观上能切深浅主题(跟随系统自动切换)、应用内换语言,还能装自定义主题包换整套布局;按键图标支持 Xbox/PS/键盘三套映射,改法见 wiliwili/include/utils/shortcut_helper.hpp
卡住了先自查:四个最常见问题的排查顺序
- 启动后长时间黑屏 / 打不开:先确认大气层和系统固件是最新版、内存卡为 FAT32;再删掉内存卡上的
config/wiliwili目录重新进入——这是官方给出的清缓存动作 - 视频转圈不出画面:检查系统时间是否准确(时间偏差会导致接口请求失败),再跑一次网络诊断;开着代理的话先关掉再测
- 4K 或高帧率卡顿:先降到 1080P 确认是否恢复,Switch 用户可换 deko3d 版本,PS4 用户开低画质解码;弹幕量大的场景临时关弹幕也能减轻渲染压力
- 登录态丢失:账号 Cookie 只存在本机
config/wiliwili里,建议全程用扫码登录;换设备或卸载前清一下配置目录,别把凭据留在一台机器上
项目速览与去向
技术上一句话:C++17 写的,界面用 nanovg 绘制,播放是 mpv + FFmpeg,窗口和输入走 GLFW 或 SDL。代码按功能分层放在 wiliwili/include/ 和 wiliwili/source/,分 activity(整页)、fragment(子页)、presenter(取数)、view(组件)、api(接口)几层;界面布局和 i18n 文案在resources/下,各平台构建脚本在scripts/。
项目维护着一份公开的 TODO 清单:个人主页、互动视频、长按一键三连等特性还在路上。想参与的话,issue 和讨论区常年开放,Crowdin 也接受多语言翻译;使用前注意遵守 B 站的服务条款,别做高频请求类的玩法。
【免费下载链接】wiliwili第三方B站客户端,目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考