ExtractFace

What is it

Investigators, researchers or other analysts often have to get local copies of Facebook data. It can be necessary for a lot of reasons like submitting Facebook data as evidence, doing advanced offline analysis, etc. But Facebook interface has not been designed for that and does not provide printing or saving functions. Even for a user that want a copy of a conversation in his profile, there is no simple solution.

ExtractFace has been designed to help people to extract data from Facebook. It provides usefull functions to automate a lot of tasks that have to be done manually otherwise. See documentation for more details.

Screenshots

The Dump Albums Window

ExtractFace Dump Albums Windows
Click image to view in full size
The Dump Friends Window

ExtractFace Dump Friends Windows
Click image to view in full size
The Dump Contributors Window

ExtractFace Dump Contributors Windows
Click image to view in full size
The Dump Comments Window

ExtractFace Dump Comments Windows
Click image to view in full size
The Dump Event Members Window

ExtractFace Dump Event Members Windows
Click image to view in full size
The Dump Group Members Window

ExtractFace Dump Group Members Windows
Click image to view in full size
Dump Friends Sample Report

Dump Friends Sample Report
Click image to view in full size
Dump Chat Sample Report

Dump Chat Sample Report
Click image to view in full size

How it works

ExtractFace can be installed using the installer or used as a standalone application. In order to start using it, just run the executable file from the start menu or the directory you install it.

While running, you can access functions by right clicking the ExtractFace tray icon in the taskbar. I recommend you to customize your taskbar to make this tray icon always visible. If you don't know how to do it, look at this page: How to Customize and Tweak Your System Tray Icons in Windows.

ExtractFace uses MozRepl add-on* to automate Mozilla Firefox browser. So you can crawl Facebook as normal with Firefox and use ExtractFace to automate some annoying things like scrolling or clicking in order to get additional content. When the content is fully loaded in your browser, you can print to PDF, capture screen, or use ExtractFace again to dump the data in a usefull way. Be aware that you better should not use Firefox when a ExtractFace function is running.

What do you need

Version History

Version Comments
6.3.4
  • Fixed:
    • Updated code for listing album names in Dump Album.
    • Updated code for listing friend categories in Dump Friends.
    • Fixed scrolling bug with Dump group members.
    • There was an issue with XLSX report format when a category name (friends or albums) contained more than 31 characters (Excel limitation). The name (used for the sheet) will now be truncated if necessary.
6.3.3
  • Fixed:
    • Updated code for Dump Group Members.
6.3.2
  • Fixed:
    • Updated code for listing album names in Dump Album.
    • There was an issue when ExtractFace was installed on a system, but executed with a different user without admin rights. It should now create a user directory in AppData, if program directory is not writable and if there is no ExtractFace directory in AppData.
6.3.1
  • New:
    • For all dump functions, destination directory is removed when opening window if it doesn't exist.
  • Fixed:
    • Update code for parsing images in Dump chat.
    • Update code for remove functions.
6.3
  • New:
    • A new Dump Comments function.
    • A new Remove Comments function.
  • Fixed:
    • There was an issue when setting timezone in Dump chat.
    • There were some issues with Dump Contributors.
    • Facebook change in Album page for people profile.
    • Expand is now more aggressive.
    • There was an issue when trying to load the right page for public group (Dump Group Members).
6.2
  • New:
    • Messenger: Two new functions:
      • Open Current Chat - Mobile Facebook
      • Dump Vocal Messages - Mobile Facebook
    • In Dump Contributors, you can now dump contributors from all picture pages. This function is available for people profile only.
  • Fixed:
    • In Dump Chat, there was a problem with timezone.
6.1.3
  • Fixed:
    • In Dump Albums with people profile, Get Album title was not working.
    • In Dump Albums, dumping videos was not working.
    • In Dump Chat, dumping vocal messages was not working when chat name was different in Mobile Facebook.
6.1.2
  • Fixed:
    • Many Remove functions were not working after some changes in Facebook code.
    • In Dump Chat, pictures with Shared link were all dowloaded using the same filename (replaced).
6.1.1
  • Fixed:
    • Album page for a person profile have changed. It should work as normal now.
    • Dot used in filename seems to create problem when used as directory name. It is removed now.
6.1
  • New:
    • Remove section in tray menu: These functions that will help you to remove sections in a page, so you will be able to print scrollable area from different page like profile timeline, group profile, business page, event page, etc. With these functions, you can remove top (the Facebook blue bar on top), left column, right column, bottom or all at once.
    • Dump Contributors:
      • You can now dump Event Posts contributors.
      • You can now dump Visitor or Event Posts, comments and likes at the same time (if available on the page).
      • Include icons is now faster (I mean really faster!)
    • Dump Event members:
      • Like in Dump Contributors, Include icons is now faster.
6.0.1
  • Fixed:
    • Error message was displayed when trying to show main menu (from tray icon), if dynamic menu was activated and MozRepl was not started.
    • In Dump Albums window, interface was not updated when report format was changed.
6.0 This is the biggest update since the first release. Here are the new features:

  • Separate process for dumping: When it's time to dump, ExractFace now use a separate process to prevent a process to block the whole program.
  • Queue: You can now queued multiple dump processes and start in one shot.
  • All dump functions have three report formats: XLSX, HTML and TXT (TSV): For XLSX and HTML, the ExtractFace version is inserted in metadata.
  • New Dump Mutual Friends function
  • Messenger
    • Dump Chat: In Dump Chat, you can now leverage the power of the queue and select multiple conversations to dump.
    • Dump Chat now support conversations with multiples participants.
    • Dump Vocal Messages is now included in Dump Chat.
    • New Dump Contacts function
  • Dump Albums
    • The Dump Albums can be use for any profile types (people, page and group).
    • You can download small AND large picture size, but medium size has been removed.
    • You can also dump picture and video URLs only.
    • Dumping videos is now supported for Group profiles.
    • Gather Album URLs from multiple pages (used in Group profiles) is now supported.
  • New options in Settings
    • Dynamic menu: Available functions in main menu are enabled or disabled, based on the current page you are.
    • Clear log function
    • Load and scroll automatically: In past releases, ExtractFace was trying to find the page associated to the chosen Dump function. You can now disable it.
    • Remember folder used for report is now a global option.
    • Silent progression when using queue
    • Open report when finished is now a global option.
    • Disable opening report when using queue
    • Close used tabs: After dumping, ExtractFace will close any opened tabs in Firefox.
See Changes.txt for older releases.

Translation

To translate ExtractFace to other languages:

  1. In Settings window, use the Export Lang.ini function. The file will be saved in the same directory of the tool;
  2. Open the file in any text editor like Notepad;
  3. Translate each expression at the right of the = symbol;
    • The expression on the left side is used by the tool to identify the expression so do not change it. Also, be sure to have a space between the = symbol and your expression (ex. Key = Value);
    • Authorized characters are alphanumerics, spaces and these symbols: ",", ".", "-", "!", ",", "(" and ")". Any other character will be deleted;
    • For some controls, string length must be the same as original. A longer string could be truncated if it doesn't match the length of the field;
    • The value associated with the translatorName will be used in the About window to identify you as translator (if you want). You can also add your email or a short url (ex. YourName (youraddress@email.com));
  4. Restart the tool so the strings in Lang.ini will be used instead of the default language.

If you translate the tool and you want to share, contact the author.

Available translations:

To install, save the appropriate Lang.ini file in the default folder of the tool (if you used the installer, it should be AppData. Otherwise, it's the same folder of the program).

Language Translated By Date For Version
French Alain Rioux 2017-12-04 6.3
French Alain Rioux 2017-11-26 6.2
French Alain Rioux 2017-08-20 6.1
French Alain Rioux 2017-02-19 5.2
German e.to 2017-11-27 6.3
German e.to 2017-11-27 6.2
German e.to 2017-10-28 6.1
German e.to 2017-02-21 5.2

Known Problems

  • ExtractFace is an experimental tool that has to be often updated to follow any change in Facebook code.
  • ExtractFace may also be affected by any updates to Mozilla Firefox or the MozRepl add-on.
  • Encoding problems. See Settings for details.
  • The good working of ExtractFace depends on your computer and network latency (which include your Mozilla Firefox), the Internet latency in general and the Facebook latency. ExtractFace tries to deal with that, but this may be an unpredictable problem. For example, when ExtractFace scrolls a page to the bottom, it checks if it reaches the bottom after each scroll. But even if it waits a few seconds, the page could still be loading at the moment ExtractFace do its check. So, ExtractFace will wait a few seconds more and double-check in order to be sure there is no more content. But even after all of this precautions, it may be still possible that the page is not fully loaded, so you should check by yourself again if you are not sure.
  • FAT32: Some fonctions or options (ex.: Include profile icons) will not work properly if you select a FAT32 volume as the destination directory (FAT32 doesn't support UTF8 in filename).

License

Copyright (C) 2015-2018 Alain Rioux (le-tools.com)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Feedback

If you have any problem, suggestion, comment, or you found a bug in the utility, contact the author.

Credits

  • The main logo of ExtractFace have been created by Land-of-Web (http://www.land-of-web.com) and distributed as freeware.
  • Most of icons come from the Blue Bits collection of Icojam and are licensed as "Public Domain".
  • The icon used for open folder button comes from Basic Icons by PixelMixer and is distributed as Freeware.
  • The "Dump chat window" logo has been created by Tristan Edwards and is distributed as freeware.
  • The "Open folder in Explorer" icon comes from Danish Royalty Free Icons by Jonas Rask Design. This icon is distributed as Freeware.
  • The "Refresh" icon has been created by FamFamFam (Mark James) and is distributed on term of the CC Attribution 4.0 license.

Download

Source code is hosted on SourceForge and GitHub. Binaries are hosted on SourceForge.

Download 
			ExtractFace

If you want to download the standalone version or an older version, check on SourceForge.

 

Credits to Free Website Templates for the template of this Website