Skip to content

Ruthwik000/tasko-ex

Repository files navigation

Tasko - Chrome Extension

A powerful Chrome extension for learning, productivity, and focus management

Chrome Extension Manifest V3 License


🎯 About Tasko

Tasko is a modern Chrome extension designed to enhance your productivity and learning experience. With AI-powered features, intelligent ad blocking, and focus management tools, Tasko helps you stay on task and learn more effectively while browsing the web.

Key Highlights

  • πŸŽ“ AI Learning Assistant - Ask questions about any webpage
  • πŸš€ Performance Optimization - Faster page loads with smart blocking
  • 🎯 Focus Management - Stay productive with AI-powered detection
  • πŸ“‚ Tab Organization - Save and restore tab groups effortlessly
  • 🎨 Modern Dark UI - Sleek pitch black interface with orange accents

✨ Features

πŸŽ“ Learning Tools

Ad Blocker

Block ads and trackers across all websites for a cleaner, faster browsing experience.

  • YouTube-specific ad blocking
  • Lightweight and efficient
  • Declarative Net Request API
  • No performance impact

Speed Improver

Optimize page loading for faster browsing and reduced bandwidth usage.

  • Defer image loading
  • Block heavy scripts
  • Reduce data consumption
  • Improve page performance

Learning Agent πŸ€–

AI-powered assistant that helps you understand any webpage content.

  • Ask questions about page content
  • Get instant AI-generated answers
  • Powered by Groq API
  • Beautiful markdown formatting
  • Floating chat interface
  • Context-aware responses

πŸ’Ό Productivity Tools

YouTube Focus Mode 🎯

Remove distractions and stay focused while watching YouTube videos.

  • Hide YouTube Shorts
  • Remove recommendations
  • Hide comments section
  • Minimize sidebar clutter
  • Customizable focus panel
  • One-click activation

Focus Detection πŸ“Ή

AI-powered webcam monitoring to detect phone usage and keep you focused.

  • Real-time phone detection
  • Roboflow AI integration
  • Visual bounding boxes
  • Alert sounds on detection
  • 60% confidence threshold
  • Privacy-focused (local processing)

Nuclear Mode ☒️

Ultimate focus mode that blocks all non-whitelisted websites.

  • Whitelist essential sites
  • Set timer for work sessions
  • Automatic deactivation
  • Perfect for deep work
  • Pomodoro-friendly
  • Block distractions completely

πŸ“‚ Tab Manager

Organize and manage your browsing sessions efficiently.

  • Save Tab Groups - Create named collections of tabs
  • Restore Sessions - One-click restoration of saved groups
  • Batch Selection - Select multiple tabs at once
  • Session Tracking - See when groups were created
  • Local Storage - All data stored securely on your device

πŸš€ Installation

Option 1: Chrome Web Store (Coming Soon)

  1. Visit the Chrome Web Store
  2. Search for "Tasko"
  3. Click "Add to Chrome"
  4. Start using Tasko!

Option 2: Manual Installation

  1. Clone the repository

    git clone https://github.com/Ruthwik000/tasko-ex.git
    cd tasko-ex/chromeEX
  2. Install dependencies

    npm install
  3. Build the extension

    npm run build
  4. Load in Chrome

    • Open chrome://extensions/
    • Enable "Developer mode" (top right toggle)
    • Click "Load unpacked"
    • Select the dist/ folder
    • Tasko is now installed!

πŸ“– Quick Start Guide

1. Learning Agent Setup

  1. Click the Tasko icon in your toolbar
  2. Enable "Learning Agent" toggle
  3. Visit Groq Console to get a free API key
  4. Click the floating chat icon on any webpage
  5. Enter your API key when prompted
  6. Start asking questions!

Example Questions:

  • "Summarize this article"
  • "What are the main points?"
  • "Explain this concept in simple terms"

2. Focus Detection Setup

  1. Enable "Focus Detection" in Tasko popup
  2. Grant camera permissions when prompted
  3. A floating panel appears showing your webcam
  4. AI detects if you're using your phone
  5. Get instant alerts to refocus

3. Nuclear Mode Setup

  1. Enable "Nuclear Mode" toggle
  2. Add trusted sites to whitelist:
    • github.com
    • stackoverflow.com
    • docs.google.com
  3. Set a timer (e.g., 25 minutes)
  4. Click "Activate Nuclear Mode"
  5. All other sites are blocked until timer expires

4. Tab Manager

  1. Open "Tab Manager" section
  2. Enter a group name (e.g., "Research Project")
  3. Select tabs to save
  4. Click "Save Group"
  5. Restore anytime with one click

πŸ› οΈ Development

Prerequisites

  • Node.js v16 or higher
  • npm or yarn
  • Chrome browser

Setup

# Clone repository
git clone https://github.com/Ruthwik000/tasko-ex.git
cd tasko-ex/chromeEX

# Install dependencies
npm install

# Build for production
npm run build

# Development mode (watch)
npm run dev

Project Structure

chromeEX/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ popup/              # React UI components
β”‚   β”œβ”€β”€ content/            # Content scripts & features
β”‚   β”œβ”€β”€ background/         # Service worker
β”‚   └── offscreen.js        # Camera handling
β”œβ”€β”€ dist/                   # Build output
β”œβ”€β”€ icons/                  # Extension icons
β”œβ”€β”€ manifest.json           # Extension manifest
└── package.json            # Dependencies

🎨 Design

Tasko features a modern pitch black theme with vibrant orange accents:

  • Background: Pure black (#000000)
  • Accent: Orange (#fb923c, #f97316)
  • Text: Light gray on dark backgrounds
  • UI: Smooth animations and transitions

πŸ”§ Technologies

  • React - UI framework
  • Tailwind CSS - Styling
  • Vite - Build tool
  • Chrome Manifest V3 - Latest extension format
  • Groq API - AI-powered learning
  • Roboflow API - Computer vision

πŸ“ Permissions

Tasko requires these permissions:

  • storage - Save preferences and tab groups
  • tabs - Manage tabs
  • declarativeNetRequest - Block ads
  • scripting - Inject features
  • activeTab - Access current tab
  • webNavigation - Monitor navigation
  • offscreen - Camera for focus detection
  • notifications - Show alerts

🀝 Contributing

Contributions are welcome! Here's how:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ—ΊοΈ Roadmap

  • Chrome Web Store publication
  • Firefox support
  • Custom themes
  • More AI models
  • Analytics dashboard
  • Cloud sync
  • Mobile companion app

πŸ“„ License

This project is licensed under the MIT License.


πŸ‘¨β€πŸ’» Author

Ruthwik


πŸ™ Acknowledgments


πŸ“ž Support

Need help?

  1. Check Issues
  2. Create a new issue with details
  3. Star the repo if you find it useful!

Made with ❀️ for productivity

⬆ Back to Top

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages