三步把 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），仅供参考
