hulloitskai / veritaserum

Recover unsends (deleted messages) in Messenger conversations.

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 [email protected]: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.

veritaserum's Issues

Does veritaserum mark messages as seen?

Messages seen by ******** in ***************** (GROUP)

I know that this is probably just fbchat logging a seen event by some person in a group, but wanted to make sure that veritaserum doesn't mark messages as seen while operating.

Unsupported operand type(s) for +

File "veritaserum/reporter.py", line 60, in __clean if now > (timestamp + self.maxage): TypeError: unsupported operand type(s) for +: 'datetime.datetime' and 'NoneType'

This occurs in the clean section of the code which prevents cached messages from being deleted. The rest of the script works as intended.