Skip to content

lnanduri2005/Tab-Sniper-Extension

Repository files navigation

<<<<<<< HEAD

Tab Sniper

A Chrome extension that helps you stay focused by blocking distracting websites during your focus sessions. Perfect for students, professionals, and anyone who wants to maintain productivity. https://chromewebstore.google.com/detail/tab-sniper/ehdaobjgkeigecnmmdokmbkgkclnlgop

Features

  • Focus Timer: Set custom focus sessions with a countdown timer
  • Website Blocking: Block distracting websites during focus sessions
  • Visual Feedback: Clear visual indicators of focus mode status
  • Easy Management: Simple interface to add and remove blocked websites
  • Persistent Settings: Your blocked websites list is saved across sessions

How to Use

  1. Install the Extension

    • Download from the Chrome Web Store
    • Or load it as an unpacked extension in developer mode
  2. Set Up Your Blocked Sites

    • Add websites you want to block during focus sessions
    • You can add multiple sites to your block list
  3. Start a Focus Session

    • Set your desired focus duration
    • Click "Start Focus Mode"
    • The extension will automatically block your specified websites
  4. During Focus Mode

    • Blocked websites will be automatically closed if you try to access them
    • The timer will show your remaining focus time
    • You can't modify your block list during a focus session

🔧 Development

Technical Details

  • Built with vanilla JavaScript
  • Uses Chrome Extension APIs
  • Implements Chrome Storage for persistence
  • Features responsive design

Future Developments

  • Mini-game feature to make focus sessions more engaging
  • Statistics tracking for focus sessions and productivity
  • Custom themes and visual customization options
  • Integration with popular productivity tools
  • Mobile companion app for cross-device synchronization

Contributing

Feel free to submit issues and enhancement requests! OG Developers: Likitha Nanduri, Parikshith Venkataraghavan, and Abhigna Nimmagadda

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

=======

Tab Sniper

A productivity browser extension that blocks distracting websites during focus sessions

📋 Overview

Tab Sniper is a Chrome extension designed to help you stay focused by blocking distracting websites for a set period. The extension features a unique "focus mode" that makes it challenging to disable once activated, with a playable cannon game that requires skill to overcome.

✨ Features

  • Website Blocking: Add any distracting websites to your block list
  • Timed Focus Sessions: Set a timer for your focus session (in minutes)
  • Hidden URL List: During focus sessions, your block list is hidden to reduce temptation
  • Game Challenge: The only way to disable focus mode early is to win a skill-based cannon game
  • User-Friendly Interface: Clean, dark-themed UI for a distraction-free experience

🎮 The Challenge Game

When focus mode is active and you try to remove a blocked URL, you'll be presented with a cannon game:

  • Aim and shoot the cannon to get the ball into the moving bucket
  • Score 3 points to disable focus mode and unlock all websites
  • Limited to 3 shots maximum per attempt
  • Adjustable difficulty with moving targets and physics

🚀 How It Works

  1. Add Websites: Enter URLs you want to block during focus time
  2. Set Timer: Choose how long you want to stay focused (in minutes)
  3. Start Focus Mode: Activate the timer to begin blocking the specified websites
  4. Stay Focused: Any attempt to visit blocked sites will be automatically prevented
  5. Emergency Override: If you absolutely need to access a site, win the cannon game

🔧 Usage

Setting Up Focus Mode

  1. Toggle the extension on using the switch at the top
  2. Add distracting websites to your block list (e.g., facebook.com, twitter.com)
  3. Set the timer duration in minutes
  4. Click "Start Focus Timer" to begin your focused work session

During Focus Mode

  • The extension will block any attempt to visit your listed websites
  • The URL list is hidden (can be temporarily revealed)
  • The timer will count down showing your remaining focus time

Ending Focus Mode

  • Wait for the timer to expire naturally
  • OR play the cannon game by clicking the remove button (❌) next to any URL
  • Win the game by getting the ball in the bucket 3 times with a maximum of 3 shots

🔒 Privacy

Tab Sniper respects your privacy:

  • All data is stored locally in your browser
  • No tracking or data collection
  • No external server communication

🛠️ Technical Details

Tab Sniper uses:

  • Chrome Extension APIs for tab management and blocking
  • Local storage for saving your block list and settings
  • Canvas-based game implementation
  • HTML/CSS/JavaScript

📝 Development Status

Tab Sniper is currently under active development. Future features may include:

  • Statistics tracking for productivity insights
  • Additional customization options
  • Support for other browsers
  • More engaging override challenges

💡 Contributing

Contributions are welcome! Feel free to submit pull requests or create issues for bugs and feature requests.


Made with ❤️ to help you stay focused and productive

e0f7080 (first commit)

About

A Chrome Extension to block distracting websites and help users focus with a customizable timer.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors