Skip to content

Instantly share code, notes, and snippets.

@vishal-nagarajan
Created January 2, 2026 12:06
Show Gist options
  • Select an option

  • Save vishal-nagarajan/49fe9ceff9b9a8706438b9dddc07a427 to your computer and use it in GitHub Desktop.

Select an option

Save vishal-nagarajan/49fe9ceff9b9a8706438b9dddc07a427 to your computer and use it in GitHub Desktop.

DeepWatch User Guide

Introduction

DeepWatch is an Android app designed to help you regain control over your attention by blocking short-form video content across popular social media apps. Instead of mindlessly scrolling through endless videos, DeepWatch gives you a moment to pause and reflect before continuing.

Why DeepWatch?

Short-form video content is designed to be addictive:

  • Average users spend 2.5 hours daily on short-form video apps
  • Each scroll triggers dopamine, creating reward loops that are hard to break
  • It takes 23 minutes to regain focus after being distracted
  • 40% less information retention compared to long-form content

DeepWatch helps you build healthier digital habits by creating intentional friction.


Getting Started

Installation

  1. Download DeepWatch from the Play Store or install the APK directly
  2. Open the app to begin the setup process

Required Permissions

DeepWatch requires two Android permissions to function:

1. Accessibility Service

This permission allows DeepWatch to detect when you navigate to short-form video content.

To enable:

  1. Open DeepWatch and tap "Open Settings" on the permission card
  2. Find "DeepWatch" in the list of accessibility services
  3. Toggle it ON
  4. Confirm by tapping "Allow"

Why is this needed? The accessibility service monitors which screen you're viewing to detect when you enter short-form video sections of apps.

2. Overlay Permission (Display Over Other Apps)

This permission allows DeepWatch to show the blocking overlay on top of other apps.

To enable:

  1. Tap "Grant Permission" on the overlay permission card
  2. Toggle "Allow display over other apps" to ON

Why is this needed? To show you the pause screen with the countdown timer when short-form content is detected.


Using DeepWatch

How It Works

  1. Detection: When you navigate to short-form content (like YouTube Shorts or Instagram Reels), DeepWatch detects this
  2. Intervention: A full-screen overlay appears with a countdown timer
  3. Reflection: You have time to ask yourself: "Is this intentional?"
  4. Choice: After the countdown, you can choose to:
    • Go Back (recommended) - Exit the short-form content
    • Proceed Anyway - Continue watching, triggering a cooldown period

Understanding the Blocking Overlay

When triggered, you'll see:

  • Countdown Timer: Wait period before you can proceed (customizable 5-30 seconds)
  • Motivational Quote: A different quote appears each time
  • GO BACK Button: Available immediately to exit
  • PROCEED ANYWAY Button: Available after countdown completes

Viewing Your Statistics

The home screen shows:

  • Today's Activity: Number of interventions and times you went back
  • All Time Stats: Total interventions since installing the app
  • Estimated Time Saved: Based on average 5 minutes saved per intervention

Supported Apps

YouTube Shorts

Blocks access to the Shorts tab and short-form video player.

Instagram Reels

Blocks full-screen Reels viewing with granular control:

  • Reels Tab: Block Reels accessed from the dedicated tab (ON by default)
  • Homepage: Block Reels that appear in your feed
  • DMs: Block Reels shared in direct messages
  • Stories: Block Reels opened from stories

TikTok

Blocks all TikTok video content (the entire app is short-form focused).

Facebook Reels

Blocks Facebook's Reels feature.

Snapchat Spotlight

Blocks Snapchat's Spotlight (their TikTok competitor).

Reddit Videos

Blocks Reddit's video feed and full-screen video player.


Settings Explained

Protection Enabled (Master Toggle)

Turn all blocking on or off. Useful when you intentionally want to browse short-form content.

App Toggles

Enable or disable blocking for each individual app. All apps are OFF by default except YouTube Shorts.

Watch Limit

Instead of blocking immediately, you can set a time limit:

  • Enable Watch Limit: Turn this feature on/off
  • Duration (1-60 minutes): How long you can watch before intervention triggers

This is useful if you want to allow yourself a small amount of short-form content.

Timing Settings

Countdown Duration (5-30 seconds)

How long you must wait before the "Proceed Anyway" button appears. Longer times give you more time to reflect.

Cooldown After Proceed (1-30 minutes)

If you choose to proceed, how long before the next intervention. This prevents constant interruptions if you've consciously decided to watch.


FAQ & Troubleshooting

Why isn't the overlay appearing?

  1. Check permissions: Both accessibility service and overlay permission must be enabled
  2. Check master toggle: Make sure "Protection Enabled" is ON in settings
  3. Check app toggle: Make sure the specific app is enabled in settings
  4. Restart the app: Sometimes Android kills background services

The overlay appeared but buttons don't work

This is rare but can happen. Force close DeepWatch and reopen it.

Can I use specific apps without blocking?

Yes! Simply disable that app's toggle in Settings while keeping others enabled.

Does DeepWatch drain battery?

DeepWatch uses Android's accessibility service which runs in the background. Impact is minimal (typically <1% battery per day) as it only activates when monitored apps are in use.

Does DeepWatch collect my data?

No. DeepWatch operates entirely on your device:

  • No data is sent to servers
  • No account required
  • All statistics stored locally
  • You can uninstall anytime and all data is deleted

Will this work with newer app versions?

DeepWatch uses accessibility service detection which can break if apps significantly change their UI. We regularly update detection methods. If blocking stops working after an app update, please report it.

How do I completely disable DeepWatch?

Either:

  1. Turn off the "Protection Enabled" master toggle in Settings
  2. Disable the Accessibility Service in Android Settings
  3. Uninstall the app

Tips for Success

  1. Start with default settings: Use the app as-is for a week before customizing
  2. Set a longer countdown: 15-20 seconds gives you real time to reflect
  3. Track your progress: Check the stats regularly to see your improvement
  4. Be patient: Building new habits takes time
  5. Don't be too hard on yourself: If you proceed, that's okay - the goal is awareness

Privacy Policy Summary

DeepWatch is designed with privacy as a core principle:

  • No data collection: We don't collect any personal information
  • No analytics: We don't track how you use the app
  • No network requests: The app works entirely offline
  • Local storage only: All preferences and statistics are stored on your device
  • No accounts: No registration or login required

For the full privacy policy, visit our website.


Getting Help

If you encounter issues or have suggestions:

  1. Check this guide for common solutions
  2. Visit our GitHub issues page to report bugs
  3. Email [email protected]

Thank you for using DeepWatch to reclaim your attention!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment