Skip to content

A Chrome extension that helps you find specific videos in your YouTube subscription feed by filtering content based on keyword

Notifications You must be signed in to change notification settings

Nihalsaeed/youtube-subscribtion-page-search

Repository files navigation

YouTube Subscription Page Search

A Chrome extension that helps you find specific videos in your YouTube subscription feed by filtering content based on user-defined keywords.

Extension Preview

Features

  • Keyword-Based Filtering: Only shows YouTube videos that contain your specified keywords in titles or descriptions
  • Real-Time Updates: Automatically filters content as you browse your subscription feed
  • Easy Management: Simple interface to add, remove, and manage your keywords
  • Manual Refresh: Force filter updates with the refresh button when needed
  • Persistent Storage: Keywords are saved and synced across your Chrome browsers

Installation

From Chrome Web Store (Coming Soon)

Manual Installation

  1. Download or clone this repository
  2. Open Google Chrome and navigate to chrome://extensions
  3. Enable "Developer mode" in the top right corner
  4. Click "Load unpacked"
  5. Select the folder containing this extension
  6. The extension icon will appear in your Chrome toolbar

Usage

  1. Click on the extension icon in the Chrome toolbar
  2. Add keywords for the types of videos you want to see
  3. Visit your YouTube subscription page (https://www.youtube.com/feed/subscriptions)
  4. Only videos matching your keywords will be visible
  5. Use the "Refresh Filter" button if the page doesn't update immediately

How It Works

  • The extension uses content scripts to monitor YouTube subscription pages
  • Keywords are stored in Chrome's sync storage
  • Videos with titles or descriptions matching any of your keywords are shown
  • All other videos are hidden from view
  • The filter updates automatically as new content loads

Files

  • manifest.json: Extension configuration
  • advanced_content.js: Content script that filters YouTube videos
  • background.js: Background script for managing extension state
  • popup.html: Popup UI for managing keywords
  • popup.js: Logic for the popup interface
  • icon*.png: Extension icons in various sizes

Development

Prerequisites

  • Google Chrome browser
  • Basic understanding of JavaScript, HTML, and CSS

Project Structure

youtube-subscription-search/
├── manifest.json
├── advanced_content.js
├── background.js
├── popup.html
├── popup.js
├── icon16.png
├── icon48.png
└── icon128.png

Loading the Extension for Development

  1. Clone or download this repository
  2. Open Chrome and go to chrome://extensions
  3. Enable "Developer mode"
  4. Click "Load unpacked" and select the project folder

Making Changes

  1. Modify the relevant files
  2. Reload the extension in chrome://extensions
  3. Test your changes on YouTube

Troubleshooting

Common Issues

No videos are being shown:

  • Check that you've added keywords in the extension popup
  • Try adding a very common keyword that should match many videos
  • Use the "Refresh Filter" button
  • Check the browser console for error messages

Extension not appearing:

  • Verify the extension is enabled in chrome://extensions
  • Restart Chrome if necessary

Keywords not saving:

  • Check browser storage quotas
  • Ensure you're connected to the internet for sync storage

Debugging

To debug issues:

  1. Right-click on the YouTube page and select "Inspect"
  2. Go to the "Console" tab
  3. Look for log messages from the extension
  4. Check for any error messages

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

License

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

Acknowledgments

  • Thanks to the Chrome Extensions documentation
  • Inspired by the need to filter content on YouTube subscription feeds

Support

If you encounter any issues or have feature requests, please open an issue on GitHub.# YouTube Subscription Page Search

A Chrome extension that helps you find specific videos in your YouTube subscription feed by filtering content based on user-defined keywords.

Extension Preview

Features

  • Keyword-Based Filtering: Only shows YouTube videos that contain your specified keywords in titles or descriptions
  • Real-Time Updates: Automatically filters content as you browse your subscription feed
  • Easy Management: Simple interface to add, remove, and manage your keywords
  • Manual Refresh: Force filter updates with the refresh button when needed
  • Persistent Storage: Keywords are saved and synced across your Chrome browsers

Installation

From Chrome Web Store (Coming Soon)

Manual Installation

  1. Download or clone this repository
  2. Open Google Chrome and navigate to chrome://extensions
  3. Enable "Developer mode" in the top right corner
  4. Click "Load unpacked"
  5. Select the folder containing this extension
  6. The extension icon will appear in your Chrome toolbar

Usage

  1. Click on the extension icon in the Chrome toolbar
  2. Add keywords for the types of videos you want to see
  3. Visit your YouTube subscription page (https://www.youtube.com/feed/subscriptions)
  4. Only videos matching your keywords will be visible
  5. Use the "Refresh Filter" button if the page doesn't update immediately

How It Works

  • The extension uses content scripts to monitor YouTube subscription pages
  • Keywords are stored in Chrome's sync storage
  • Videos with titles or descriptions matching any of your keywords are shown
  • All other videos are hidden from view
  • The filter updates automatically as new content loads

Files

  • manifest.json: Extension configuration
  • advanced_content.js: Content script that filters YouTube videos
  • background.js: Background script for managing extension state
  • popup.html: Popup UI for managing keywords
  • popup.js: Logic for the popup interface
  • icon*.png: Extension icons in various sizes

Development

Prerequisites

  • Google Chrome browser
  • Basic understanding of JavaScript, HTML, and CSS

Project Structure

youtube-subscription-search/
├── manifest.json
├── advanced_content.js
├── background.js
├── popup.html
├── popup.js
├── icon16.png
├── icon48.png
└── icon128.png

Loading the Extension for Development

  1. Clone or download this repository
  2. Open Chrome and go to chrome://extensions
  3. Enable "Developer mode"
  4. Click "Load unpacked" and select the project folder

Making Changes

  1. Modify the relevant files
  2. Reload the extension in chrome://extensions
  3. Test your changes on YouTube

Troubleshooting

Common Issues

No videos are being shown:

  • Check that you've added keywords in the extension popup
  • Try adding a very common keyword that should match many videos
  • Use the "Refresh Filter" button
  • Check the browser console for error messages

Extension not appearing:

  • Verify the extension is enabled in chrome://extensions
  • Restart Chrome if necessary

Keywords not saving:

  • Check browser storage quotas
  • Ensure you're connected to the internet for sync storage

Debugging

To debug issues:

  1. Right-click on the YouTube page and select "Inspect"
  2. Go to the "Console" tab
  3. Look for log messages from the extension
  4. Check for any error messages

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

License

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

Acknowledgments

  • Thanks to the Chrome Extensions documentation
  • Inspired by the need to filter content on YouTube subscription feeds

Support

If you encounter any issues or have feature requests, please open an issue on GitHub.

About

A Chrome extension that helps you find specific videos in your YouTube subscription feed by filtering content based on keyword

Resources

Stars

Watchers

Forks