Skip to content

Latest commit

 

History

History
107 lines (73 loc) · 3.24 KB

README.md

File metadata and controls

107 lines (73 loc) · 3.24 KB
Raw

CI

Facebook adlist remover

Disclaimer: use this repo at your risk.

What does it do?

Businesses will have your info when you use their services (playing games, listening to music...). Then they will upload the info to Facebook and Facebook will use that info to serve you personalized ads.

This repo will help you to:

  • Exclude yourself (opt-out) from business adlist.
  • Hide all ads from the page that served you ads.
  • Remove all interests that FB collected.

By doing this:

  • You will be served unrelated ads.
  • By doing it long enough, you will exclude yourself from every ad wave that Facebook is trying to serve to you.

That means, you will not see any ads for a long time (2-3 months), then they will come back. Run this repo again for 1-2 days, you will see no ads anymore.

This is my experience using this method for more than 3 years and it has been working perfectly for me, but it might not work for you.

Docker

User Guide

Development Guide

Installation

Install dependencies

Python version: >=3.9

python -m pip install -r requirements.txt

Setting up

For Docker container

Generate .env file in the folder:

docker run --rm -it --entrypoint python -v $(pwd)/.env:/app/.env ghcr.io/jackblk/fb-adlist-remover get_cookies_manual.py

Set Env Var or create a file .env in this folder with username/email, password & TOTP Secret Key (if you have 2FA enabled)

FB_EMAIL="email_or_username_here"
FB_PASSWORD="app_password_here"
FB_TOTP_2FA_SECRET="ZYTYYE5FOAGW5ML7LRWUL4WTZLNJAMZS" # TOTP only, base32, no whitespace
# If no email provided, it will use the FB_COOKIES env
FB_COOKIES="your_cookies"

For manual cookies generation (optional)

To generate this step, use python get_cookies_manual.py. To do it manually, create a file .env in this folder, edit the file with your FB cookies.

FB_COOKIES="your_cookies"

Or you can set it to enviroment variables for your OS.

Usage

Generate your cookies manually with python get_cookies_manual.py

Run with Docker:

docker run --rm --pull=always \
    -v $PWD/.env:/app/.env \
    ghcr.io/jackblk/fb-adlist-remover all
Non docker To view all commands & helps, run `python fb_adlist.py`

To run all commands at once:

python fb_adlist.py all

Hide all ads from page

Advertisers will load as a list, by default it will try to hide 2 lists. Use option --count or -c to load more than 2 lists.

python fb_adlist.py del-ad -c 10

You can check the result here: Advertisers

Opt out from business adlist & Removing interests

# Opt-out of business adlist
python fb_adlist.py opt-out
# Remove all interests
python fb_adlist.py rm-interest

Check the result here: Ad settings, Audience-based advertising & Interest categories.