fbparser 1.0.0

Why?

Facebook exports your messages as one gigantic HTML file. Messages are grouped into individual threads, though chats with a single person are broken up throughout the file, which reads oldest-to-newest. That’s annoying. This fixes that.

Installation

To install via pip, just run:

$ pip install fbparser

To install locally, from the same directory as setup.py, run:

$ python setup.py install

Example use

To export your threads to CSV, from the directory containing messages.htm, run this command:

$ fbparser --csv messages.htm

This will create a directory named fbparser_out/ in your current directory containing your CSV exports. Exports can also be made in JSON or plaintext formats (with --json and `--text), or printed to the console with --stdout

To specify your Facebook name (to remove from filenames), use the --name flag. If you specify your Facebook UID with --uid, that UID will be replaced with the name you specified. For example:

$ fbparser --csv --name="John Smith" --uid="12345@facebook.com" messages.htm

Everywhere 12345@facebook.com is found, it will be replaced with John Smith, which will also be removed from export filenames for clarity.

J Smith=John Smith
12345@facebook.com=John Smith
John H Smith=John Smith

$ fbparser --csv --uid="12345@facebook.com" --name="John Smith" --replace="replace.txt" messages.htm