TrackMyCourse – YouTube Playlist Progress Tracker

Turn YouTube playlists into courses. Track your playlist with checkmarks, progress bar, total and watched duration, and completion percentage.

TrackMyCourse helps you stay organized while learning from YouTube playlists.

Instead of passively watching videos and forgetting your progress, you can turn any playlist into a structured online course. The extension integrates directly into YouTube, showing a progress bar, completion percentage, watched and total duration, and checkmarks for finished videos — giving you a clear view of your learning journey.

---

📚 Table of Contents

• Why TrackMyCourse?
• ✨ Features
• 🚀 Installation & Usage
• 🛠️ For Developers
  • Contributing
  • Running Locally
  • Project Structure
• 🔐 Permissions Explained
• 📜 License

---

Why TrackMyCourse?

YouTube is a powerful place for self-learning — from coding tutorials to full university lectures.
But since YouTube is designed for entertainment, not structured courses, it’s easy to lose progress, skip videos, or lose consistency.

TrackMyCourse solves this by adding a clean progress-tracking layer to YouTube playlists, showing completion percentage, durations, and checkmarks to keep your learning organized, consistent, and motivating.

Ready to use TrackMyCourse? Install now and start tracking your playlists.

---

✨ Features

• 📊 Visual Progress Bar – Instantly see how much of a playlist you’ve completed.
• ✅ Video Checkmarks – Mark videos as finished to keep your learning on track.
• ⏱️ Duration Tracking – Know your watched and total time to plan your study sessions better.
• 🔄 Dynamic Playlist Scanning – Automatically detects videos in the playlist.
• 💾 Saved Locally – Your progress stays saved in your browser, no sign-up needed.

All features appear seamlessly inside YouTube’s interface.

Preview of Features:

---

🚀 Installation & Usage

1. Install TrackMyCourse
2. Go to any YouTube playlist page.
3. Click the "Start Course" button near the playlist title.

Once enabled, the progress bar and checkboxes will automatically appear for that playlist.

---

🛠️ For Developers

This section provides information for anyone who wants to contribute to the project or run it locally.

Contributing

Contributions are welcome! Bug fixes, feature suggestions, and pull requests are appreciated. For major changes, please open an issue first to discuss your ideas.

Running Locally

Follow these steps to set up the project on your local machine.

1. Clone the repository:

   git clone https://github.com/AlokYadavCodes/track-my-course.git

2. Open Chrome Extensions: Navigate to chrome://extensions/ in your browser.
3. Enable Developer Mode: Ensure the Developer mode toggle is switched on.
4. Load the extension: Click "Load unpacked" and select the track-my-course folder you cloned.

Note: Changes to the source code will only reflect after you reload the extension on the chrome://extensions/ page.

Project Structure

track-my-course/
├── icons/          # Contains all extension icons.
├── src/            # Contains the main source code.
│   ├── background/ # Handles background tasks.
│   ├── content/    # Injects scripts directly into web pages.
│   └── popup/      # Code for the extension's popup window.
├── styles/         # Contains CSS files for UI elements injected onto pages.
└── manifest.json   # Chrome extension configuration file.

---

🔐 Permissions Explained

TrackMyCourse requests only the permissions it needs to function, nothing more.

Permission	Why It's Needed
storage	To save your playlist progress locally in the browser.
webNavigation	To detect playlist pages so the extension can apply the correct logic.
host_permissions	To display the progress UI only on YouTube pages.

Privacy first: No personal data is collected, stored, or transmitted.

📜 License

This project is licensed under the GNU GPLv3 License.

See the LICENSE file for full details.