Skip to content

germainelry/youtube-sub-manager

Repository files navigation

YouTube Sub Manager logo

YouTube Sub Manager

License: MIT

Chrome extension to find inactive YouTube subscriptions, track upload activity, and bulk unsubscribe safely. No API keys, no OAuth — everything runs locally in your browser.

➕ Add to Chrome

Dashboard filtered to inactive channels with bulk selection

How It Works

  1. Scan — visit your subscriptions page and the extension collects every channel
  2. Track activity — sort and filter by last upload date to find inactive channels
  3. Bulk unsubscribe — safely remove inactive channels with confirmations and automatic backups

Features

  • Scan all your YouTube subscriptions in one click
  • Track upload activity — see when each channel last uploaded a video
  • Sort and filter by last upload date, name, or subscriber count with inactivity presets
  • Bulk unsubscribe safely with confirmations and automatic backups
  • Export your full subscription list as CSV or JSON
  • 100% local — your data never leaves your browser
More screenshots

Scan your subscriptions

Popup open on the YouTube subscriptions page, scanning channels

Check for activity

Dashboard checking each channel's last upload date

Confirm before unsubscribing

Type-UNSUB confirmation dialog before bulk unsubscribe

Automatic backups before every unsubscribe

Auto-saved backup snapshots with download buttons

Install

From the Chrome Web Store

➕ Add to Chrome — the easiest way to get started. Click Add to Chrome, then pin the extension to your toolbar.

From source

Install from source (for developers)

Requires Node.js 18+ and pnpm 9+.

  1. Clone this repo and install dependencies:
    git clone https://github.com/germainelry/youtube-sub-manager.git
    cd youtube-sub-manager
    pnpm install
  2. Build the extension:
    pnpm build
  3. Open chrome://extensions in Chrome
  4. Enable Developer mode (top-right toggle)
  5. Click Load unpacked and select the dist/ folder
  6. Pin the extension to your toolbar

The first time you scan, Chrome will prompt you to grant access to youtube.com.

Usage

  1. Click the extension icon on any YouTube page
  2. Click Scan my subscriptions to load your subscription list
  3. Click Check for activity to see when each channel last uploaded
  4. Open the Dashboard to filter, sort, and search your channels
  5. Select inactive channels and bulk unsubscribe — with confirmations and automatic backups
  6. Export your full subscription list as CSV or JSON anytime

Privacy

YouTube Sub Manager stores all data locally in your browser. No analytics, no telemetry, no external servers. See PRIVACY_POLICY.md for details.

Development

Built with TypeScript, React 18, Vite, Dexie (IndexedDB), and Chrome Manifest V3.

pnpm dev       # Dev server with hot reload
pnpm build     # Production build
pnpm test      # Run tests

See CONTRIBUTING.md for dev setup, branch conventions, and code style.

Contributing

Contributions are welcome! See CONTRIBUTING.md to get started.

License

MIT

About

A chrome extension that find stale YouTube subscriptions, check upload activity and bulk unsubscribe. 100% local, no API Keys needed.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages