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.

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

Download

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

License

GNU GPLv3

Community

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

• Reddit
• GitHub Discussions