Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/marcelja/facebook-delete

Fast facebook activity deletion
https://github.com/marcelja/facebook-delete

deletion facebook facebook-api scrubber

Last synced: 6 days ago
JSON representation

Fast facebook activity deletion

Awesome Lists containing this project

README

        

# Fast Facebook Activity Deletion

This program can be used to clean up a Facebook account without deleting the entire account.

_Warning: Facebook has some measures in place to prevent high-frequency activity such as the one this tool provides. The current rate limit value has currently been set to 100 ms to avoid detection, but the delay might not be enough and this could still result in your activity log getting temporarily blocked. Please check out the [Rate-limiting](#rate-limiting) section if you want to increase/decrease this delay._

_Note: Facebook has a very strange login process. Please open a GitHub issue if the program is not able to login. Here's a [workaround for the login process](https://github.com/marcelja/facebook-delete/wiki/Login-with-browser-cookie) which you can also use if your account has two-factor authentication enabled._

![Demo](demo.gif)

## Run program

Binaries for Linux, macOS and Windows are attached to a release.

### Download binary

Download the binary file for your platform of the [latest release](https://github.com/marcelja/facebook-delete/releases).

Linux/macOS: Make the binary executable and run it. Example:

```bash
chmod +x deleter-linux
./deleter-linux
```

Windows: Run the .exe file and select "More information" and "Run anyway".

### From source

A recent [Go](https://golang.org/) version needs to be installed. This can be done via your package manager or the golang website.

#### Clone this repository

```bash
git clone https://github.com/marcelja/facebook-delete.git
cd facebook-delete
go install
go run deleter.go
```

## Cookies

Cookies are saved to `$HOME/.go-cookies` if the `$GOCOOKIES` variable is not set (see ).

## Options

### Rate-limiting

Facebook will temp-block your activity log if you make too many requests too quickly. Run the command with the `-rateLimit

Usage examples:

```bash
./deleter-linux -rateLimit 500 # Add a 500 ms delay
./deleter-linux -rateLimit 500 -limitSearch=0 # Add a 500 ms delay, but not to search action
./deleter-linux -rateLimit 500 -limitDelete=0 # Add a 500 ms delay, but not to deletion action
```

### Selection via flags

If you want to skip the manual terminal selection, feel free to use the following flags:

| Flag | Type | Description | Example |
|-------------------|----------|------------------------------------------------------------------------|---------------------------------------------------------|
| -customYears | `string` | Comma-separated years (YYYY) to select. Use `all` to select all years. | `-customYears="2006,2009,2020"` or `-customYears="all"` |
| -customMonths | `string` | Comma-separated months to select. Use `all` to select all months. | `-customMonths="1,2,12` or `-customMonths="01,02,12"` |
| -selectAllContent | `bool` | If set to `true` it will select all content without asking questions. | `-selectAllContent=true` |

_Note: if invalid arguments are passed to the flags, a warning will appear and you will be asked to perform a manual selection._