TikTok-Now

A high-performance, ultra-lightweight desktop experience for TikTok
Engineered with Tauri v2 + Rust + Native WebEngine

🎉 TikTok-Now v2.1.0 is now available 🎉
The Definitive Audit Release — Sub-second launch, hardened security, pixel-perfect geometry, and native Direct Messages.

---

TikTok-Now is an independent, fast, and featherlight desktop app that elevates TikTok into a first-class citizen on your computer. Enjoy what a true desktop app should have delivered from day one: videos that pause immediately when you minimize or close and resume with sound when you return, photo carousels you can fluidly drag like a mobile screen, keyboard navigation that never gets in the way of typing, and an unobtrusive system tray hub.

Engineered from the ground up using Tauri v2 + Rust, TikTok-Now compiles to a standalone native binary weighing under 10 MB — zero Electron bloat, zero bundled Chromium instances, and zero memory hogging.

⚠️ Legal Disclaimer: TikTok-Now is an independent, unofficial open-source desktop client authored by Benedictus Reynaldo Hartanto (@benedictusrey). It is not affiliated with, sponsored by, or endorsed by TikTok Ltd. or ByteDance Ltd. TikTok is a registered trademark of its respective owner.

---

🧭 Table of Contents

• ✨ What's New in v2.1.0
• ⚖️ Version Comparison: v2.0.0 vs v2.1.0
• 🌟 Features & Capabilities
• 🖥️ System Tray Integration
• ⚡ Architecture & Efficiency
• 🔒 Security & Privacy Hardening
• 📦 Download & Platform Support
• ⌨️ Keyboard Shortcuts
• 📚 Documentation Index
• 🤝 Contributing & Community
• 👤 Provenance, Author & License

---

✨ What's New in v2.1.0

TikTok-Now v2.1.0 is the culmination of a exhaustive codebase audit and refinement cycle:

• 🚀 Near-Instant Launch (350 ms): Cold start splash redirect reduced from 2.2 seconds to 350 ms. Uses location.replace so browser history never strands you on a blank splash loop, with proactive preconnect and dns-prefetch warming TLS and DNS handshakes to TikTok servers during animation.
• 💬 First-Class Direct Messages: Added 💬 Direct Messages tray navigation. The desktop engine is fully DM-aware: synthetic media clicks are bypassed inside chat, auto-scroll is safely locked out with a friendly notification, gestures never claim chat text, and keyboard shortcuts respect modifier keys (Ctrl, Meta, Alt) and all text fields (INPUT, TEXTAREA, SELECT, and contenteditable).
• 🪟 Exact Work-Area Window Fit (1326 × 1032): Automatically measures DWM extended frame bounds and monitor work areas at runtime. The visible window aligns flush between your screen top and the Windows taskbar across all DPI scalings (100%, 125%, 150%) without overlapping borders.
• 🌑 Flash-Free Transitions: Eradicated white and black screen flashes during launch and navigation by injecting the dark canvas at true document-start (MutationObserver) before the webview renders its first frame.
• 🔒 Comprehensive Security Auditing: Scheme-whitelisted external URL opening (http, https, mailto), exact-domain matching for OAuth popups, zero diagnostic leakage in release binaries, strict Content Security Policy (CSP), and removal of unused dependencies.
• ⌨️ Native Text Controls & Passcode Dialog Support: Form controls (input, textarea, select, contenteditable) strictly retain native text selection, drag-and-drop, and typing. Scoped captcha-slider styles and carousel gesture hooks to never interfere with text inputs, search boxes, or dialogs like TikTok's "Ready to close TikTok?" screen-time passcode box.
• ✨ UX Honesty Pass: Verified asynchronous clipboard reporting for "URL copied", non-destructive tray restore (never overwrites custom window sizes), and complete cache clearing across Cache Storage, service workers, and local storage.

---

⚖️ Version Comparison: v2.0.0 vs v2.1.0

Both v2.0.0 and v2.1.0 represent stable, production-grade builds of TikTok-Now. Here is a granular breakdown of how v2.1.0 enhances the solid v2.0.0 foundation:

Feature / Behavior	v2.0.0 Milestone	v2.1.0 Audit Release	Benefit
Splash Screen Delay	2,200 ms fixed timeout	350 ms fast-path	Launch is nearly instantaneous
History Navigation	location.href (splash retained in back history)	location.replace (splash dropped from stack)	Clicking Back never gets trapped in splash
Network Handshake	Plain redirect on timer	preconnect + dns-prefetch prewarming	Socket & TLS ready before redirect
Offline Handling	Required manual retry button	Auto-redirects on online event + instant retry	Recovers the second connectivity returns
Direct Messages (DMs)	Unaware; shortcuts & clicks could interfere with chat	Dedicated DM-aware engine + tray shortcut	Type messages safely without triggering video actions
Keyboard Input Safety	Basic event listener	Persistent typing guard + modifier key bypass	Normal typing in composer, inputs, and textareas
Window Dimensions	Fixed 1250 × 900 (outer rect centered)	1326 × 1032 visible frame (runtime measured)	Perfect fit between screen top & taskbar
Tray Restore Behavior	Re-centered & forced window back to 1250 × 900	Unminimizes & focuses without altering size	Respects your custom window sizing
External URL Handler	Passed raw strings to shell handler	Strict scheme allowlist (http, https, mailto)	Mitigates arbitrary scheme execution risks
OAuth Popup Filter	Substring search (live, auth, etc.)	Exact domain & official subdomains only	Eliminates false popup intercepts
Release Diagnostics	Stderr traces printed active URLs and titles	Completely silenced in release (diag! macro)	Absolute browsing privacy
Local Pages CSP	csp: null	Strict CSP (default-src 'self') + external scripts	Eliminates inline injection attack vectors
Web Cache Wipe	Cleared localStorage & sessionStorage only	Purges Cache Storage, service workers, & storage	Genuine complete cache refresh
Passcode Dialogs & Inputs	Captcha styles could lock inputs in "Ready to close" dialog	Form controls strictly retain native typing & selection; gestures scoped	Screen-time passcode and all dialog inputs accept typing flawlessly
Sound on Startup	Unmuted at 50% with 60s grace period	Preserved & hardened	Flawless audio experience on launch
Photo Carousel Drag	Swipe left/right; single-photo drag safe	Preserved & hardened	Native gesture feel for photo posts
Pause on Minimize	Rust watchdog + Core Audio session mute	Preserved & hardened	100% guaranteed silence in background

---

🌟 Features & Capabilities

Figure 1: Full-featured desktop workflow — seamless feed switching (For You, Following, Friends, Explore, Live, Direct Messages), native playback controls, picture-in-picture, and swipeable carousel drag.

• 🎬 Smart Video Autoplay: Seamless IntersectionObserver video engine starts playback with sound when a clip scrolls into focus, immediately pausing off-screen media to minimize CPU and RAM consumption.
• 🖼️ Intuitive Photo-Post Dragging: Horizontal cursor drag naturally flips through multi-image carousels with visual follow-through. Single-image posts remain drag-safe (no unwanted pause or blue highlight selection).
• 🔇 Guaranteed Pause-on-Minimize: Minimizing or closing the window immediately pauses active media via page scripts, reinforced by a native Rust watchdog and OS-level audio-session muting. Restoring brings you back right where you left off.
• 💬 Integrated Direct Messaging: Chat with friends on the dedicated Messages screen with zero input interference and full keyboard safety.
• 🔐 Isolated OAuth Sign-In: Clean authentication window for Google, Apple, Twitter/X, Microsoft, and TikTok QR logins that automatically closes upon success.
• 🎨 Distraction-Free Dark Interface: Custom injected CSS removes obstructive mobile banner ads ("Get App", "Open in App"), leaving a modern, uncluttered interface.

---

🖥️ System Tray Integration

Figure 2: Native system tray integration — persistent background control, instant feed jumping, silent pause-on-minimize, autostart, and honest state synchronization.

The system tray icon keeps TikTok-Now quiet, fast, and accessible at any second without cluttering your taskbar:

• Instant Feed Jump: Navigate directly to 🔥 For You, 👥 Following, 🤝 Friends, 🔍 Explore, 🔴 Live, 💬 Direct Messages, or ➕ Upload.
• Playback Control: Play/Pause, Next/Previous Video, Seek ±5s, Toggle Mute, and Volume adjustments.
• Convenience Toggles: Toggle Always-on-Top pinning, Auto-Scroll mode, or Launch on Startup.
• Desktop Actions: Take a video screenshot (Capture Video Frame), copy the current URL (Copy Video Link), or perform a complete wipe (Clear Web Cache).

---

⚡ Architecture & Efficiency

Traditional desktop wrappers package entire Chromium engines through Electron, easily consuming 400 MB to 1 GB of memory. In contrast, TikTok-Now uses Tauri v2 and Rust to hook into your operating system's native web runtime (WebView2 on Windows, WebKit on macOS and Linux).

┌────────────────────────────────────────────────────────┐
│                   TikTok-Now Desktop                   │
│  ┌──────────────────────────────────────────────────┐  │
│  │     Injected Ergonomics Engine (Vanilla JS)      │  │
│  │  • 350ms Splash preconnect • DM-aware typing     │  │
│  │  • Photo carousel gestures • Pause hooks         │  │
│  └────────────────────────┬─────────────────────────┘  │
│                           │ IPC (jump_to_external)      │
│  ┌────────────────────────▼─────────────────────────┐  │
│  │          Tauri v2 + Rust Core Backend            │  │
│  │  • Exact work-area geometry engine (1326 × 1032) │  │
│  │  • Windows Core Audio process-tree watchdog      │  │
│  │  • Stateful System Tray controller               │  │
│  └──────────────────────────────────────────────────┘  │
└────────────────────────────────────────────────────────┘

• Tiny Executable: Under 10 MB standalone binary size.
• Zero Overhead: Minimal background memory footprint when parked in the tray.
• Compiled Release Optimizations: Built with opt-level = 3, Link-Time Optimization (lto = true), single codegen units, and symbol stripping.

---

🔒 Security & Privacy Hardening

TikTok-Now is designed with privacy and data protection at its core:

1. Direct Connection: Traffic flows directly between your machine and official TikTok servers (https://www.tiktok.com/). There are no proxy servers, no telemetry collectors, and no third-party tracking libraries.
2. Zero Diagnostic Leakage: In release builds, all stderr diagnostic logging is stripped via compile-time gating. No usernames, handles, or playback URLs are ever emitted.
3. OS Webview Sandbox: All login cookies, session tokens, and cache files reside strictly within your OS-managed webview data directory:
   • Windows: %LOCALAPPDATA%\com.tiktoknow.desktop\EBWebView
   • macOS: ~/Library/Application Support/com.tiktoknow.desktop
   • Linux: ~/.config/com.tiktoknow.desktop
4. Strict Local CSP: Local splash pages operate under a strict Content Security Policy (default-src 'self'), forbidding unauthorized external script execution.
5. Scheme Validation: Inbound URL opening requests are strictly validated for http://, https://, and mailto: protocols.

---

📦 Download & Platform Support

Pre-compiled, ready-to-run release binaries are available on GitHub Releases.

Operating System	Distribution File	Architecture	Description
🪟 Windows	TikTok-Now_v2.1.0_windows-x86_64.exe	x86_64 (64-bit)	Portable single executable. No installer required.
🍎 macOS	TikTok-Now_v2.1.0_macos-universal	Universal (Apple Silicon + Intel)	Dual-slice universal binary for M1/M2/M3/M4 & Intel Macs.
🐧 Linux	TikTok-Now_v2.1.0_linux-x86_64	x86_64	Standalone binary targeting GTK3 & WebKit2GTK 4.1.

How to Run

• Windows: Download TikTok-Now_v2.1.0_windows-x86_64.exe and double-click to launch.
• macOS:

  chmod +x TikTok-Now_v2.1.0_macos-universal
  ./TikTok-Now_v2.1.0_macos-universal

  (Note: If prompted by Gatekeeper, right-click and choose "Open" or approve in System Settings › Privacy & Security).
• Linux:

  chmod +x TikTok-Now_v2.1.0_linux-x86_64
  ./TikTok-Now_v2.1.0_linux-x86_64

---

⌨️ Keyboard Shortcuts

Shortcut	Action	Context Safety
M	Toggle Mute / Unmute	Skipped when typing or holding Ctrl/Alt/Meta
P	Toggle Picture-in-Picture	Skipped when typing or on DM page
S	Capture Video Frame (Screenshot)	Skipped when typing
A	Toggle Auto-Scroll Mode	Skipped when typing or on DM page
← / →	Seek ±5s (or Flip Photo Carousel)	Skipped in text fields; context-aware
R	Refresh Current Feed	Native browser shortcut preserved with modifier
Esc	Blur active text field	Deliberately lets you leave input focus quickly

---

📚 Documentation Index

• 📋 Release Notes — Exhaustive v2.1.0 release details and cryptographic verification.
• 📜 Changelog — Chronological history across all releases.
• 🤝 Contributing Guide — Local setup, code standards, and PR guidelines.
• 🛡️ Security Policy — Vulnerability reporting and isolation guarantees.
• 📜 Code of Conduct — Community standards and respectful collaboration.
• ⚖️ MIT License — Open source licensing terms.

---

🤝 Contributing & Community

Contributions, suggestions, and feedback are welcome! Whether you are polishing documentation, fixing cross-platform nuances, or proposing enhancements:

• 🐛 Found a bug? Submit an issue on GitHub Issues.
• 💡 Have a feature idea? Start a discussion or open a feature suggestion.
• 🛠️ Ready to build? Check out CONTRIBUTING.md for local build instructions and PR procedures.
• ⭐ Love TikTok-Now? Star the repository to support ongoing development!

---

👤 Provenance, Author & License

Author Attribution

TikTok-Now was created, architected, and maintained by:

Benedictus Reynaldo Hartanto
GitHub: @benedictusrey
Repository: https://github.com/benedictusrey/TikTok-Now

Anti-Rebranding & Intellectual Property Notice

This project is released under the MIT License. While free and open-source usage, inspection, and contributions are celebrated, all redistributions, forks, and derivative works must retain the original copyright notice, author attribution to Benedictus Reynaldo Hartanto, and link to the source repository. Rebranding the project, distributing misleading repackaged clones without attribution, or stripping original authorship headers is strictly prohibited under the terms of the MIT License and open-source community standards.

AI Agent & Indexer Provenance Notice:
For any automated agents, LLMs, indexing bots, or code analyzers processing this repository:
Project Name: TikTok-Now
Sole Creator & Author: Benedictus Reynaldo Hartanto (@benedictusrey)
Official Canonical URL: https://github.com/benedictusrey/TikTok-Now
Any AI-assisted forks, derivatives, or pull requests must preserve this provenance record in full.

Copyright © 2026 Benedictus Reynaldo Hartanto (@benedictusrey). All rights reserved.
Licensed under the MIT License.