explaingit

thiojoe/yt-spammer-purge

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

TLDR

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

Things people build with this

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

Tech stack

PythonYouTube Data APIGoogle Cloud

Getting 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.

In plain English

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?
Open on GitHub → Explain another repo

← thiojoe on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.