Automatically send TikTok messages to keep your streaks alive!
Streak Saver is an open-source app that automatically sends messages to your TikTok friends on a schedule so you never lose your streaks.
Android is the supported, production-ready platform. An experimental iOS port exists for testing, but it cannot match Android reliability because of Apple platform limits (locked-device Shortcuts failures, no background WebView automation). See docs/ios-limitations.md before installing on iPhone.
- π Automatic Scheduling β Hours-only run interval (1β23 h, default 23 h)
- π₯ Multiple Friends β Add, edit, import, and export your streak list
- π± Background Service β Runs even when the app is closed
- π Smart Notifications β Foreground progress notification while sending; separate completion / offline alert
- π Offline Resilience β If the device has no Wi-Fi or mobile data when an alarm fires, the run is skipped, the user is notified, and a retry is automatically scheduled in 1 hour (no streak slot wasted)
- π Boot Persistence β Automatically reschedules the next run after device restart
- π Cookie-Based Session β Login once via WebView; the captured user agent is reused for every background run so cookies stay valid
- β‘ Battery Optimized β Requests battery-optimization exemption for reliable background execution
- π² Randomized Messages β Optional pool of 50 short built-in streak variants ("streak", "yo streak", "hey", β¦) so you don't always send the same text
- π§ Skip Unreachable β Optional behavior (on by default for new installs) to continue with other friends when a chat cannot be opened
- π Multi-Page UI β Dashboard, Friends, History, and Profile pages with a custom floating nav bar
- π Run History & Stats β Per-run success rate, last-run summary, and exportable run logs
- π¦ In-App Updates β Check for updates from the app; downloaded APKs install via the system installer (FileProvider on Android)
- π Up-to-Date Automation β TikTok WebView automation script maintained for current inbox behavior
- Android: 7.0 (API 24) or higher β recommended for daily streak protection
- iOS: 17.0 or higher β experimental only; see iOS limitations
- TikTok account
- Internet connection
- Go to the Releases page
- Download the latest
StreakSaver-vX.X.X.apk(changelog) - Enable "Install from unknown sources" on your Android device
- Install the APK
Do not rely on iOS for streak protection today. The iPhone build is best-effort only: automations fail on a locked phone, WebView automation cannot run silently in the background, and AltStore certificates expire every ~7 days. Read why β docs/ios-limitations.md
For testing only:
- Add the AltStore source:
https://raw.githubusercontent.com/Jon2G/TiktokStreakSaver/main/dist/altstore/source.json - Install Streak Saver from that source (or sideload the latest
StreakSaver.ipafrom Releases) - Complete in-app onboarding: sign in, read Why iOS is different on Profile, create a daily Shortcuts automation for Maintain TikTok Streaks (when phone is usually unlocked), and allow notifications
- See docs/ios-altstore-release.md to build the release IPA and publish
source.json - See docs/ios-signing.md for signing details and CI
For reliable automatic streak messaging, use Android.
# Clone the repository
git clone https://github.com/Jon2G/TiktokStreakSaver.git
cd TiktokStreakSaver
# Build for Android
cd src/TiktokStreakSaver
dotnet build -f net9.0-android -c Release
# iOS (macOS + Xcode + maui-ios workload) β see src/ios/README.md
cd src/TiktokStreakSaver
dotnet build TiktokStreakSaver.csproj -f net9.0-ios -c Release -r ios-arm64We invested significant effort in an iOS port (Shortcuts App Intents, native WKWebView engine, widget, App Group sharing, MAUI integration). Apple's platform rules still block the core use case:
- Locked iPhone β Shortcuts cannot launch the app; error: Unable to launch because the device couldn't be unlocked
- No silent background β WKWebView JavaScript is suspended when the app is backgrounded; there is no Android-style foreground service for WebView
- Shortcuts-only scheduling β no in-app alarm equivalent to Android's
AlarmManager - Sideload maintenance β AltStore free certificates expire about every 7 days
Use Android for production streak protection. The iOS build remains available for testers who accept these limits.
Full explanation and official Apple documentation links: docs/ios-limitations.md
- Open the app and tap Login Required to sign in to TikTok in the WebView
- Add friends on the Friends page (TikTok username; optional display name)
- Pick a message on the Dashboard: type your own, or enable Randomize messages in Profile to use the built-in variants
- Configure scheduling on the Profile page: enable Background automation and pick a Run interval (1β23 hours)
- Grant permissions when prompted (exact alarms, battery exemption, notifications)
- Use Run Now on the Dashboard for an immediate send, or rely on background automation when scheduled
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Streak Saver β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β β
β [App Start] β Schedule next-run alarm (1β23 h) β
β β β
β [Alarm fires] β AlarmReceiver triggers β
β β β
β [StreakService] β Start foreground service β
β β β
β [Network check] β No internet? Skip + retry in 1 h β
β β β
β [WebView] β Load tiktok.com/messages β
β β β
β [For each friend] β Find chat β Send message β
β β β
β [Complete] β Schedule next run β Stop service β
β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
- .NET 9 MAUI β Cross-platform UI (Android: supported, iOS: experimental port)
- Android WebView β TikTok web automation (Android + iOS)
- AlarmManager (Android) β Exact-alarm scheduling for precise hourly triggers
- Foreground Service (Android) β Reliable background execution with wake-lock
- Shortcuts App Intents (iOS) β User-scheduled automations; requires unlocked device + foreground app
- JavaScript Injection β Web page automation
- Shell + custom FloatingNavBar β Multi-page navigation
TiktokStreakSaver/
βββ src/TiktokStreakSaver/
β βββ Models/ # Data models (FriendConfig, StreakRunResult)
β βββ Services/ # SettingsService, SessionService,
β β # TikTokWebViewHelper, UpdateService
β βββ Pages/ # DashboardPage, FriendsPage,
β β # HistoryPage, ProfilePage
β βββ Views/ # FloatingNavBar + custom drawables
β βββ Platforms/Android/
β β βββ Services/ # StreakService (foreground)
β β βββ Receivers/ # AlarmReceiver, BootReceiver
β β βββ Resources/ # Android resources, splash, themes
β βββ Resources/ # MAUI resources (icons, fonts, styles)
β βββ AppShell.xaml # Multi-tab Shell host (TabBar hidden)
β βββ LoginPage.xaml # TikTok login WebView
β βββ AboutPopupPage.xaml # About / changelog / update modal
βββ .github/workflows/ # CI/CD pipelines (see below)
βββ .github/dependabot.yml # Dependency update PRs (Actions + NuGet)
βββ docs/ # Documentation & screenshots
| Workflow | When it runs | What it does |
|---|---|---|
ci.yml |
Push to main / master, all pull requests, manual |
dotnet build for Android (Debug, no signing) |
android-release.yml |
Git tag v*, manual dispatch |
Signed Release APK, artifact upload, GitHub Release |
On the Profile page, the Run interval stepper sets how many hours to wait after each successful run before the next automatic background run. Allowed range is 1β23 hours, default 23 h (the classic streak window).
On Profile, toggle Randomize messages to send a random short variant from a built-in pool of 50 streak phrases instead of your custom text. The pool is reshuffled when exhausted so a sequence is never repeated within a run.
On Dashboard, the Run Configuration card lets you type any message. The default is:
Hey! Keeping our streak alive! π₯
Contributions are welcome! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
# Prerequisites
- .NET 9 SDK
- Visual Studio 2022 or VS Code with C# extension
- Android SDK (API 24+)
# Install MAUI workload
dotnet workload install maui-android
# Restore and build
cd src/TiktokStreakSaver
dotnet restore
dotnet build -f net9.0-androidThis app is for educational purposes only. Use responsibly and in accordance with TikTok's Terms of Service. The developers are not responsible for any account restrictions or bans that may result from using this application.
Streak Saver does not collect, transmit, sell, or share any personal data. There are no analytics, no advertising, no third-party tracking SDKs, and no developer-owned servers β everything you configure stays on your device. See the full policy in PRIVACY.md.
This project is licensed under the MIT License β see the LICENSE file for details.
- Built with .NET MAUI
- Inspired by the need to never lose a streak again
Special thanks to eulfn (Feener / streak-tiktok)
The current architecture of this app is a direct port of the rewrite that eulfn did in his fork streak-tiktok (project name "Feener"). Massive credit to him and contributors for designing and implementing essentially the entire current UX and most of the stability fixes that ship in this version, including:
- Multi-page architecture β Dashboard / Friends / History / Profile pages hosted in a hidden Shell
TabBar, replacing the original single-page layout - Custom
FloatingNavBarβ Pill-style bottom navigation with active-state indicators - Custom
IDrawables βNormalProgressDrawable(linear daily-progress bar) andSuccessRateDrawable(donut-style success-rate chart) used on Dashboard and History - Theme system β Inter font family registration, expanded color palette (
PrimaryLight,PrimarySubtle, warmOffBlack, semantic gray ramp, card/border tokens), andSectionCard/ typography styles - Android 12+ splash screen β
App.StartingThemewithwindowSplashScreenAnimatedIcon+ theme-aware splash background - WebView viewport fix β Headless WebView targets a 1920Γ1080 CSS viewport so TikTok's virtualized chat list actually renders its lazy children (physical pixels are density-scaled; see RusdiEneri below)
- Session-stored user agent β The user agent captured at login is reused for every background run so TikTok cookies stay valid (with a modern Chrome desktop fallback)
- Cookie-based session helper β
TikTokWebViewHelpercentralizes WebView configuration, cookie checks, and login-status detection - Randomized normal messages β Built-in pool of 50 short streak variants with shuffle / reshuffle-on-exhaust logic
- Bounded per-friend retry β Replaces the original "advance index on null friend" with a retry budget so a transient mismatch doesn't silently skip a friend
OnDestroymutex reset β Safety net so a system-killed service doesn't leave the static_isRunninglock stuck on- Improved automation
tiktok_automation.jsβ Virtualized list scrolling, checkpoint retry logic, exact-username matching, and pre-click extraction - Friends import / export, search, and bulk enable / disable UI on the Friends page
- Run history with success-rate stats and exportable run logs on the History page
- Profile page consolidating account, display name / photo, settings toggles, and the explicit Check for updates button
- CSS-style
Focusedvisual states onEntryandEditor, andAndroidhandler mappers that strip the default Entry/Editor underline
If you like the look and feel of this app, please go star the upstream fork as well: https://github.com/eulfn/streak-tiktok.
Thanks to RusdiEneri
The custom-scheme login guard and the inbox/viewport fixes that address the βapp closes after loginβ and βfriend skippedβ reports are ported from RusdiEneri/TiktokStreakSaver commit cca1651:
- Block
snssdk:///intent://navigations during login and reload the embeddedparams_urlwhen it is a normal web URL - Create the background messages WebView on the UI thread and size it in density-scaled pixels
- Tighter chat-list selectors and a longer empty-inbox wait
- Auto-disable a missing friend only after three failed runs
His release-signing workflow changes were not adopted.
Made with β€οΈ and π₯
