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.

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

Install TrackMyCourse
Go to any YouTube playlist page.
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.

Clone the repository:

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

Install dependencies:
```
npm install
```
Open Chrome Extensions: Navigate to chrome://extensions/ in your browser.
Enable Developer Mode: Ensure the Developer mode toggle is switched on.
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.

Building browser bundles

There is a script (scripts/build.js) that generates the Chrome and Firefox bundles into the dist/ folder.

Run the build commands:

# build Chrome bundle
npm run build:chrome

# build Firefox bundle
npm run build:firefox

# build both Chrome and Firefox
npm run build

The script will copy icons/ and src/ into dist/<browser>/ and include the appropriate manifest (manifest.chrome.json or manifest.firefox.json) for each browser.

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.
├── manifests/         # Browser-specific manifests
│   ├── manifest.chrome.json
│   └── manifest.firefox.json
├── .prettierrc        # Prettier configuration for consistent formatting
├── package.json       # Project dependencies and scripts
└── package-lock.json  # Locked dependency versions

🔐 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.