Skip to content

itsgaurav15/Study-Focus-Extension

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Study Focus Guardian

A Firefox extension that detects distraction during online study sessions and automatically brings students back to their learning flow.

The Problem

Students preparing for competitive exams like JEE / NEET / UPSC / GATE, etc. often start studying online but quickly get distracted by:

YouTube Shorts Instagram reels Comedy or entertainment videos Random browsing “just for 5 minutes”

And suddenly, hours are gone without awareness.

"Traditional tools block apps or track time — but they don’t understand behavior during studying."

The Solution

Study Focus Guardian acts as a real-time study companion inside the browser.

Instead of blocking everything, it:

Monitors your browsing behavior Detects when you drift away from study content Calculates a live “Focus Score” Automatically redirects you back to your study playlist when focus drops

Key Features

Smart Focus Detection

Tracks:

Active tab usage Time spent idle Study vs distraction websites YouTube Shorts / entertainment detection

Auto Study Recovery

If distraction continues:

Automatically redirects user to:

Saved study playlist Last watched lecture Goal-based learning session

Real-Time Focus Score

A live score (0–100) that represents:

Study consistency Distraction frequency Idle behavior

Goal-Oriented Learning

Users can set:

“JEE Physics” “NEET Biology” “Gate Revision”

System ensures users return to their learning path.

How It Works

User starts studying (YouTube / PW / Unacademy) ↓ Extension tracks behavior in real-time ↓ Focus Score engine updates continuously ↓ If distraction detected for long: ↓ Auto-redirect to study playlist ↓ User returns to learning flow

Tech Stack

JavaScript (Vanilla) Firefox WebExtensions API HTML / CSS (UI) Browser Storage API

Project Structure

study-focus-guardian/ │ ├── manifest.json # Extension configuration ├── background.js # Focus decision engine ├── content.js # Activity tracking logic ├── popup.html # UI for user controls ├── popup.js # Playlist management ├── style.css # UI styling └── README.md

How to Install (Firefox)

Open Firefox Go to: about:debugging Click: “This Firefox” Click: “Load Temporary Add-on” Select: manifest.json

Demo Flow

Open YouTube JEE/NEET lecture playlist Start studying Open Shorts / Instagram Wait a few seconds System detects distraction Automatically redirects back to study lecture

What Makes This Special

Most productivity tools:

X Block apps X Track time X Show reports after distraction happens

This project is different:

✔ It intervenes in real time ✔ It understands study intent ✔ It actively restores focus ✔ It works across learning platforms

It behaves like a “study guardian inside your browser”

Future Improvements

AI-based content classification (study vs distraction) Emotion-based focus detection Study streak gamification system Cross-device syncing (mobile + desktop) Voice-based focus alerts

Built For

Hackathons Student productivity enhancement Competitive exam aspirants

Vision

“We are not trying to block distractions. We are trying to rebuild focus automatically.”

About

Study Focus Guardian is a lightweight browser extension designed to help students stay focused during long online study sessions (especially for exams like JEE/NEET). It monitors browsing behavior across learning platforms like YT, Unacademy, and PW, and detects when users drift into distractions such as Shorts, reels, or entertainment content.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 77.7%
  • CSS 12.6%
  • HTML 9.7%