Skip to content
81199000Public

About

DouDuo:适配 iPhone Duo / iPad 的第三方抖音客户端——原生播放、秒开 + 50 条预缓存、横滑快进、弹幕、评论、直播聊天、搜索、喜欢/收藏/历史

Topics

Resources

Stars

206 stars

Watchers

1 watching

Forks

Repository files navigation

douduo icon

douduo

原生 SwiftUI 的第三方抖音客户端,适配 iPhone Duo 折叠屏、iPad 与普通 iPhone。开源免费,非官方。

官方抖音 App 在折叠屏内屏、iPad 上不适配,网页版又总是跳 App,所以有了它。界面和播放全部原生(SwiftUI + AVPlayer,VLC 兜底)。

DouDuo:默认 / 简洁 / 极简 / 经典 四种界面

示意图(自绘,非实机截图),画面内容为抽象插画,不含真实用户作品。

功能

看视频

  • 推荐 / 关注 / 直播,整页上下滑;秒开(先播上次缓存的视频)+ 后台预缓存后面若干条
  • 四种界面,「更多 → 设置 → 界面模式」切换:默认 / 简洁 / 极简(极简只剩视频,进度画在右侧圆形入口外圈),以及 iPhone Duo 可选的经典布局(iOS 27.1+,说明)。四种界面共用同一套交互,维护规矩见 docs/ui-modes.md
  • 横滑快进快退(带预览)、双击点赞、长按加速、倍速选档、自动连播、后台播放与锁屏控制
  • 实时环境光:视频没铺满时四周跟随画面颜色,黑底,亮 / 中 / 暗 / 很暗 / 关五档
  • 折叠屏:半折叠按折痕分屏(视频 / 评论)、横屏搜索左右分栏;自动铺满可关
  • #话题 点击直接搜索;推荐页可按标签屏蔽不想看的内容

互动(需在 App 内登录抖音)

  • 点赞、收藏、评论 / 回复(表情、@ 用户、配图)、弹幕显示与发送
  • 消息中心与私信、原生「分享给」好友
  • 直播:原生播放(VLC 解 HEVC)、直播间聊天与发言、关注主播开播条、画质选档

我的

  • 搜索(联想词、热搜、历史)、喜欢 / 收藏 / 观看历史 / 稍后再看、作者主页与作品列表
  • 保存视频 / 图集到相册

每个版本的改动见 更新说明 或 GitHub Releases。

下载安装

支持 iOS / iPadOS 26.0 及以上。DouDuo 未上架 App Store,安装包是未签名 IPA,需要签名后安装。两种方式:

方式一:一键签(推荐) 方式二:全能签 + 软件源
花钱吗 免费(用自己的 Apple ID) 要买证书
要电脑吗 要(Windows / Mac) 不要,全程在手机上
有效期 7 天,自动续签 跟证书走,一般 1 年
更新新版 自动装上 软件源里点一下,签名安装

方式一:一键签(免费,自动续签)

  1. 下载 一键签(Windows / Mac)
  2. 数据线连手机,在一键签里选 DouDuo,点 一键安装
  3. 手机上 设置 → 通用 → VPN 与设备管理 信任你的 Apple ID

详细步骤见 一键签使用教程。

更新也在一键签里完成:有新版会自动装上,登录状态和观看记录会保留。

方式二:全能签 + DouDuo 软件源(手机上安装和更新)

全能签是手机上的签名工具:导入证书后,在 App 里就能下载、签名、安装,不用电脑。

全能签本身免费,但必须有证书才能用。 顺序是「先有证书 → 再装全能签」。

1. 买证书

两种渠道:全能签官网买兑换码(证书和全能签一起装好,适合新手),或 淘宝 / 闲鱼买证书(便宜些,拿到 .p12 + .mobileprovision + 密码)。

买之前先拿到手机的 UDID:用 Safari 打开 全能签官网 点「获取 UDID」,按提示安装描述文件。

全能签官网获取 UDID:设置里安装描述文件

图片来自全能签官网安装页教程。

2. 安装全能签

  • 兑换码:在 全能签官网 输入兑换码 →「立即安装」。
  • 自己的证书:在官网点「我有证书 | 自助安装」,上传 .p12 和 .mobileprovision,填密码 →「签名安装」。

装好后在 设置 → 通用 → VPN 与设备管理 信任证书;再打开 设置 → 隐私与安全性 → 开发者模式,按提示重启。

打开开发者模式

图片来自全能签官网安装页教程。

3. 把证书导入全能签

全能签 → 设置 → 导入文件,选 .p12 和 .mobileprovision(或证书 zip 包),输入密码。在 证书 页看到状态有效即可。

4. 添加软件源,签名安装

全能签 → 资源 → 软件源 → 右上角添加:

软件源 地址
国内(Gitee) https://gitee.com/remon8/douduo/raw/main/docs/source/douduo.json
海外(GitHub) https://raw.githubusercontent.com/81199000/DouDuo/main/docs/source/douduo-github.json

在源里点 DouDuo → 下载 → 资源 → App 里点它 → 签名 → 安装。以后有新版,在源里下拉刷新再装一次,会覆盖旧版,登录状态保留。

⚠️ 买来的证书可能被苹果吊销(「掉签」),掉签后 App 打不开,只能换证书重签。买之前问清楚掉签补不补。不要用网上流传的免费 / 共享证书。

首次使用:登录抖音

点右上角「我的」→「网页版 / 登录」,在抖音网页里用验证码或密码登录。登录后推荐流按你的账号个性化,点赞、收藏、评论、弹幕会同步到你的抖音账号。

不登录也能看推荐、搜索、直播。登录信息只保存在手机本地,不经过任何第三方服务器。

常见问题

  • 打开就闪退:签名过期了。一键签:点「立即全部续签」;全能签:看证书是否失效(掉签),换证书重签。
  • 提示「抖音拦截了请求」/ 一直加载:点菜单 →「网页版 / 登录」,在网页里刷一下(必要时过一下滑块验证),返回后会自动重试。
  • 视频黑屏或卡住:App 会自动重试,并切换到 VLC 内核兜底;仍不行就下滑到下一条。
  • 占用空间大:「更多 → 设置 → 缓存」把预缓存数量调小或关闭,或者点「清除视频缓存」。用流量刷时建议关掉预缓存。

已知限制

  • 搜索只有第一页:抖音网页接口翻第二页会被安全 SDK 拦下,目前没有办法翻页。
  • 图文作品偶尔没有背景音乐(#19)。
  • 经典布局只在 iOS 27.1 及以上显示,仅针对 iPhone Duo 适配;iPad、画中画尚未完整实测。
  • 抖音风控时可能要去「网页版」过一下验证;抖音网页接口改版时需要跟着更新。

欢迎提 Issue / PR。

原理

没有逆向抖音 App,也不需要任何密钥:App 里挂着一个看不见的抖音网页(电脑版 UA),所有接口请求都在这个页面里发出,由抖音网页自己的安全 SDK 自动补签名(a_bogus 等),所以签名算法跟着官方更新走。普通视频用 AVPlayer,起不来时自动切 VLC;直播流是 HEVC + MPEG‑TS,一律用 VLC。登录态和「网页版」共用 WKWebsiteDataStore.default(),只存在本机。

已接入的接口清单见 docs/api-inventory.md;维护者发版流程见 docs/RELEASING.md。

免责声明

本声明说明项目意图与边界,不构成法律意见,也不能免除法律责任;它不能替代权利人的授权。

  • 非官方、无授权:本项目是个人学习与技术研究用的第三方客户端,与抖音、北京微播视界科技有限公司及其关联公司没有任何隶属、合作或授权关系。「抖音」等名称、商标、图标归其权利人所有,本项目仅作描述性提及,不把官方标识当作自己的品牌,也不代表官方立场。
  • 不提供、不存储、不分发内容:App 只在你自己的设备上展示通过抖音网页接口获取的内容,不搭建内容服务、不缓存分发、不提供下载。视频、图片、音乐、评论、直播流的版权归原作者与平台所有。
  • 账号与使用责任:使用本项目需要你自己的抖音账号登录。请自行遵守《抖音用户服务协议》和所在地法律;禁止用于商业用途、批量抓取、刷量、绕过付费或权限、二次分发,以及其他侵害他人权益的行为。账号被限制、数据丢失、设备异常等后果由使用者自行承担。
  • 不绕过付费与权限:本项目不提供会员内容、付费内容、私密内容的解锁能力,也不修改平台返回的权限结果。
  • 签名与分发:仓库和软件源只提供未签名 IPA,由使用者用 一键签(自己的 Apple ID)或自备证书签名安装。本项目不出售、不提供任何证书,与全能签及各证书卖家无合作关系;证书来源、掉签等风险由使用者自行判断。请勿分发已签名安装包。
  • 无担保:软件按「现状」提供,不保证可用性、稳定性、合规性或适用于特定目的;平台接口改版或风控可能导致功能随时失效。
  • 侵权处理:如权利人认为本项目侵犯其权益,请通过 Issue 或仓库公开的联系方式告知,核实后会删除相关内容或停止分发。
  • 地区差异:不同国家和地区对第三方客户端、逆向与接口调用的规定不同;如当地法律禁止,请不要使用或分发本项目。

License

MIT

About

DouDuo:适配 iPhone Duo / iPad 的第三方抖音客户端——原生播放、秒开 + 50 条预缓存、横滑快进、弹幕、评论、直播聊天、搜索、喜欢/收藏/历史

Topics

Resources

Stars

206 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages