veritaserum

The truth, and nothing but the truth.

veritaserum recover unsends (deleted messages) in Messenger conversations, and sends them to your private Messenger inbox, so that you can catch the sus takebacks in your groupchats. Text, image, and video unsends are all recoverable.

Usage

Running locally, with Python 3.7 (and Pipenv):

$ git clone git@github.com:stevenxie/veritaserum
$ cd veritaserum

$ cat <<EOF > .env
MESSENGER_USERNAME=...
MESSENGER_PASSWORD=...
VERITASERUM_DEBUG=1
EOF

$ pipenv run python veritaserum

Or, in a container with Docker:

$ docker run -it --rm \
    -e MESSENGER_USERNAME=... \
    -e MESSENGER_PASSWORD=... \
    -e VERITASERUM_DEBUG=1 \
    stevenxie/veritaserum

Sessions

If you're running veritaserum as a daemon (a long-running process) on a remote server, consider using a stored session. This will allow you to bypass having to enter 2FA information whenever veritaserum starts.

To create a session dump, use the tool ./util/dumpsesh.py:

$ pipenv run python ./util/dumpsesh.py
# enter 2FA details when prompted

Then, encode the outputed JSON to base64:

$ echo '{ ... }' | base64

eyJoZXkiLCAidGhpcyBpcyBhIGR1bW15IGZpbGUgbG1hbyJ9...

And set it as the value for the environment variable MESSENGER_SESSION.