Skip to content
This repository has been archived by the owner on Dec 1, 2019. It is now read-only.
/ begone Public archive

A fully automatic spamming tool for Facebook Messenger.

License

Notifications You must be signed in to change notification settings

hulloitskai/begone

Repository files navigation

Archive Notice

Due to a change in Facebook's private API that prevents authentication (log-in) from working, this project is archived and will no longer be maintained until further notice.

So long, and thanks for all the fish!

begone

A fully automatic spamming tool, created for the sole purpose of obliterating conversation threads on Facebook Messenger.

Release Go Report Card Travis: Build

Works with individual conversations as well as group threads—a real versatile beast. Uses a modified version of unixpickle/fbmsgr as the underlying Messenger client. And, like all my CLI programs, written in Go.


Project Status:

finished feature-complete

Updates from now on will only be for maintenance. If Facebook's hidden Messenger API is updated drastically, this project will be deprecated. Let's hope that doesn't happen anytime soon!

Features

  • begone emojify – send streams of emojis, en masse
  • begone repeat – keep repeating a message
  • begone file – send a file one line at a time
  • begone image – continually send an image

Usage

Installation

Using Homebrew:

If you're on macOS and have Homebrew, you're in luck! Just run:

brew install stevenxie/tap/begone

This will install begone from the Homebrew tap stevenxie/tap.

Manually:

Grab the latest release compiled for your system.

Ensure that the binary is executable, and place it somewhere in your $PATH. For macOS users, this might look something like this:

$ cd ~/Downloads
$ unzip begone-1.5.2-macOS-x86_64.zip
$ mv begone-1.5.2-macOS-x86_64/begone /usr/local/bin/begone
$ chmod u+x /usr/local/bin/begone

Running

## (Optional) save login credentials to ~/.begone.json.
$ begone login

## Launch an emoji attack on a conversation thread.
$ begone emojify
Enter the target conversation URL (https://messenger.com/t/...):
https://messenger.com/t/exampleid

## See all options.
$ begone help
$ begone help <command>  # i.e. begone help emojify

Advanced Usage

Piping to begone

As of v1.5.0, it is possible to pipe from an external source to begone. This notably allows for integration with dgen, resulting in one of the most destructive command pipelines I have ever seen (which can output at a rate of ~30,000 emojis per second):

dgen "👅" fb | begone repeat --stdin <conversation ID>

Reserve this pipeline for extremely rare occasions. I am not responsible for the extreme amount of damage this might cause if used regularly.

Making from source

This requires the Go language and associated toolchain to be installed. If you're on macOS, this may be as easy as brew install go!

go get -u github.com/stevenxie/begone

FAQ

Will this steal my password?

No. Your password is sent directly to Facebook's servers, as if you were logging in from messenger.com or from Facebook itself.

Don't want to take my word for it? See the code for yourself: begone/pkg/mbot/login.go fbmsgr/auth.go

Will I get banned for using this?

Uhhhh I mean, don't use this too often (and don't leave it running for too long) and you should be fine.

Just... play it safe-ish. Don't abuse this tool too much. The Zucc is always watching 👀.


TODOs

  • (maybe) Implement attacks using local files (images)?
  • Add more emojis to the Emojifier generator.
  • Create different interaction implementations for Windows (the spinners and attack text look kinda funky).
  • Allow for simple piping to begone from an external command / file.