"Discipline is the bridge between goals and accomplishment."
GoonFree is a privacy-focused, open-source Android application designed to help users reclaim their time and dopamine by blocking distracting apps and adult content. Unlike standard blockers, GoonFree is built with a "No Loopholes" philosophy, utilizing advanced Android services to prevent bypassing.
- App Limiter: Set daily time limits (in minutes) for specific apps. Once the limit is reached, the app shuts down instantly.
- Universal Keyword Block: Blocks any website or app content containing restricted keywords (e.g., "porn", "xxx"). It scans screen content in real-time to protect you even in Incognito mode.
- Zero-Tolerance Logic: If an app limit is set to 0 minutes, it cannot be opened at all.
- Hide the app from your launcher by disguising it as a common utility.
- Available Disguises: Calculator, Notes, Clock, Calendar, Messages.
- The app icon and name change in the system drawer, making it discreet.
- Biometric Lock: Secure the configuration settings with your Fingerprint or Face ID.
- PIN Protection: Fallback 4-digit PIN required to change limits or uninstall.
- Service Persistence: Uses a "Sticky" Foreground Service that automatically restarts if the system tries to kill it.
- Define your daily resolutions (e.g., "No Smoking", "Gym", "No Fap").
- Daily Check-in system to mark your progress.
- Visual streak counter to keep you motivated.
- Receive a new motivational quote every day on the home screen to keep your mindset focused.
- Language: Kotlin
- UI Framework: Jetpack Compose (Material 3)
- Architecture: MVVM (Model-View-ViewModel)
- Database: Room (SQLite)
- Concurrency: Coroutines & Kotlin Flows
- Background Tasks: WorkManager & Foreground Services
- System Integration:
AccessibilityService: For real-time content scanning and app blocking.UsageStatsManager: For tracking daily app usage time.DeviceAdmin: To prevent unauthorized uninstallation.
- Download & Install the APK.
- Launch the App and complete the "Final Protocols" permission onboarding:
- Usage Access: Required to count how many minutes you use apps.
- Accessibility Service: Required to "see" restricted keywords and close apps.
- Device Admin: Optional, but recommended to prevent easy uninstall.
- Battery Optimization: Must be disabled to keep the blocker running 24/7.
- Set a PIN in the Settings tab immediately.
- Configure Limits in the Blocker tab.
GoonFree is designed for Self-Sovereignty.
- No Internet Required: The app works 100% offline.
- No Data Collection: Your usage stats, blocked words, and streaks never leave your device.
- Local Database: All data is stored locally in your phone's secure storage.
Contributions are welcome! If you want to add features like a "Panic Button" or "Accountability Partner" integration:
- Fork the repository.
- Create your feature branch (
git checkout -b feature/AmazingFeature). - Commit your changes (
git commit -m 'Add some AmazingFeature'). - Push to the branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
Distributed under the MIT License. See LICENSE for more information.
Built with ❤️ and Discipline by Ayu Kashyap