whatisgithub

What is yt-spammer-purge?

thiojoe/yt-spammer-purge — explained in plain English

Analysis updated 2026-06-26

4,649PythonAudience · generalComplexity · 3/5Setup · moderate

In one sentence

A Python tool for YouTube channel owners to bulk-find and delete spam or scam comments using 15 different filters, with a preview step before anything is permanently removed.

Mindmap

mindmap
  root((yt-spammer-purge))
    What it does
      Bulk spam removal
      YouTube comments
    Filtering
      Auto-smart mode
      Channel ID filter
      Regex patterns
      Unicode detection
    Safety
      Preview before delete
      Moderator mode
      Recovery mode
    Audience
      YouTube creators
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Bulk-delete hundreds of spam comments from a YouTube channel in one session instead of one by one

USE CASE 2

Scan your entire channel for comments from a specific spammer account and remove them all

USE CASE 3

Use moderator mode with a dummy account to flag suspicious comments for review without granting full access

USE CASE 4

Restore accidentally deleted comments using the tool's built-in recovery mode

What is it built with?

PythonYouTube Data APIGoogle Cloud

How does it compare?

thiojoe/yt-spammer-purgekozea/radicalepku-alignment/align-anything
Stars4,6494,6484,650
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/53/55/5
Audiencegeneralops devopsresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires creating a Google Cloud project and enabling the YouTube Data API to get OAuth credentials before first run.

So what is it?

YouTube Spammer Purge is a Python tool for YouTube channel owners who want to bulk-find and delete spam or scam comments. It was built in response to a wave of fake impersonator accounts that flooded YouTube comment sections with scam replies, making manual cleanup impractical when dozens or hundreds of spam accounts are involved across a channel's videos. The tool connects to your YouTube channel through the official YouTube Data API, which requires setting up your own Google Cloud project and API credentials. Because it runs locally on your machine using credentials you created yourself, the author has no access to your channel data. The README explains this in detail and also describes a moderator mode for users who do not want to grant the app full permissions: you create a dummy Google account, make it a moderator on your channel, and run the app through that account, which limits what the app can do to marking comments for review rather than outright deleting them. There are 15 filtering methods available. The recommended option is an Auto-Smart mode that automatically detects common spammer patterns. Other options let you filter by a specific channel ID, scan usernames or comment text for certain characters or strings, use a custom pattern written in regex, or flag comments containing unusual non-English characters. Scanning can target a single video, your most recent videos, or your entire channel's comment history. Once a scan is complete, the tool shows a list of matched comments along with samples so you can spot false positives before anything is deleted. You can exclude specific accounts, then confirm to delete or report the rest in bulk. There is also a recovery mode to restore previously deleted comments if something was removed by mistake. The tool runs from the command line and is available as a pre-built Windows executable for users who do not want to run Python directly. Linux and macOS users have separate setup instructions in the project wiki.

Copy-paste prompts

Prompt 1
Help me set up yt-spammer-purge: I need to create a Google Cloud project, enable the YouTube Data API, and get OAuth credentials for my channel.
Prompt 2
I want to use yt-spammer-purge to find all comments from accounts impersonating my username, which filter mode should I use?
Prompt 3
Show me how to run yt-spammer-purge in moderator mode using a dummy Google account so the app cannot permanently delete anything.
Prompt 4
I ran yt-spammer-purge and deleted some legitimate comments by mistake, how do I use recovery mode to restore them?
Prompt 5
How do I configure yt-spammer-purge to scan only my last 10 videos instead of my entire channel to save API quota?

Frequently asked questions

What is yt-spammer-purge?

A Python tool for YouTube channel owners to bulk-find and delete spam or scam comments using 15 different filters, with a preview step before anything is permanently removed.

What language is yt-spammer-purge written in?

Mainly Python. The stack also includes Python, YouTube Data API, Google Cloud.

How hard is yt-spammer-purge to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is yt-spammer-purge for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.