Xposed Modules

Toki

English | 中文 | Changelog | 更新日志 | Telegram

Toki is a libxposed API 102 enhancement module implemented and tested for official TikTok 46.4.3. It only targets com.zhiliaoapp.musically.

Features

  • Region and environment spoofing: choose region presets with country codes and carrier information, and independently spoof GPS, system language, and system time zone.
  • Startup login prompt: close the dismissible prompt shown during startup without bypassing login or verification.
  • Download enhancements: remove download restrictions, prefer watermark-free saving for all videos, and set separate save locations for videos, images, and GIFs.
  • Feed filtering: hide ads, livestreams, photo posts, AI-generated content, trending-topic bars, content ratings, and long videos; filter by view or like count.
  • Duet and Stitch: allow restricted content to be used for Duet or Stitch. When looping is disabled, playback pauses at the end and can be replayed with one tap.
  • Playback controls: automatically apply 1.25x to 2.0x to each new video without overriding a manual speed choice, and optionally keep the progress bar visible on videos under 30 seconds.
  • Feed display: optionally show the author's region code with its matching country flag.
  • Comment translation: show Translate and Revert controls in comments and preserve translation state across videos.
  • Page purification: independently hide author avatar and information, descriptions, music, action buttons, navigation, search, LIVE, commercial, creative, movie, anime, and game entrances, feedback surveys, safety warnings, Tako, translation controls, and the system status bar.
  • Count ranges: enter full numbers or compact suffixes such as 20K and 1.5M directly.
  • Metric range fields preserve the exact text entered while filtering uses the parsed count.
  • Home dashboard: view LSPosed service and TikTok version status, restart TikTok, clear only its cache with Root, reset Toki settings, and open the project community and issue tracker.
  • Material 3 settings UI with dark mode, dynamic color, and manual Follow System, English, and Chinese language switching.

Requirements

  • Android 8.0 or later
  • An LSPosed implementation that supports libxposed API 102
  • Official TikTok 46.4.3 with package name com.zhiliaoapp.musically. Other versions are outside the support scope and receive no version-specific compatibility work or guarantees.
  • The module APK is architecture-independent.

Installation

  1. Download the APK from Releases.
  2. Install it, enable Toki in LSPosed, and select the TikTok scope.
  3. Open Home in Toki and tap Restart TikTok after changing settings. Restart TikTok manually when Root access is unavailable.

Root is used only when you explicitly choose Restart TikTok or Clear TikTok Cache on Home. Cache clearing preserves TikTok accounts, settings, drafts, and app data.

Community: Telegram group

Reporting Issues

  • Use the Bug Report form for reproducible failures. Include the Toki, TikTok, Android, device, and LSPosed versions, exact reproduction steps, relevant settings, and sanitized LSPosed module logs.
  • Use the Feature Request form for concrete improvements based on an actual use case.
  • Use the Telegram group for general discussion and help identifying a problem before filing it. Do not post account data, tokens, cookies, or unredacted private logs.

Privacy

Toki declares no network permissions and contains no analytics, telemetry, remote updates, or promotional entry points. Settings are stored only on the device.

Build

JDK 21, Android SDK Platform 37.0, and Build Tools 37.0.0 are required.

.\gradlew.bat testDebugUnitTest lintDebug assembleDebug

Without signing environment variables, assembleRelease produces an unsigned APK. For a signed release, set the following variables and run .\gradlew.bat clean testDebugUnitTest lintDebug assembleRelease:

TOKI_KEYSTORE_FILE
TOKI_STORE_PASSWORD
TOKI_KEY_ALIAS
TOKI_KEY_PASSWORD

Origin and License

The project originally used the MIT-licensed project structure of TiktokPatchXposed. Toki's implementation has since been rewritten. This repository contains neither a TikTok APK nor decompiled source code.

This project is released under the MIT License. Licenses for dependencies and build tools are listed in THIRD_PARTY_NOTICES.md.

Disclaimer

This project is intended only for learning, research, and use on personal devices. It is not affiliated with or endorsed by TikTok, ByteDance, or LSPosed. TikTok updates can break compatibility; make sure your use complies with local law and the applicable terms of service.

中文

Toki 是面向官方 TikTok 46.4.3 实现并完成测试的 libxposed API 102 功能增强模块，仅作用于 com.zhiliaoapp.musically。其他版本不在支持范围内，不提供专门适配或兼容保证。

功能

  • 地区与环境伪装：选择预设地区（含国家/地区码与运营商信息），可独立伪装 GPS、系统语言和系统时区，并可强制指定地区。
  • 启动登录引导：可关闭启动时可跳过的登录提示，不绕过登录或验证。
  • 下载增强：解除下载限制，所有视频优先使用无水印地址，可分别设置视频、图片和 GIF 保存目录。
  • 信息流过滤：隐藏广告、直播、图文帖、AI 生成内容、热点话题条、内容评级提示和长视频，并按播放量/点赞数过滤。
  • 合拍与拼接：允许受限内容合拍或拼接；关闭循环播放后视频进入暂停状态，单击即可重播。
  • 播放控制：为新视频自动应用 1.25x–2.0x，不覆盖当前视频内手动选择的倍速，并可让短于 30 秒的视频始终显示进度条。
  • 信息显示：可在作者昵称旁显示对应国家/地区旗帜和地区代码。
  • 评论翻译：评论区显示“翻译/还原”按钮，并跨视频保持翻译状态。
  • 页面净化：可分别隐藏作者头像与信息、文案、音乐、互动按钮、导航、搜索、直播、商业推广、 创作工具、影视动漫与游戏入口、评价问卷、伤害警告、Tako、翻译控件和手机系统状态栏。
  • 数量范围：支持直接输入完整数字或 20K、1.5M 等数量后缀。
  • 数据筛选输入会保留用户输入的原始文本，过滤时使用解析后的数值。
  • 首页：查看 LSPosed 服务与 TikTok 版本状态，使用 Root 重启 TikTok 或仅清除其缓存，重置 Toki 配置，并打开项目社区和问题反馈页面。
  • Material 3 设置界面，支持深色模式、动态配色，以及跟随系统、English 和中文三种界面语言。

环境要求

  • Android 8.0 或更高版本
  • 支持 libxposed API 102 的 LSPosed 实现
  • 官方 TikTok 46.4.3，包名 com.zhiliaoapp.musically；其他版本不在支持范围内
  • 模块 APK 不区分设备架构

安装

  1. 从 Releases 下载 APK。
  2. 安装后在 LSPosed 中启用 Toki，并勾选 TikTok 作用域。
  3. 修改设置后，可在 Toki 首页点击“重启 TikTok”使设置生效。没有 Root 权限时，请手动重启 TikTok。

只有在首页主动选择“重启 TikTok”或“清除 TikTok 缓存”时才会使用 Root；清除缓存不会删除 TikTok 账号、设置、草稿或应用数据。

交流：Telegram 群组

问题反馈

  • 可稳定复现的异常请使用 错误报告表单， 并填写 Toki、TikTok、Android、设备和 LSPosed 版本、完整复现步骤、相关设置及已脱敏的模块日志。
  • 有明确使用场景的改进建议请使用 功能建议表单。
  • 一般交流或尚未确认的问题可先在 Telegram 群组讨论。 请勿公开账号资料、Token、Cookie 或未经脱敏的私人日志。

隐私

模块不声明网络权限，无统计、遥测、远程更新或推广入口，设置仅保存在本机。

构建

需要 JDK 21、Android SDK Platform 37.0 与 Build Tools 37.0.0。

.\gradlew.bat testDebugUnitTest lintDebug assembleDebug

未配置签名环境变量时 assembleRelease 生成未签名 APK；正式发布需设置以下环境变量后运行 .\gradlew.bat clean testDebugUnitTest lintDebug assembleRelease：

TOKI_KEYSTORE_FILE
TOKI_STORE_PASSWORD
TOKI_KEY_ALIAS
TOKI_KEY_PASSWORD

来源与许可证

项目最初基于 TiktokPatchXposed 的 MIT 许可工程结构，现有实现已针对 Toki 重写；仓库不包含 TikTok APK 或反编译源码。

本项目按 MIT License 发布，依赖与构建工具许可证见 THIRD_PARTY_NOTICES.md。

免责声明

本项目仅供学习、研究和个人设备使用，与 TikTok、ByteDance 及 LSPosed 项目无隶属或认可 关系。TikTok 版本更新可能导致功能失效，使用前请确认符合当地法律及相关服务条款。

Releases

Toki 0.4.23

Stable

8/19/2026, 8:52:16 PM

Highlights

  • Added a Home dashboard with LSPosed service status and installed TikTok version information.
  • Moved TikTok restart to Home and added Root-only, cache-only TikTok cleanup that preserves accounts, settings, drafts, and app data.
  • Added Follow System, English, and Chinese interface language switching, plus a reset-all-settings action.
  • Added direct GitHub, Telegram, and issue-report links and four-destination navigation.
  • Added an independent page-purification control for game-related entrances.

Verification

  • Implementation and test target: official TikTok 46.4.3
  • Package: com.zhiliaoapp.musically
  • Verification: clean, testDebugUnitTest, lintDebug, and signed assembleRelease passed
  • APK version: 423 / 0.4.23
  • APK SHA-256: A9DE94E01303C9DB7C4F45EFCCF7A7841F8476D7998B9F415358545D238B169D

中文说明

  • 新增首页，可查看 LSPosed 服务状态与已安装的 TikTok 版本。
  • 将 TikTok 重启移至首页，并新增仅清除缓存的 Root 操作；账号、设置、草稿和应用数据均会保留。
  • 新增跟随系统、English 与中文三种界面语言，并可一键重置全部配置。
  • 新增 GitHub、Telegram、问题反馈直达入口与四项主导航。
  • 新增独立的游戏相关入口页面净化选项。
  • APK 版本：423 / 0.4.23

Assets

1

Toki 0.4.21

Stable

8/19/2026, 12:39:22 PM

Highlights

  • Added an optional page-purification control to hide the system status bar on TikTok's main video pages.
  • Applied the status-bar control only to TikTok 46.4.3's MainActivity and kept it active across layout updates.
  • Used Android's WindowInsetsController on Android 11+ with a legacy system-UI fallback for Android 8–10.

Verification

  • Implementation and test target: official TikTok 46.4.3
  • Package: com.zhiliaoapp.musically
  • Verification: clean, testDebugUnitTest, lintDebug, and signed assembleRelease passed
  • APK version: 421 / 0.4.21
  • APK SHA-256: 4a8d30b6eb79d6f72b8605129841edb8f9734addec6397946904ef792712ffa9

中文说明

  • 新增页面净化选项，可隐藏 TikTok 主视频页面的手机系统状态栏。
  • 状态栏功能仅作用于 TikTok 46.4.3 的 MainActivity，并在页面布局更新后保持生效。
  • Android 11 及以上使用 WindowInsetsController，Android 8–10 使用兼容性的系统 UI 标记。
  • APK 版本：421 / 0.4.21

Assets

1

Toki 0.4.20

Stable

8/19/2026, 10:08:48 AM

Highlights

  • Set official TikTok 46.4.3 as the sole implementation, testing, and maintenance target; removed 46.3.x-specific compatibility code.
  • Split Hook installation into isolated feature classes while keeping one module APK and entry point.
  • Extended TikTok 46.4.3 For You filtering to feed dispatch and cache-backed list insertion paths.
  • Preserved the exact text entered in view-count and like-count range fields while filtering with the parsed numeric values.
  • Added an option to disable offline cold-cache use while a network is available.
  • Added the Toki Telegram group.

Verification

  • Implementation and test target: official TikTok 46.4.3
  • Package: com.zhiliaoapp.musically
  • Verification: testDebugUnitTest, lintDebug, and signed assembleRelease passed
  • APK SHA-256: d2325a250d5210a3ebcf5c0ea5233b5c08e93b4cff3316df9bb652e3d828d8c5

中文说明

  • 将官方 TikTok 46.4.3 设为唯一实现、测试与维护目标，移除 46.3.x 专用兼容代码。
  • 将 Hook 安装拆分为独立功能类，同时保持单一模块 APK 和入口。
  • 将 TikTok 46.4.3 推荐页过滤扩展到信息流消息分发和缓存列表插入路径。
  • 播放量与点赞数范围会原样显示输入文本，过滤计算仍使用解析后的数值。
  • 增加联网时禁用离线冷缓存的选项。
  • 新增 Toki Telegram 群组。

Assets

1

Toki 0.4.19

Stable

8/18/2026, 2:53:58 PM

Highlights

  • Added official TikTok 46.4.3 compatibility for comment translation and playback-completion handling.
  • Fixed custom video, image, and GIF save locations on TikTok 46.3.2 and 46.4.3.
  • Replaced the Android system directory picker with a built-in relative shared-storage path editor.
  • Extended trending-topic and promotional-overlay purification for TikTok 46.4.3.

Known issue

  • View-count and like-count filtering remains unreliable on TikTok 46.4.3. Some videos outside the configured ranges may still appear.

Verification

  • Supported TikTok versions: official 46.3.2, 46.3.3, and 46.4.3
  • Package: com.zhiliaoapp.musically
  • Verification: testDebugUnitTest, lintDebug, and signed assembleRelease passed
  • APK SHA-256: fa9efe1d66c393b34f547b9f523eb0f65c3cc1ccaa6b19938be6df0bc264914f

中文说明

  • 适配官方 TikTok 46.4.3 的评论翻译和播放完成处理。
  • 修复 TikTok 46.3.2 与 46.4.3 的视频、图片和 GIF 自定义保存位置。
  • 移除 Android 系统目录选择器，改用内置共享存储相对路径编辑框。
  • 扩展 TikTok 46.4.3 的热点话题与推广浮层净化兼容。

已知问题

  • TikTok 46.4.3 的播放量与点赞数筛选仍不可靠，少数范围外视频可能出现。

Assets

1

Toki 0.4.18

Stable

8/17/2026, 8:58:59 PM

Highlights

  • Reworked the Material 3 settings screen and organized features into General, Feed, and Downloads sections.
  • Added page purification for author details, descriptions, music, action buttons, search, Tako, translation controls, and navigation bars.
  • Added filters for AI-generated content, trending-topic bars, and content-rating prompts.
  • Added independent GPS, system-language, and system-time-zone spoofing.
  • Added a startup login-guide skip option that dismisses skippable prompts only; it does not bypass login or verification.
  • Improved view-count and like-count filters with full numbers and K/M/B suffixes.
  • Removed the failed anti-burn-in feature and display the default playback-speed option as 1.0x.
  • Prefer watermark-free URLs when saving videos.

Verification

  • Supported TikTok versions: official 46.3.2 and 46.3.3
  • Package: com.zhiliaoapp.musically
  • APK SHA-256: cb94cfb62fad2cf22b58bee21a580ab12d5115af9dfb76032664b6143f9bee5c

中文说明

  • 重构 Material 3 设置页，按常规、信息流和下载分类。
  • 新增页面净化、AI 内容/热点话题/内容评级过滤。
  • 新增 GPS、系统语言、系统时区伪装。
  • 新增跳过启动登录引导，仅关闭启动时可跳过的提示，不绕过登录或验证。
  • 优化播放量与点赞量范围输入，支持完整数字和 K/M/B 后缀。
  • 移除防烧屏功能，默认倍速标准项显示为 1.0x。
  • 优化所有视频的无水印保存优先级。

Assets

1

0.4.15

Stable

8/13/2026, 6:37:50 PM

更新内容

  • 明确仅支持官方 TikTok，移除第三方修改客户端专用兼容代码。
  • 优化禁止循环播放：播放结束后进入 TikTok 原生暂停状态，并显示重播首帧。
  • 修复播放结束后需要点击两次才能重新播放，以及切换视频后功能失效的问题。
  • 不再强制同步播放进度条；进度条保留 TikTok 最后一次原生采样状态。
  • 包含 0.4.14 的默认播放速度功能。

兼容目标：官方 TikTok 46.3.x，libxposed API 102。

Assets

1

0.4.14

Stable

8/13/2026, 11:49:52 AM

  • 新增默认播放速度：关闭（1.0x）、1.25x、1.5x、1.75x、2.0x。
  • 每条新视频首次渲染后自动应用所选速度。
  • 当前视频内手动修改倍速不会被覆盖。
  • 适配官方 TikTok 46.3.3 播放器接口。

Assets

1

0.4.13

Stable

8/11/2026, 10:07:32 AM

Toki 的首个公开版本，面向 TikTok 46.3.x 与 libxposed API 102。

更新内容

  • Material 3 设置界面、地区搜索和原生媒体目录选择。
  • 内容过滤、下载增强、地区与 SIM 信息伪装。
  • 评论区翻译/还原按钮与跨视频状态保持。
  • 双指长按防烧屏清屏模式。
  • 禁止循环播放，并支持单击重新播放。
  • 可选的 Root 重启 TikTok 操作。

兼容性

  • Android 8.0 及以上
  • TikTok 46.3.x (com.zhiliaoapp.musically)
  • 支持 libxposed API 102 的 LSPosed 实现

APK SHA-256：63B3086D995F4033381F61957C85E1598F7BD5B0E63ADC0D013DD6E382EBB2F7

签名证书 SHA-256：9E7BB3997147529838FEB46A039ADDE66C5500E9BDF24816F09432D6093DDF33

Assets

1