spieglt / fb-delete

Delete your Facebook content by year and category

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Inspiration

Description

First: backup your Facebook data: https://www.facebook.com/help/131112897028467 (recommended, just in case)

Then: You will be prompted for your username, password, the categories of content you'd like to delete, and the year you'd like to delete. A Chrome window will then open to the basic mobile version of Facebook, log you in, navigate to your Activity Log, and start deleting by category and year. You may have to run multiple times to get everything.

None of your data (username, password, or anything else) is sent to me or anywhere other than Facebook's servers. It does not install a browser plugin. This is your computer talking to facebook.com by way of a Node script/Puppeteer. Puppeteer is a Node package developed by Google's Chrome team and allows you to drive a Chrome window programmatically.

SEE WARNINGS IN DISCLAIMER SECTION BELOW

Setup and Use

  • Set your Facebook to use English (US)
  • Install Node.js/NPM: https://nodejs.org/en/download/
  • Download or clone this repo (then unzip to a folder if downloading: https://github.com/spieglt/fb-delete/archive/master.zip)
  • Open your terminal or command prompt or Powershell and navigate to the fb-delete folder
  • Run npm install to install dependencies, wait for it to finish
  • Run npm start, and follow the prompts*
    • The script supports loading FB credentials from a file. To do this copy the sample file cp .env.sample .env and fill it out.

*At the category prompt, use the space bar to select/deselect categories, the up and down arrows to move between them, and the Enter key to proceed. a selects all categories (DANGEROUS! WILL UNFRIEND PEOPLE, DELETE PHOTOS, ETC.), and i inverts the current selection. Same goes for years selection. Navigate to your Activity Log on facebook.com as you normally would, click "Filters", and select a category if you'd like to see the kind of content that will be deleted.

Planned features

  • Output log file
  • Error handling

Also strongly recommended: https://blog.mozilla.org/firefox/facebook-container-extension/

Disclaimer

I accept no responsibility if this program deletes anything you don't want deleted! If this is a concern, do not use this program! All deletions are final!

IF YOU SELECT THE CATEGORY "Added Friends" FOR 2017, IT WILL UNFRIEND EVERY PERSON YOU BECAME FRIENDS WITH IN 2017!

IF YOU SELECT THE CATEGORY "Photos and Videos" FOR 2008, IT WILL DELETE EVERY PHOTO YOU UPLOADED IN 2008! BEWARE!

This is all still probably pretty flaky. It works on my machine, but please leave feedback in Issues on Github if it doesn't work for you and I'll try to help if I can. Thanks for your interest and please check out https://github.com/spieglt/flyingcarpet!

About

Delete your Facebook content by year and category

License:MIT License


Languages

Language:JavaScript 99.7%Language:Shell 0.3%