AiSList is a community-maintained list of YouTube channels that mainly
publish AI-generated content ("AI slop"). It lists channels by @handle. Many YouTube clients, such as the Android
TV apps (SmartTube and its forks), only see a video's channel ID (UC…). They can't match the lists without an
extra lookup per channel.
This repo publishes the same lists by channel ID, updated every 6 hours.
| File | What |
|---|---|
lists/aislist_blocklist_ids.txt |
Blocklist (high confidence): one channel ID per line |
lists/aislist_warnlist_ids.txt |
Warnlist (medium confidence): one channel ID per line |
lists/aislist_blocklist.csv, lists/aislist_warnlist.csv |
handle,channel_id pairs |
lists/aislist_blocklist_channels.tsv, lists/aislist_warnlist_channels.tsv |
Channel ID, a tab, and the channel's name on YouTube as of the last check (for clients whose video cards show only a channel name; names aren't unique, so match by ID where you can) |
lists/stats.json |
Counts, and the AiSList commit the lists come from |
reports/handle_changes.tsv |
Listed handles whose channel now uses another handle |
The .txt files use AiSList's own format: lines starting with ! are comments. A client can download them from
https://raw.githubusercontent.com/theSiegs/aislist-channel-ids/main/lists/aislist_blocklist_ids.txt.
The lists come from AiSList. To add a channel or ask for one to be removed, use AiSList's own process, not this repo.
aislist_ids.py runs on a GitHub Actions schedule:
- It reads AiSList's newest lists.
- It refuses a list that comes back empty or less than half its last size, and keeps publishing the last good one.
- Some AiSList handles are URL-encoded (
@%C3%89cho); they're decoded and counted once.
- It looks up each new handle with the YouTube Data API (
channels.list?forHandle=, 1 unit each).- The first full pass of about 28,000 handles takes about three days of the free daily quota.
- After that, it handles AiSList's daily additions in minutes.
- Once a day it re-checks a seventh of the known channels (50 per unit). Deleted channels drop out of the lists, and
handle changes go to
reports/handle_changes.tsv. - It commits the results.
data/channels.tsvis its cache: handle, channel ID, status.
Handles a channel changes later don't matter: AiSList's own bot updates the list, and the new handle resolves to the same channel ID.
You need Python 3.10 or later (no other packages) and a YouTube Data API v3 key.
AISLIST_YT_API_KEY=<key> python3 aislist_ids.py --budget 100
python3 -m unittest discover -s testsFor your own copy on GitHub, add the key as the repository secret YT_API_KEY.
- The lists are AiSList's, by the AiSList contributors, under CC BY-NC 4.0: credit AiSList, and no commercial use. This repo only converts them from handles to channel IDs.
- The code is under the MIT license (
LICENSE).
If AiSList publishes channel IDs itself, this repo will point there and stop updating.