安装指南 / Windows / Mac / Linux
用电脑安装
准备好电脑和遥控器，跟着四步操作。无需自己编译。
下载应用和安装工具
在电脑上下载 WGT，然后选择对应系统的 Apps2Samsung 安装器。WGT 是电视应用包，无需解压。
打开下载的安装器，按系统提示安装 Apps2Samsung。Linux 用户可在工具发布页选择对应版本。
不知道 Mac 的芯片类型？
点击屏幕左上角苹果菜单 → 关于本机，查看「芯片」或「处理器」。Apple M 系列选择 Apple 芯片；Intel 选择 Intel 芯片。
Apps2Samsung 是独立第三方工具，按钮指向其官方 GitHub 的 2.8.3 版本。本项目不维护该工具；此安装路径尚未使用 BiliSofa 独立实测。了解工具 ↗
打开电视的开发者模式
先在电脑的 Wi-Fi 详情中找到并记下它的 IPv4 地址。手机或电脑与电视需连接同一网络。
- 电视按 主页 → Apps → App Settings，输入 12345。
- 将 Developer Mode 设为 On，填入电脑的 IPv4，确认。
- 根据提示重启电视。
在哪里找 IPv4？
安卓：设置 → Wi-Fi → 已连接网络 → 详情。Windows：按 Win + R，输入 cmd，在窗口输入 ipconfig，查看当前网络的 IPv4。Mac：系统设置 → 网络 → Wi-Fi → 详细信息 → TCP/IP。菜单名称可能因系统版本不同。
选择电视并安装
- 打开 Apps2Samsung，选择你的电视。未发现时，可按提示输入电视 IP。
- 选择 Custom WGT / TPK…，从下载文件夹选中 BiliSofa-0.66.0-unsigned.wgt。
- 选择安装，按提示使用自己的 Samsung 开发者账号和电视证书完成签名、安装。
保留自己的 Author 证书，以便后续更新。无需将证书或账号交给项目维护者。
回到电视，开始使用
在电视 Apps 中打开 BiliSofa，首次使用时，自行填写想观看的网站地址，例如 www.bilibili.com，并确认启用（目前仅支持 Bilibili）。可以先以游客身份浏览，或按提示使用官方 Bilibili App 扫码登录。
安装完成后，日常观看的设计目标是无需让安装设备持续运行。
遇到问题？
先查看下方常见问题，也可以在 GitHub 提交电视型号、固件版本和脱敏后的错误信息。
找不到电视或连接失败
确认电视和安装设备在同一可信局域网，开发者模式已开启且电视已重启。电视里填写的是安装设备的 IP；工具手动查找时填写的是电视 IP。检查路由器是否隔离设备。
提示证书或安装失败
按工具提示检查自己的 Samsung 开发者账号和目标电视证书。更新时先找回原 Author 证书；不要把卸载或清除数据作为默认修复。
安装后打不开、无法播放
0.66.0 尚未完成电视运行验收。请确认电视系统、网络和内容权益，并反馈型号、固件与脱敏错误。
前往 GitHub Issues ↗ · 平台协议与权利说明 ↗
不要公开账号密码、Cookie、二维码、证书、私钥、DUID 或私人 IP。页面中的图形均为流程示意，并非实际设备截图。