Skip to content

Instantly share code, notes, and snippets.

@shmup
Last active July 16, 2026 11:53
Show Gist options
  • Select an option

  • Save shmup/29566c5268569069c256 to your computer and use it in GitHub Desktop.

Select an option

Save shmup/29566c5268569069c256 to your computer and use it in GitHub Desktop.
transmission blocklist guide

Transmission Blocklist

The Transmission torrent client has an option to set a Blocklist, which helps protect you from getting caught and having the DMCA send a letter/email.

It's as simple as downloading and installing the latest client:

After installing, navigate through the menu: Edit > Preferences > Privacy:

image

  1. Check enable blocklist
  2. Paste in: https://raw.githubusercontent.com/Naunter/BT_BlockLists/master/bt_blocklists.gz (peep the curls) (github)
  3. Check Enable automatic updates
  4. Click Update
  5. Close
@Galenmacil

Copy link
Copy Markdown

I have never had an issue using this list without registering: http://list.iblocklist.com/?list=bt_level1&fileformat=p2p&archiveformat=gz

Thanks for this. Still working as of this writing...

@JasperLawrence

Copy link
Copy Markdown

Thank you to everyone who has contributed to this list, I am grateful for your efforts.

@kiwisincebirth

Copy link
Copy Markdown

@cablehub

cablehub commented Jul 23, 2023

Copy link
Copy Markdown

This seems to work quite well: https://github.com/fonic/ipfilter

Only downside is that you need a server to provide the file as Transmission still hasn't implemented support for local blocklist files. I put the script on my NAS, which generates the block list and then serves it to local clients via HTTP. Works perfectly thus far.

@v0d0r

v0d0r commented Jun 1, 2024

Copy link
Copy Markdown

here is something i hacked together using the iblocklist.com list. of course i ended up registering to iblocklist.com to get this to work. replace with your own custom url they provide you based on your selection etc... also worth noting i run transmission in a docker and extract the blacklist file to my container config / blacklists folder then restart the container for it to read it on startup. then i just cron the below script weekly.

`#!/bin/bash

Variables

URL='http://list.iblocklist.com/?list=xyz&fileformat=p2p&archiveformat=gz&username=meh&pin=1234'
OUTPUT_DIR='/mnt/nfs/swarm/dockervolumes/transmission/blocklists'
OUTPUT_FILE='blocklist.gz'
EXTRACTED_FILE='blocklist'
DOCKER_CONTAINER='transmission'

Download the blocklist file

wget -O $OUTPUT_FILE $URL

Extract the blocklist file

gunzip -f $OUTPUT_FILE

Move the extracted file to the desired location

mv $EXTRACTED_FILE $OUTPUT_DIR/$EXTRACTED_FILE

Restart the Docker container

docker restart $DOCKER_CONTAINER

echo "Blocklist updated and Docker container restarted successfully."`

@petesimon

Copy link
Copy Markdown

in September 2024, this link https://github.com/Naunter/BT_BlockLists/raw/master/bt_blocklists.gz still works. Thank you!

@Zotter

Zotter commented Oct 23, 2024

Copy link
Copy Markdown

Yes, "https://github.com/Naunter/BT_BlockLists/raw/master/bt_blocklists.gz" still works and the date changes routinely, but it doesn't appear the contents of the file have changed since 2022 or earlier. The scripts creating the archive are running, but it's unclear if there are actually any updates to be had, let alone included.

@engineeror

Copy link
Copy Markdown

@shmup

shmup commented Oct 23, 2024

Copy link
Copy Markdown
Author

I did wonder if @Zotter has a point though, @engineeror . If it's true the contents haven't changed in a while, I'll update the gist with that warning information. I haven't been paying attention (or even using transmission)

@shmup

shmup commented Oct 25, 2024

Copy link
Copy Markdown
Author

@Zotter I replaced the URL in the gist yesterday when @engineeror pointed that out, I notice that you mentioned the original had one more URLs. Now I don't know if I should restore it! But also, I wondered if things get pruned.

@engineeror

Copy link
Copy Markdown

well in my case i noticed that the blocked IP count doesn't change in transmissiond with https://github.com/Naunter/BT_BlockLists/raw/master/bt_blocklists.gz anymore.
apparently several redirects are now needed via that url to get to the archive and transmissiond doesn't handle this properly i guess.
currently end url is https://raw.githubusercontent.com/Naunter/BT_BlockLists/master/bt_blocklists.gz and with this the blocked IP count is now changing for me again.
idk if transmissiond updates automatically, so i have this:

# /etc/systemd/system/transmission-blocklist-update.service
[Unit]
Description=Update Transmission IP blocklist

[Service]
User=transmission
Group=users
ExecStart=/usr/bin/transmission-remote --blocklist-update

# /etc/systemd/system/transmission-blocklist-update.timer
[Unit]
Description=Update Transmission IP blocklist
Requisite=transmission.service
After=transmission.service

[Timer]
RandomizedDelaySec=30m
OnActiveSec=6h
OnUnitActiveSec=6h

[Install]
WantedBy=transmission.service

@GitTheHellOutaHere

GitTheHellOutaHere commented Mar 18, 2025

Copy link
Copy Markdown

well in my case i noticed that the blocked IP count doesn't change in transmissiond with https://github.com/Naunter/BT_BlockLists/raw/master/bt_blocklists.gz anymore. apparently several redirects are now needed via that url to get to the archive and transmissiond doesn't handle this properly i guess. currently end url is https://raw.githubusercontent.com/Naunter/BT_BlockLists/master/bt_blocklists.gz and with this the blocked IP count is now changing for me again.

Just wanted to say that I've been using the former url for quite a while and it's been updating the blocklist weekly for me. I just did a manual update and the count changed from 453,xxx to 452,834 rules. This suggests the app is able to handle redirects for that url. But since you claim the latter url is more direct, I've gone ahead and used that one.

Transmission 4.0.6

@inspiredearth

Copy link
Copy Markdown

For the record, both URI work for me, and as of today 2025-05-06 both have 455,833 IPs.

By "both URI" I am referring to https://raw.githubusercontent.com/Naunter/BT_BlockLists/master/bt_blocklists.gz and the original URI https://github.com/Naunter/BT_BlockLists/raw/master/bt_blocklists.gz. No issues with either.

@petesimon

Copy link
Copy Markdown

For the record, both URI work for me, and as of today 2025-05-06 both have 455,833 IPs.

By "both URI" I am referring to https://raw.githubusercontent.com/Naunter/BT_BlockLists/master/bt_blocklists.gz and the original URI https://github.com/Naunter/BT_BlockLists/raw/master/bt_blocklists.gz. No issues with either.

thanks. does that block list work in QBittorrent 5.x ?

@DarkSteve

Copy link
Copy Markdown

thanks. does that block list work in QBittorrent 5.x ?

Yep, using it with 5.1 right now.

@JasperLawrence

JasperLawrence commented Sep 12, 2025 via email

Copy link
Copy Markdown

@GitTheHellOutaHere

Copy link
Copy Markdown

It works for Transmission 4.0.6 (38c164933e) as of September 12, 2025, and shows 456,022 IP addresses blocked.

Ditto, using https://raw.githubusercontent.com/Naunter/BT_BlockLists/master/bt_blocklists.gz

T blocklist

@JayBrown

JayBrown commented Oct 9, 2025

Copy link
Copy Markdown

Raw URL still OK as of 2025-10-03

snap

@lkohari

lkohari commented Nov 15, 2025

Copy link
Copy Markdown

It works! Great job, thanks very much!

@momochisoundpost

Copy link
Copy Markdown

Raw URL still doing great as of today (2025-12-13) for Transmission 3.00 (75db68a812) on OS X 10.9 Mavericks

image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment