Skip to content

nethical6/curbox

Repository files navigation

Curbox

GitHub contributors Discord Server Telegram Group

Curbox (formerly Digipauwse) is a powerful open source utility for Android built to help you reclaim your time and master your digital habits. It provides a suite of tools designed to break the cycle of screen addiction through granular control and deep insights.

Screenshots

Click on any image to enlarge it.

Why Curbox Stands Out

Most screen time tools are closed source and require internet access. This raises concerns about your private usage data being tracked or sold. Curbox takes a different path.

  • All screen time apps use a powerful Android feature (Accessibility service) that lets them see everything you do, including your private messages. They all connect to the internet, posing a severe security threat. Curbox uses this same feature, but it does not have internet access (it doesn't declare the permission in the manifest). This means your personal data can never leave your phone, keeping it completely private and secure.
  • Open Source Transparency The entire codebase is public. Anyone can verify how the app works. This ensures there are no hidden trackers or malicious behaviors. Open source doesn't mean anyone can see how you use the app.
  • Respect for Your Data Because there is no cloud connection, you are the sole owner of your statistics. There are literally a few companies selling your usage insights for millions so the algorithm can be further strengthened to keep you trapped.

Independent Reviews & Endorsements

Please open an issue if your review is not included, Thank you so much!

In-Depth Feature Analysis

Curbox goes beyond simple app timers. It targets the specific triggers that lead to mindless scrolling.

Blocking & Control

  • App & Website Blocking: Block distracting apps and websites completely.
  • Short-Form Content Blocker: Specifically target Instagram Reels and YouTube Shorts.
  • Granular UI Hiding: Block specific parts of an app's UI (e.g., block the entire YouTube home feed while allowing searches or hide instagram feed while allowing posts and messages from friends).
  • URL Path Blocking: Block specific sections of a website (e.g., block m.youtube.com/shorts/* but allow m.youtube.com).
  • Automatic Redirection: Automatically redirect to a different website when a blocked website is accessed.

Insights & Awareness

  • Usage Analytics: Detailed insights into app and website usage.
  • Focus Statistics: Track your progress and focus sessions.
  • Live Scroll Counter: See a real-time count of how many short-form videos you've scrolled through.
  • Session Timer: A live timer showing how much time has elapsed since you opened the app.

Mindful Usage Tools

  • Focus Mode: Temporarily pause apps and websites to stay focused on your work.
  • Scheduled DND: Schedule Do Not Disturb to turn on automatically.
  • App-Specific Grayscale: Apply a grayscale filter only to specific apps (e.g., Instagram) while keeping others (e.g., Camera) in color.
  • Usage-Based Limits: Block apps or websites based on usage (e.g., block WhatsApp after 1 hour of use).
  • Time-Based Access: Allow apps only during specific hours (e.g., WhatsApp only between 7 AM and 9 PM).
  • Home Screen Widgets: Quick access to your stats and controls right from your home screen.

Unlock Mechanisms

Define what happens when you try to open an app outside its allowed schedule:

  • Strict Blockade: Complete blockade with no access.
  • Timed Unlocks: Predefine a short duration (e.g., 5 mins) for each subsequent unlock.
  • Dynamic Selection: Choose the duration of your temporary unlock on each attempt.
  • QR/Barcode Unlock: Requires scanning a physical QR code or barcode (e.g., from product boxes like books) to unlock. Spread them across your home to force physical movement!
  • Sentence Retyping: Requires physically typing a specific sentence (e.g., "I am giving up on my goals to use this app right now") to unlock.
  • Unlock Limits: Set how many subsequent unlocks you can perform every X hours.

How to install

App can be downloaded from GitHub Releases

Contributing

We welcome contributions from the community! If you want to help improve Curbox, please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bugfix.
  3. Commit your changes with a clear message.
  4. Push to your branch.
  5. Create a new Pull Request.

Developing for accessibility services and blockers is complex. It requires understanding how different apps structure their views. We appreciate any help in discovering new ways to block distracting content. Please don't open a PR if you "vibe code" and have no idea what you're doing or what the code does. Preferably, just open an issue with the feature request.

Please read the CONTRIBUTING.md file before working on the project or learning how to make quick contributions like adding support for a modded app in the reel counter, adding support for a new browser, etc.

Special Thanks

  • All my beloved donors and sponsors
  • Digipaws: Inspiration for the entire code structure and working mechanism
  • Usage Direct: For help with app usage statistics.
  • Redd Focus: For the foundation of the view blocker system.
  • ShizuTools: For Shizuku runner implementations.
  • MPAndroidChart: For the beautiful graphs and charts.

License

Curbox is licensed under the GPL 3 or later license. You are free to use, modify, and distribute this software in accordance with the license.

Contact

For questions or feedback, please open an issue on the GitHub repository or reach out:

Sponsor this project

Contributors

Languages