Free & Open Source

Manage Your YouTube
Subscriptions Effortlessly

Back up, restore, and bulk-unsubscribe from YouTube channels — fully automated with a clean GUI.

Install Now View on GitHub
PowerShell irm https://github.com/savvy773/app-yt-subs-manager/releases/latest/download/install.ps1 | iex

What it does

Everything you need
for subscription management

One-click export, restore, and mass unsubscribe — with human-like delays to protect your account.

📤

Export (Backup)

Scrapes all your subscribed channels and saves them to a subscriptions.csv file for safekeeping.

🗑️

Clear (Bulk Unsubscribe)

Automatically unsubscribes from every channel with human-like delays and periodic safe-breaks to avoid account flags.

📥

Import (Restore)

Re-subscribes to all channels in your CSV backup with progress tracking and per-channel status logging.

🕶️

Background Mode

Toggle headless (hidden) browser mode so automation runs silently without opening a visible browser window.

🔐

Session Persistence

Login once — Playwright stores your Google session in a local profile so you never have to log in again.

💾

Window State Memory

Window position and size are auto-saved every 2 seconds so the app opens exactly where you left it.


How to use

Get started in minutes

Four simple steps to back up or restore your YouTube subscriptions.

1

Install the app

Run the one-line PowerShell command. uv, Python, and Chromium are installed automatically — no prior setup needed.

2

Log in to Google Once only

Click Login / Check Session and complete the Google login in the browser window that opens. Your session is saved locally — you only need to do this once.

3

Export your subscriptions

Click Export (Backup). The app scrolls through your channel list and saves everything to subscriptions.csv in your app data folder.

4

Clear or Restore Irreversible without backup

Use Clear (Delete) to mass-unsubscribe from all channels. Use Import (Restore) to re-subscribe from your CSV backup. Always export first!


Installation

One command, fully automated

The installer handles everything — no Python, no manual dependencies.

1️⃣

Install uv (Python package manager)

Auto-installed if not present. Manages Python itself so you don't have to.

2️⃣

Install Python 3.14

Managed internally by uv — no system Python required.

3️⃣

Download & verify the wheel

Fetches the latest release from GitHub and verifies the blake3 hash for integrity.

4️⃣

Install the app & Chromium

Installs yt-subs as a global tool and downloads Playwright's Chromium browser.

5️⃣

Create desktop shortcut

A shortcut with the app icon is placed on your desktop automatically.

# Windows PowerShell — run as any user, no admin required
irm https://github.com/savvy773/app-yt-subs-manager/releases/latest/download/install.ps1 | iex

# Linux / macOS
curl -fsSL https://github.com/savvy773/app-yt-subs-manager/releases/latest/download/install.sh | bash

Already installed? Running the command again will upgrade to the latest version and skip components that are already present.


Tech Specs

Under the hood

Built with modern Python tooling for reliability and easy distribution.

Runtime & Framework
Language Python 3.14
GUI Framework Flet 0.84 (Flutter)
Automation Playwright 1.58
Browser Chromium (bundled)
Package Manageruv
Distribution
Format Python Wheel (.whl)
Integrity checkBLAKE3 hash
Installer PowerShell / Bash
Registry GitHub Releases
Entry point typegui-scripts (no console)
Platform Support
Windows ✓ Supported
macOS ✓ Supported
Linux ✓ Supported
Admin rightsNot required
Python requiredNot required
Data & Privacy
Config path %APPDATA%\yt-subs\
Session storageLocal Chromium profile
Network calls YouTube only
Telemetry None
Source 100% open source