Universal Link Finder - Chrome Extension

🎯 Find the links you need, cut through the noise

A powerful Chrome extension that automatically detects and extracts specific links from web pages, helping you bypass ads, redirects, and cluttered interfaces to find exactly what you're looking for.

📖 Table of Contents

• Motivation
• Features
• Installation
• Usage Guide
• Pattern Types
• Examples
• Technical Details
• Troubleshooting
• Security & Privacy
• Support

🚀 Motivation

When browsing modern websites, finding specific links can be frustrating due to:

• 🚫 Excessive advertisements cluttering the page
• 🔄 Multiple redirects hiding actual content
• 📱 Complex layouts with buried links
• ⏰ Time-wasting searches through irrelevant content
• 🎭 Fake buttons and misleading elements

Universal Link Finder cuts through this noise by automatically scanning pages and highlighting only the links you actually need, saving you time and frustration.

✨ Features

🔍 Smart Link Detection

• Scans entire web pages including dynamic content
• Finds links in text, HTML attributes, and JavaScript code
• Real-time detection as page content updates

🎯 Multiple Pattern Types

• Predefined Patterns: Telegram, Discord, WhatsApp, GitHub, YouTube
• Simple Text Input: Just type what you're looking for (e.g., "coursera.org", "udemy.com")
• Advanced Regex: Full regex support for power users

🖱️ User-Friendly Interface

• Clean, modern popup interface
• One-click link opening
• Bulk operations for multiple links
• Visual highlighting of found links

🛡️ Privacy-Focused

• No data sent to external servers
• All processing happens locally
• Minimal permissions required
• Open source and transparent

⚙️ Flexible Operation Modes

• Manual Mode: Click highlighted links to open them
• Off Mode: Disable extension when not needed

🛠️ Installation

Prerequisites

• Google Chrome or Chromium-based browser
• Developer mode enabled

Step 1: Load Extension

1. Open Chrome and navigate to chrome://extensions/
2. Enable "Developer mode" (top-right toggle)
3. Click "Load unpacked"
4. Select the extension folder
5. The extension will appear in your toolbar

Step 2: Verify Installation

• Extension icon should appear in Chrome toolbar
• Click icon to open popup interface
• Badge should show "0 links found" initially

📚 Usage Guide

Basic Operation

1. Navigate to any webpage
2. Click the extension icon in the toolbar
3. Select patterns you want to find
4. Click "Scan Current Page" (automatic scanning also works)
5. View results in the popup
6. Click individual links to open them

Pattern Selection

Predefined Patterns

Check the boxes for built-in patterns:

• ✅ Telegram - t.me links
• ✅ Discord - discord.gg invites
• ✅ WhatsApp - wa.me links
• ✅ GitHub - Repository links
• ✅ YouTube - Video links

Custom Patterns

Simple Text Mode (Recommended):

1. Select "Simple Text"
2. Enter plain text (e.g., "coursera.org")
3. Give it a name (e.g., "Course Links")
4. Click "Add"

Advanced Regex Mode:

1. Select "Advanced Regex"
2. Enter regex pattern
3. Give it a name
4. Click "Add"

Operation Modes

Manual Mode (Default)

• Extension finds and highlights links
• Click highlighted links to open them
• Full control over which links open

Off Mode

• Completely disables extension
• No scanning or highlighting

🎨 Pattern Types

Simple Text Patterns

Perfect for non-technical users. Just enter what you're looking for:

Input	Finds	Use Case
coursera.org	https://coursera.org/learn/course-name	Online courses
udemy.com	https://udemy.com/course/tutorial-name	Video tutorials
t.me	https://t.me/channelname	Telegram channels
drive.google.com	https://drive.google.com/file/...	Google Drive files
mediafire.com	https://mediafire.com/file/...	MediaFire downloads

Advanced Regex Patterns

For power users who need precise control:

Pattern	Description
https?://t\.me/[a-zA-Z0-9_]+	Telegram usernames/channels
https?://.*\.zip$	Direct ZIP file downloads
magnet:\?xt=urn:btih:[a-f0-9]{40}	BitTorrent magnet links
https?://.*\.(mp4|mkv|avi)	Video file direct links

💡 Examples

Example 1: Finding Telegram Links

Scenario: Page has many ads but you need Telegram channel links

1. Check "Telegram (t.me links)"
2. Scan page
3. Extension finds: https://t.me/yourchannel
4. Click to open in new tab

Example 2: Course Download Links

Scenario: Educational site with course links buried in ads

1. Add custom pattern: "coursera.org"
2. Name it: "Course Links"
3. Scan page
4. Extension finds: https://coursera.org/learn/machine-learning
5. Open direct course link

Example 3: GitHub Projects

Scenario: Blog post mentions several GitHub repositories

1. Check "GitHub repositories"
2. Scan page
3. Extension finds all GitHub repo links
4. Open interesting projects quickly

🔧 Technical Details

Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Content       │    │   Background    │    │   Popup         │
│   Script        │◄──►│   Service       │◄──►│   Interface     │
│   (Scanner)     │    │   Worker        │    │   (Controls)    │
└─────────────────┘    └─────────────────┘    └─────────────────┘

File Structure

chrome-extension-link-finder/
├── manifest.json              # Extension configuration
├── background.js              # Background service worker
├── content.js                 # Content script (page scanner)
├── popup.html                 # Extension popup interface
├── popup.js                   # Popup functionality
├── popup.css                  # Popup styling
├── icons/                     # Extension icons
│   ├── icon16.png
│   ├── icon32.png
│   ├── icon48.png
│   └── icon128.png
└── README.md                  # This documentation

Permissions Required

Permission	Purpose
activeTab	Access current tab content
scripting	Inject content scripts
tabs	Create new tabs for links
storage	Save user preferences
<all_urls>	Scan any website

Pattern Matching Logic

1. Page Scan: Content script scans DOM elements
2. Pattern Application: Applies all active patterns
3. Deduplication: Removes duplicate links
4. Notification: Sends results to background script
5. UI Update: Updates badge and popup display

🔧 Troubleshooting

Extension Not Working

Problem: Extension icon shows but doesn't find links Solutions:

• Reload extension in chrome://extensions/
• Check if patterns are selected
• Try manual "Scan Current Page"
• Check browser console for errors

No Links Found

Problem: Page has links but extension shows "0 links found" Solutions:

• Verify pattern syntax (try simple text mode)
• Check if links are dynamically loaded
• Wait for page to fully load
• Try different pattern variations

Permission Errors

Problem: Extension can't access page Solutions:

• Ensure extension is enabled
• Refresh the webpage
• Check if site blocks extensions
• Try incognito mode

Pattern Not Matching

Problem: Custom pattern doesn't find expected links Solutions:

• Use simple text mode instead of regex
• Check pattern in regex tester
• Look at browser console for pattern errors
• Try broader patterns first

🛡️ Security & Privacy

Data Handling

• No external requests: All processing is local
• No data storage: Links are not saved permanently
• No tracking: Extension doesn't track browsing
• Open source: Code is fully auditable

Safe Usage

• Only install from trusted sources
• Review custom patterns from others
• Be cautious with auto-opening modes
• Regularly update the extension

📄 License

This project is open source and licensed under the MIT License.

Support

• GitHub Issues: Report bugs and request features
• Documentation: Check this README for answers
• Community: Share patterns and tips

---

Made with ❤️ to cut through web clutter and find what matters