<div align="center"> <img src="fastlane/metadata/android/en-US/images/featureGraphic.png" alt="feature graphic plug brain"/>

</div> <img src="assets/plugbrain_example.gif" align="right" width="320" />

PlugBrain

PlugBrain is an app that encourages regular breaks from distracting apps by blocking access at scheduled intervals. To regain access, you’ll need to solve a math challenge that adjusts in difficulty: the more frequently you use the apps, the harder the challenges become, but the longer you stay away, the easier they get.

[!IMPORTANT] We're currently working on a new UI redesign based on a Figma design to make the app more modern and intuitive. Huge thanks to @HichemDahaoui for the amazing design work, and to @travis-jeans for the new app icon.

Features

• Blocks distracting apps
• Unblock apps by solving math challenges
• Difficulty increases with frequent use, decreases with focus
• No tracking, no ads
• No internet required

How to use

• Grant all required permissions
• Select distracting apps
• Choose your focus frequency
• Select minimum starting difficulty
• Stay focused ;)

<div align="center"> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/1.png" alt="Screenshot 1" width="30%" /> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2.png" alt="Screenshot 2" width="30%" /> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.png" alt="Screenshot 3" width="30%" /> </div>

Download

<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="80"> <img src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png" alt="Get it on IzzyOnDroid" height="80"> <img src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" alt="Get it on Play Store" height="80"> <img src="https://user-images.githubusercontent.com/663460/26973090-f8fdc986-4d14-11e7-995a-e7c5e79ed925.png" alt="Get it on GitHub" height="80"> <img src="https://www.openapk.net/images/openapk-badge.png" alt="Get it on OpenAPK" height="80"> <img src="https://www.androidfreeware.net/images/androidfreeware-badge.png" alt="Get it on AndroidFreeware" height="80">

Contributing

Want to contribute? Follow these quick steps:

1. Fork this repository
2. Clone your fork
3. Create a new branch
4. Make your changes
5. Commit your changes
6. Push to the branch
7. Open a pull request
8. Make sure the CI pass

Tech stack

PlugBrain is built using modern Android libraries and tools:

• 100% Kotlin
• Jetpack Compose as UI toolkit
• Kotlin Coroutines & Flow for asynchronous.
• Koin for Dependency injection
• Architecture
  • MVVM Architecture (Declarative View - ViewModel - Model)
  • Repository pattern
• DataStore – Storage for user preferences
• Lifecycle – ViewModel and lifecycle-aware components
• Material 3 – Material Design components
• Coil – Image loading for Android
• UsageStatsManager for app usage tracking
• JUnit – Unit testing
• MockK – Mocking library
• Timber – Logging
• Ktlint – Kotlin code style checking
• GitHub Actions – CI/CD for builds, tests, and releases
• Paparazzi - Screenshot testing

License

GNU GPLv3

Community

We'd love to hear your use cases, success stories, and feedback.

• Reddit
• GitHub Discussions