ttpkUnpacker
A Python unpacker for Douyin (TikTok China) mini-program TPKG packages (.pkg/.ttpkg.js): one-click project structure with ttss/ttml extraction — the Douyin counterpart to WeChat wxapkg tools.
Try it now
GPT-4oWhat is ttpkUnpacker?
ttpkUnpacker targets Douyin mini-programs rather than WeChat: it handles packages whose header starts with TPKG, supporting both .pkg and .ttpkg.js files. With a single command it generates the project structure and extracts ttss (styles) and ttml (markup) files, with partial sjs parsing. It is written in Python and only needs the esprima package (`pip install esprima`); the CLI takes an input file or folder and an output folder, and can batch-process every .pkg in a directory. The README documents how to obtain packages from a rooted Android device (or emulator) using MT Manager under the Douyin launchcache path, identifying the newest app by .meta. Note it currently does not support Douyin mini-GAMES. A Gitee mirror is provided for users in China. For authorized learning and research only.
Pros
- Fills the niche of Douyin (not WeChat) package unpacking.
- Very simple CLI with minimal dependencies.
- Batch-processes a whole folder of packages.
- Documents how to pull packages from a device.
- Free and open source (GPL-3.0).
Cons
- Narrow scope: Douyin mini-programs only, no mini-GAME support.
- sjs parsing is partial and unfinished.
- Requires a rooted device/emulator to obtain packages.
- Less actively polished than the major WeChat tools.
Compare with Alternatives
| Feature | ttpkUnpacker | MediaCrawler | wedecode | KillWxapkg |
|---|---|---|---|---|
| Rating | 0.0 | 4.4 | 0.0 | 0.0 |
| Pricing | Free | Free | Free | Free |
| Starting From | — | Free | — | — |
| API | — | — | — | — |
| Free Tier | — | — | — | — |
| Mobile App | — | — | — | — |
Who is it for
Douyin ecosystem devs
Study how Douyin mini-program packages are structured.
Security researchers
Audit an authorized Douyin mini-program.
Reverse engineers
Extract styles and markup from TPKG packages.
Learners
Compare Douyin TPKG vs WeChat wxapkg formats.
Batch analysts
Unpack many captured .pkg files in one run.