tikutils

gtk4/libadwaita tiktok analytics & lossless stream patcher for linux

---

requirements

• python 3.10+
• ffmpeg & yt-dlp (in $PATH)
• gtk4 & libadwaita

usage

git clone https://github.com/buwryme/tikutils.git
cd tikutils
chmod +x setup.sh; ./setup.sh

run tikutils from your terminal or app grid.

features

• analyzer: fetch metadata, stats, and resolve unwatermarked origin urls.
• patcher: re-encodes to h.265/h.264 crf 18 and patches mp4 structure to force tiktok passthrough.
• downloader: native save dialogs with progress tracking.
• maximum format: supports up to 4K@60 FPS! check out this test video

how it works

1. encodes video using constant rate factor (crf) for consistent quality.
2. inflates audio stsz table to create a structural mismatch.
3. strips tmcd/tref tracks and normalizes handler names.
4. injects custom metadata and trailing dummy bytes.

tiktok's transcoders choke on the mismatch and skip re-encoding. mobile decoders ignore it and play normally.

---

works as of aug 2026. use responsibly

for inquiries contact @buwryy on discord

made with ♥ by buwryme