Skip to content

duyo-son/remix-block

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎵 Remix Block

Buy Me A Coffee

A Chrome extension that blocks remix songs from YouTube Music playlists and recommendations. Say goodbye to unwanted remixes and enjoy your original music!

✨ Features

  • Channel Blocking: Block entire channels known for creating remixes
  • Title Detection: Automatically detects songs with "remix", "bootleg", "nightcore", etc. in the title
  • Smart Filtering: Blocks remixes from playlists, recommendations, and queue
  • Progress Tracking: See real-time blocking progress and statistics
  • Auto-Update: Fetch the latest blocklist from the repository
  • Incremental Updates: Only download new channels added since your last update

📦 Installation

From Chrome Web Store

(Coming soon)

Manual Installation

  1. Clone this repository:

    git clone https://github.com/duyo/remix-block.git
  2. Open Chrome and navigate to chrome://extensions/

  3. Enable "Developer mode" in the top right corner

  4. Click "Load unpacked" and select the extension folder

  5. The extension icon should appear in your toolbar

🚀 Usage

  1. Click the Remix Block icon in your Chrome toolbar
  2. Make sure the extension is enabled (green toggle)
  3. Click "Update Blocklist" to fetch the latest blocked channels
  4. Visit YouTube Music and enjoy remix-free listening!

Extension Popup Features

  • Extension Status: Toggle blocking on/off
  • Latest DB Date: Shows when the blocklist was last updated on the server
  • Last Updated: Shows when you last synced the blocklist
  • Blocked Channels: Total number of channels in your blocklist
  • Blocking Progress: Real-time progress when scanning the page
  • Session Stats: How many items were blocked in the current session

📋 How It Works

Blocking Methods

  1. Channel-based Blocking: The extension maintains a list of channels known for creating remixes. Any song from these channels is hidden.

  2. Title-based Blocking: Songs with the following keywords in their titles are hidden:

    • remix, remixed, rmx
    • bootleg, rework, flip
    • mashup, mash-up
    • nightcore, slowed, reverb
    • 8d audio, bass boosted
    • vip mix
  3. Real-time Detection: The extension monitors YouTube Music pages and hides blocked content as it loads.

Blocklist Format

Blocklists are stored as CSV files with the following format:

channelId,channelName,addedDate
UC_example1,"Remix Nation",2024-12-09

🔧 Scraper (For Contributors)

The project includes a scraper to automatically find remix channels on YouTube Music.

Running the Scraper

Using Docker Compose:

# Run once (manual scrape)
docker-compose --profile manual up scraper-once

# Run continuously (daily scrape at 3:00 AM)
docker-compose up -d scraper

The scraper will:

  • Search YouTube Music for remix-related content
  • Extract channel information from search results
  • Save new channels to the blocklist folder
  • Skip channels already in the blocklist

📁 Project Structure

remix-block/
├── extension/           # Chrome extension files
│   ├── manifest.json    # Extension manifest
│   ├── popup.html/js/css # Extension popup UI
│   ├── background.js    # Service worker
│   ├── content.js/css   # Content scripts
│   └── icons/           # Extension icons
├── blocklist/           # Blocklist CSV files
│   ├── manifest.json    # Blocklist metadata
│   └── *.csv            # Channel blocklists
├── scraper/             # YouTube Music scraper
│   ├── Dockerfile
│   ├── package.json
│   └── index.js
└── docker-compose.yml   # Docker setup for scraper

🤝 Contributing

Contributions are welcome! Here's how you can help:

  1. Add Channels: Found a remix channel? Add it to a blocklist CSV file
  2. Improve Detection: Help improve the title detection patterns
  3. Bug Reports: Report issues on GitHub
  4. Feature Requests: Suggest new features

Adding Channels to Blocklist

  1. Fork the repository
  2. Add channels to a new CSV file in blocklist/ folder
  3. Follow the format: channelId,channelName,addedDate
  4. Submit a pull request

📜 License

MIT License - See LICENSE for details

☕ Support

If you find this extension useful, please consider supporting its development:

Buy Me A Coffee

Your support helps keep this project alive and ad-free! 🙏


Note: This extension is not affiliated with YouTube or Google. It modifies the visual appearance of YouTube Music pages locally in your browser.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published