Apps2Samsung：三星电视应用一键安装

项目简介

Apps2Samsung 是一个跨平台侧载（sideload）工具，用于给运行 Tizen OS 的三星设备安装应用，包括智能电视、投影仪和智能显示器。它可以安装 Jellyfin、Moonlight、Moonfin、Litefin、TizenTube、社区目录中的应用，或你自己的 .wgt / 原生 .tpk 文件。

工具会自动处理设备发现、证书签名和安装流程，省去手动折腾 Tizen Studio 或命令行侧载的麻烦。界面提供 30 种语言，并默认使用你的系统语言。

主要功能

• 发现电视：扫描网络中的三星电视，也可手动输入 IP；当电视未就绪时会指出具体原因（开发者模式未开、IP 不匹配、IP 顺序颠倒、需要断电重启等）。
• 自动处理证书：登录一次三星账号后按电视复用证书，可用 DUID 预先授权其他电视；应用需要受限权限时自动选用 Public / Partner 证书。
• 应用目录：按分类浏览 110+ 个社区应用，支持搜索、收藏置顶和每个应用的详情面板（描述、版本或变体、来源链接）；18+ 应用默认隐藏，需要主动开启；会获取 root 的应用带 root 标记并在安装前确认。
• 安装前参数表单：需要 API key、服务器地址、端口等信息的应用会先弹出简短表单，下次更新时自动填好。
• 管理已装应用：显示图标和目录中的最新版本，支持一键更新、卸载、启动、停止、调试（inspector 转发到 chrome://inspect）以及强制清除残留包。
• 遥控器功能：方向键、播放、音量、频道、电源和实时输入，走三星自带的遥控通道，无需开发者模式。
• 安装时调优：Jellyfin 服务器与自动登录、JellyThemes / 自定义 CSS、播放偏好、服务器插件、YouTube 预告片修复，以及 TVapp 频道、ImmiTV、Camera PiP 等应用的参数配置。
• 诊断与备份：查看 DUID、Tizen 版本、型号、开发者模式状态，保存电视实时日志；设置和签名证书可导出为一个文件迁移到另一台电脑、Mac 或手机。
• TV-Store：从目录安装 TV-Store 并在电视工具箱中启用后，电视可自行浏览和安装目录应用，无需电脑或手机。
• 自动更新：桌面端和 Android 端内置更新器，可选择加入 beta 通道。

安装与使用

1. 先在三星电视上开启开发者模式（方法见项目 wiki 的 FAQ）。
2. 在电脑上运行工具，或在手机上使用 Android / iPhone 应用。
3. 选择你的三星电视，挑选应用（Jellyfin、社区目录或自定义 .wgt），点击安装。

各平台获取方式：

• 桌面端：从 Releases 下载稳定版 v3.1.0（多数用户推荐）或 beta 版。
• Android：可通过 Obtainium 跟踪本仓库的 GitHub Release 自动更新，或在 F-Droid 类客户端中添加仓库地址 https://apps2samsung.com/fdroid/repo，也可直接下载 -android.apk 侧载。
• iPhone（v3 起提供，未上架 App Store）：用 SideStore 配合自己的 Apple ID 签名安装，可在 SideStore 的 Sources 中添加 https://apps2samsung.com/sidestore/beta/apps.json，或使用 beta 发布中的 -ios-unsigned.ipa。
• 命令行：每次发布也附带 apps2samsung-cli 单文件二进制，与图形界面共用同一套目录、证书和安装流程。

apps2samsung-cli scan
apps2samsung-cli catalog jellyfin
apps2samsung-cli install "Moonfin" --tv 192.168.1.50

CLI 命令加 --json 会在 stdout 输出单个 JSON 文档；退出码 0 表示完成，1 失败，2 用法错误，3 表示停在预检查（可加 --yes 继续）。首次为某台电视安装时会创建签名证书，需要在同一台机器的浏览器里登录三星账号。

NixOS 用户可以克隆仓库后运行 nix-shell，环境会自动构建并启动工具。自行打包时可用 -p:DisableSelfUpdate=true 编译掉就地自更新功能，适合 Nix、Homebrew 这类由包管理器托管文件的安装方式。

注意事项

• 安装应用前必须在电视上开启开发者模式。
• 基于 Orsay 的旧款电视（2015 年以前型号）已不再支持。
• iPhone 端使用免费 Apple ID 时，签名有效期为 7 天，SideStore 会在后台续签；同时最多只能侧载 3 个应用（含 SideStore 本身）。安装过程中需让应用保持在前台，iOS 会暂停后台应用。
• 在 iPhone 上通过遥控器唤醒电视可能不生效，因为 iOS 会阻止免费 Apple ID 签名的应用所需的网络广播。
• macOS 上首次运行下载的 CLI 二进制前，需要执行一次 xattr -d com.apple.quarantine apps2samsung-cli。
• 社区共享的 .wgt 构建可在 tizen-community-packages 仓库找到。

本作品整理自 GitHub 开源项目 Apps2Samsung/Apps2Samsung，原作者 @Apps2Samsung，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。