Skip to content

About

Streak Saver is an open-source Android app that runs in the background and automatically sends messages to your TikTok friends every 23 hours, ensuring you never lose your streaks.

Resources

Stars

65 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

100 Commits

Folders and files

Repository files navigation

Streak Saver app icon

πŸ”₯ Streak Saver

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.

Streak Saver Main Screen

✨ Features

  • πŸ• 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

πŸ“‹ Requirements

  • 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

πŸ“₯ Installation

Option 1: Download APK (Recommended)

  1. Go to the Releases page
  2. Download the latest StreakSaver-vX.X.X.apk (changelog)
  3. Enable "Install from unknown sources" on your Android device
  4. Install the APK

iOS (AltStore) β€” experimental, not recommended

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:

  1. Add the AltStore source: https://raw.githubusercontent.com/Jon2G/TiktokStreakSaver/main/dist/altstore/source.json
  2. Install Streak Saver from that source (or sideload the latest StreakSaver.ipa from Releases)
  3. 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
  4. See docs/ios-altstore-release.md to build the release IPA and publish source.json
  5. See docs/ios-signing.md for signing details and CI

For reliable automatic streak messaging, use Android.

Option 2: Build from Source

# 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-arm64

⚠️ iOS: experimental β€” not ready for production

We 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

πŸš€ Getting Started

  1. Open the app and tap Login Required to sign in to TikTok in the WebView
  2. Add friends on the Friends page (TikTok username; optional display name)
  3. Pick a message on the Dashboard: type your own, or enable Randomize messages in Profile to use the built-in variants
  4. Configure scheduling on the Profile page: enable Background automation and pick a Run interval (1–23 hours)
  5. Grant permissions when prompted (exact alarms, battery exemption, notifications)
  6. Use Run Now on the Dashboard for an immediate send, or rely on background automation when scheduled

βš™οΈ How It Works

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                      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              β”‚
β”‚                                                             β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ› οΈ Tech Stack

  • .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

πŸ“ Project Structure

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

Continuous integration

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

πŸ”§ Configuration

Run interval

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).

Randomized messages

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.

Custom message

On Dashboard, the Run Configuration card lets you type any message. The default is:

Hey! Keeping our streak alive! πŸ”₯

🀝 Contributing

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Development Setup

# 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-android

⚠️ Disclaimer

This 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.

πŸ”’ Privacy

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.

πŸ“„ License

This project is licensed under the MIT License β€” see the LICENSE file for details.

πŸ™ Acknowledgments

  • 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) and SuccessRateDrawable (donut-style success-rate chart) used on Dashboard and History
  • Theme system β€” Inter font family registration, expanded color palette (PrimaryLight, PrimarySubtle, warm OffBlack, semantic gray ramp, card/border tokens), and SectionCard / typography styles
  • Android 12+ splash screen β€” App.StartingTheme with windowSplashScreenAnimatedIcon + 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 β€” TikTokWebViewHelper centralizes 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
  • OnDestroy mutex reset β€” Safety net so a system-killed service doesn't leave the static _isRunning lock 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 Focused visual states on Entry and Editor, and Android handler 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 embedded params_url when 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 πŸ”₯

About

Streak Saver is an open-source Android app that runs in the background and automatically sends messages to your TikTok friends every 23 hours, ensuring you never lose your streaks.

Resources

Stars

65 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages