Skip to content

nethical6/digipaws

Repository files navigation

DigiPaws

GitHub contributors Discord Server Telegram Group Repository Size Total downloads

Copylefted libre software solving screen addiction by regulating and gamifying app usage. Easy, Adventure, and Hard modes — each with features and challenges for healthy screen-time habits.

Important

This project is being re-written in Kotlin with a new UI

Caution

This project is experimental and not yet quite ready. Donate

Caution

If stuck and unable to uninstall the app, it is possible via the safe mode. ]How to enter safe mode

Features

  • Three Unique Modes: Easy, adventure, or hard.
  • Gamified Challenges: Earn Aura through quests like walking to unlock blocked-app usage.
  • Open Source: Fully transparent and gratis. Source code and contributions.
  • Productivity Enhancement: Healthier digital habits and reduced screen addiction.
  • Versatile Blockers: Blocking apps, keywords, and unwanted in-app screens (e.g., YouTube shorts, comments).
  • Open API: Turn your existing apps into a quest. Learn More

Screenshots

Click on any image to enlarge it.

Modes

Easy Mode

Genntle reminders repeated to keep you honest.

Adventure Mode

The slop is in the immediacy of a quick km walk away, which might be a safe distance.
Requires Aura earnt through quests to access a blocked app for 20 min. With every quest, the difficulty rises.

Quests

  1. Touch Grass — Displace yourself out of the red zone on map. Verified using GPS.
  2. Squats — Simply perform squats. Verified using AI.
  3. Pushups — Simply perform pushups. Verified using AI.
  4. Focus Quest — Apply the 90/20 study rule: Only basic productivity apps like calling and SMS.
  5. Open API — Learn how to use our API

Important

A custom time can be set for focus quest in hard- or easy mode.

Hard Mode

Prevents use of blocked apps altogether.

Variants

There are two build variants with different features:

  • fullMode: Contains additional inbuilt quests like touch grass, and workout. Requires google play services. Download
  • liteMode: Reduced size. (same as the F-Droid version) Contains a bare version without additional quests except focus quest.
    Relatively smaller in size and doesn't require Google Play services.

Note that the quest API works with both variants

Configuring

  1. Launch DigiPaws.
  2. Grant necessary permissions like accessibility, notification, draw over other apps, etc.
  3. On Android 13+ devices, additionally allow restricted settings before turning on the accessibility permission. Watch a tutorial here
  4. Choose your preferred mode: Easy, adventure, or hard.
  5. Pick apps and views to block and set your preferences.
  6. Enjoy life and managed screen-time.

Tip

This app relies on sensitive accessibility services to function.
Avoid downloading it from untrusted sources.

ToDo

  • Block reels.
  • Block comments.
  • Block explicit context.
  • App blockers.
  • Focus quest.
  • Anti-uninstall.
  • Customisable warning screen.
  • API for other developers to transform their existing apps into quests!
  • Geo-blocker (basically block things when a certain area is entered, like workplace).
  • Block cusomtom user defined keywords.
  • Modular and downloadable view blockers.
  • Expand the app to ios and desktop.

Thanks

  • Osmdroid : Map view used in Quest "TouchGrass"
  • Digital Wellbeing Experiments Toolkit : some ideas ig, basically the geoblocker one.
  • Undraw : Illustrations on the intro page
  • Special thanks to all the premium apps that inspired me to create a copylefted libre alternative, gratis.
    Imagine making money on the misery of people.
  • Ml Kit QuickStart : ML models and multiple classes were used from this repository.

Contributing

Contributions welcome. Please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bugfix.
    git checkout -b feature/your-feature-name
  3. Commit your changes.
    git commit -m "Add some feature"
  4. Push to the branch.
    git push origin feature/your-feature-name
  5. Create a new pull request.

Please ensure your code adheres to the coding standards and includes relevant tests.

Contributors

  • Henry Delallal: assisted in setting up the F-Droid version
  • Remaker17: setting up workflow files
  • Error 404: helped reach a larger audience

HELP REQUIRED!!

  1. Implementing dyanimic colors inside the warning overlay.
  2. Expanding the list of explict keywords
  3. Expanding the list of Blocked view items so that more apps can be supported. You can scrape the view IDs of a screen with the help of Developer Assistant. Remeber these view IDs must be unique and only present on the screen to block!
  4. Adding more info about other packages here

License

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

Contact

For questions, suggestions, or feedback, please open an issue on the GitHub repository or get in contact at:

  1. Discord: @nethical
  2. Telegram: @nethicalps

Thank you for using DigiPaws! Together, we create healthier habits.