FeedX

Cure your feed. Rewire your recommendations.

FeedX is a Chrome extension designed to help reshape your YouTube recommendations through automated history cleanup, curated searches, and intelligent watch-session injection.

Instead of letting the algorithm drift randomly, FeedX helps redirect it toward the content you actually want.

---

Overview

YouTube recommendations evolve from:

• Watch history
• Search activity
• Session behavior
• Interaction patterns

Over time, feeds become noisy, repetitive, or completely disconnected from your interests.

FeedX provides a guided workflow to:

• Reset old recommendation signals
• Inject curated viewing patterns
• Rebuild your feed around a selected vibe

---

Features

Recommendation Reset Purges outdated watch history Removes old recommendation signals Creates a clean algorithm baseline	Vibe Selection Choose targeted content directions like: Deep Work Tech Gaming Mindfulness Cooking Kids
Automated Injection Searches curated content vectors Simulates healthy watch behavior Runs in background tabs automatically	Protocol Modes Fast Quick recommendation pulse Deep Stronger algorithm rewiring

---

Workflow

Select Vibe
     ↓
Optional History Purge
     ↓
Curated Search Injection
     ↓
Automated Watch Sessions
     ↓
Recommendation Rebuild

---

Supported Vibes

Category	Example Sub-Vibes
Deep Work	Focus, Productivity, Study
Tech	Programming, AI, Engineering
Mindfulness	Meditation, Calm, Minimalism
Gaming	Strategy, Competitive, Indie
Cooking	Recipes, Meal Prep, Baking
Kids	Educational, Safe Viewing

---

How FeedX Works

1. Choose a Direction

Select the type of recommendations you want YouTube to prioritize.

---

2. Pick an Intensity

Mode	Purpose
Fast	Lightweight recommendation influence
Deep	Stronger recommendation rebuilding

---

3. Optional Watch-History Purge

FeedX can clear existing watch-history signals before rebuilding recommendations.

Warning: Watch history deletion is irreversible.

---

4. Automated Recommendation Injection

FeedX then:

• Searches curated vectors
• Opens selected content
• Simulates watch sessions
• Reinforces recommendation intent

Everything runs in a background tab without interrupting your active browsing session.

---

Architecture

extension/
│
├── manifest.json      → Extension metadata & permissions
├── popup.html         → Main popup UI
├── popup.js           → Popup logic & messaging
├── background.js      → Protocol orchestration engine
├── search.js          → YouTube search scraping
├── watch.js           → Watch-session simulation
└── purge.js           → Watch-history cleanup

---

Installation

Load Unpacked Extension

1. Open:

chrome://extensions

2. Enable Developer Mode
3. Click Load unpacked
4. Select the extension/ folder
5. Pin FeedX to your toolbar

---

Permissions

Domain	Purpose
youtube.com	Search and watch automation
myactivity.google.com	Watch-history management

---

Best Practices

• Run one protocol at a time
• Let the workflow complete fully
• Avoid conflicting automation extensions
• Use Deep mode only for major recommendation resets

---

Design Philosophy

Recommendation systems should reflect intentional interests, not accumulated noise.

FeedX focuses on:

• Controlled recommendation shaping
• Minimal friction
• Transparent workflows
• Fast execution
• Clean UI behavior

---

Tech Stack

• JavaScript
• Chrome Extension APIs
• Manifest V3
• DOM Automation
• Background Service Workers

---

License

Licensed under the MIT License.

You are free to:

• Use
• Modify
• Fork
• Experiment
• Build upon the project

See LICENSE.md for details.

---

FeedX

Reset the noise. Train the algorithm you actually want.