Skip to content

Latest commit

 

History

History
280 lines (199 loc) · 10.5 KB

README.md

File metadata and controls

280 lines (199 loc) · 10.5 KB
Raw

wiliwili

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

icon

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

GitHub release (latest by date) GitHub All Releases GitHub stars GitHub forks Crowdin NS MS mac Linux


支持特性

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


安装流程 (Nintendo Switch)

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

安装流程 (PC)

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

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

注意：

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

补充信息：

  1. 可以从 Github-Actions 下载自动构建的测试版客户端
  2. 如果不知道如何从 Github-Actions 下载软件，这里是 教程
  3. Windows用户可以通过下载 debug版 来查看log
  4. 自定义字体或按键图标：#38
  5. 目前支持的键盘映射见：#47
  6. Steam Deck 安装教程：#41

TODO list

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

  • 初步完成底层基础组件、首页各类推荐视频、用户视频播放页
  • 微调页面、解决播放器启动速度慢、解决播放页面退出卡顿
  • 临时解决异步加载导致的空指针问题（图片异步加载某些情况还会出现问题，待修复）
  • 添加番剧/影视播放、添加扫码登录、播放历史、用户收藏夹（收藏夹相关部分工作不稳定）
  • 初步添加搜索
  • 播放页新增分集与UP主最新投稿
  • 完善视频播放页用户评论内容
  • 重构图片异步加载逻辑
  • 解决收藏夹、搜索页某些情况导致闪退的问题
  • 完善搜索页：番剧、影视 转为竖图
  • 完善播放页投稿列表：调整结构、自动加载下一页
  • 播放页展示合集与推荐
  • 添加动态页
  • 添加视频检索页
  • 完善设置页
  • 弹幕相关设置
  • 点赞、投币、收藏
  • 拖拽调节进度
  • 增加单手模式使用一个手柄来控制播放器
  • NSP forwarder自动检查多个位置的nro文件，避免无法打开
  • 增加设置使首页无法通过返回退出，避免误触
  • 使用教程添加未指明的快捷键说明
  • 重压摇杆临时快进
  • 搜索支持搜索用户
  • 支持切换按键图标
  • 应用内多语言切换
  • 一键三连
  • 重构搜索页面

反馈问题前要做的事

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

贡献

软件移植

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

bug调试

目前我正在处理mpv在switch上播放部分视频报错的问题，也欢迎了解 FFMPEG、MPV或命令行GDB调试的朋友与我联系共同研究。

新功能

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

多语言支持

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


开发

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

PC本地运行

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

macOS

# macOS: install dependencies
brew install mpv

cmake -B build -DPLATFORM_DESKTOP=ON
make -C build wiliwili -j$(sysctl -n hw.ncpu)

Linux

# Ubuntu: install dependencies
sudo apt install libcurl4-openssl-dev libmpv-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
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

cmake -B build -G "MinGW Makefiles" -DPLATFORM_DESKTOP=ON
mingw32-make -C build wiliwili -j$(nproc)

SDL2 （测试支持）

由于 SDL2 支持的平台更多，考虑到未来向其他平台移植，所以wiliwili目前也支持切换到SDL2环境构建，目前只在switch和macOS上进行了测试。

# macOS
brew install sdl2 mpv

cmake -B build -DPLATFORM_DESKTOP=ON -DUSE_SDL2=ON
make -C build wiliwili -j$(sysctl -n hw.ncpu)

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

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

Docker

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

本地编译

# 1. 安装devkitpro环境: https://github.com/devkitPro/pacman/releases

# 2. 安装预编译的依赖
sudo dkp-pacman -S switch-glfw switch-cmake devkita64-cmake switch-pkg-config

# 3. 安装ffmpeg与mpv（使用自编译的库，官方的库无法播放网络视频）
# 手动编译方法请看：scripts/README.md
sudo dkp-pacman -U \
  https://github.com/xfangfang/wiliwili/releases/download/v0.1.0/switch-ffmpeg-4.4.3-1-any.pkg.tar.xz \
  https://github.com/xfangfang/wiliwili/releases/download/v0.1.0/switch-libmpv-0.34.1-1-any.pkg.tar.xz

# 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
make -C cmake-build-switch wiliwili.nro -j$(nproc)

应用截图

screenshot screenshot

Acknowledgement

Special thanks