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 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
The Dump Contributors Window

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

ExtractFace Dump Vocal Messages 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
5.2.6
  • Fixed:
    • Fixed an issue with Dump friends
    • Fixed an issue with Dump Group members
5.2.5
  • Fixed:
    • Fixed an issue when the Facebook URL was http://web.facebook...
    • Fixed an issue with Dump chat containing emoticon (this bug was introduced in version 5.2.3..., not a feature!)
5.2.4
  • Fixed:
    • Fixed an issue with "public group" in Dump Group Members.
5.2.3
  • New:
    • Archived threads is now supported in Dump chat.
  • Fixed:
    • Fixed many issues with Dump Album.
    • Fixed many issues with include options in Dump chat.
    • Fixed many an issue when destination directory for report contains non-ASCII characters.
5.2.2
  • Fixed:
    • Fixed an issue with Dump Friends where final report was empty.
    • Fixed an issue with Dump Group Members where album names were not gathered at all.
5.2.1
  • Fixed:
    • Fixed an issue with Dump Albums and Dump Chat where page was not parsed correctly.
    • Fixed an issue with Dump Friends where people in Following section (at bottom of each category) were added to the list.
    • Fixed Current Profil ID that should now work for any type of profile.
5.2
  • New:
    • Current Profile ID: Added support for Group and Business page.
    • Dump Chat:
      • Added support for multiples pictures.
      • Added support for multiple attached documents.
    • Dump Friends window is now resizable
  • Fixed:
    • Fixed some issues related to scrolling when using Dump Friends.
    • Fixed an issue with Dump Chat where ExtractFace crash when saving page and content.
    • Fixed some issues related to Emoji in Dump Chat.
5.1
  • New:
    • New Current Profil ID function.
    • Dump Chat:
      • Hide Me option has been removed.
      • Support of animated gif.
    • Dump Group Members:
      • Now support Group profile with tabs.
      • Better support for huge list.
    • Dump Group Albums:
      • Now support Group profile with tabs.
  • Fixed:
    • Dump Chat:
      • Fixed some issues with date.
      • Fixed Load Newer that were not working when there was no more Load Older button.
5.0
  • New:
    • Tray menu: Some functions have been regrouped like Chat and Group.
    • Chat functions: All the chat functions have been rewrited. There are now working with the new Messenger interface.
    • Scroll Contacts: A new scrolling function when the number of contacts is important.
    • Dump Vocal messages: Download all vocal messages from Facebook Mobile.
    • Dump Group Members: Dump members of a Facebook group.
    • HTML report: All HTML report are now build with HTML5. That is particularly interesting to insert video or audio file in a page.
    • Error message: When something goes wrong, a more detailed message will be displayed in a MessageBox (same as it was in the debug log).
  • Fixed:
    • Fixed issues with Dump Albums.
4.5.2
  • Fixed:
    • Fixed issues with Dump Contributors (Comments and Likes).
4.5.1
  • Fixed:
    • Fixed an issue with Dump Albums - Group.
4.5
  • New:
    • Dump Albums - Group: Dump albums from a Facebook Group.
    • Dump Albums: You can now resize window.
    • Dump Albums: New picture size option.
4.4
  • Fixed:
    • Dump Chat: Function was not working properly.
4.3
  • New:
    • Dump Chat: Video as attached document is now supported.
  • Fixed:
    • Dump Chat: When url in Firefox address contained the user ID, but the url associated with the interlocutor contained the username, the HideMe function was not working properly.
4.2
  • New:
    • Dump friends: Three output format are now available: XLSX, HTML and TXT.
    • For all functions: New refresh button.
  • Fixed:
    • Fixed many issues related to "time-out error". These errors happened when trying to parse page with Firefox. I decided to get back to local parsing. Not all issues have been solved, but I'll continue to work on this on next releases.
4.1
  • New:
    • All windows now have a button to browse the destination directory in Windows Explorer.
    • In Settings window, there is now a button to open the log.
  • Fixed:
    • Fixed an issue with Dump Contributors that get stuck when trying to dump from a huge page.
    • Fixed an issue where current page url ends with a #. It is now removed.
    • Fixed an encoding problem with Event Member categories in Dump Event Members window.
4.0
  • New:
    • Now, ExtractFace comes with an installer.
    • Documentation in now online.
    • Scrolling: Now, it's possible to stop scrolling after a given date is reached. It applies to scrolling timeline (for example) and scrolling chat.
    • Dump chat: Window has been rebuild with more options including safe mode and the possibility to dump chat by date.
    • Dump Contributors: Added "Don't scroll Visitor Posts" option
  • Fixed:
    • Fixed a Dump Contributors issue when trying to save a tab that had too much data in it. Now profile icons are downloaded separately.
    • Fixed an issue when filename had non ascii characters in it. Now, the username or the ID is used as filename instead of the title of the page. This applies to Dump Albums, Dump Friends, Dump Contributors and Dump Chat. For Dump Event, the event ID is now used as filename.
    • Fixed encoding problems with friend categories when the Facebook profile is set to another language than english. A new "Charset" option is now available. See Settings for details.
    • Fixed encoding problems with album names that use other language than english. Same solution as friend categories. Also, a part of the album's url is now used as folder name.
    • Fixed some issues about process crash when loading "Dump" windows (all). Now, the process is restarted automatically, except on fatal error.
    • Fixed an issue about program crashing after pressing Cancel button.
    • Fixed some issues with Dump Chat related to modified code in Facebook.
3.0
  • New:
    • Dump Contributors (Comments, Likes, Visitor Posts)
    • Dump album: "HTML album page"
    • Expand option: See Translation
    • Dump friends: Now possible to get all friend categories
    • Dump chat: Added support for vocal messages
    • Dump chat: Added support for other notifications
    • Dump chat: Added support for Shared Links
    • Dump chat: Translation of scrolling links is not required anymore
    • Settings Window has been rebuilded
    • New Debug logging option
    • New max scrolling option
  • Fixed:
    • Fixed scroll and expand issue when scrolled page is huge... Now it scrolls one time, expands, scrolls again, expands, and so on...
    • Fixed dump album issue: some pictures were not downloaded
    • Improved crash recovery
2.0
  • First public release.
  • Now licensed under GPLv3
1.5
  • Dump Albums
    • Video Albums are now supported
  • Dump Friends
    • New option: Include profile icons
  • Dump Chat
    • Fixed an issue in report when the last column contains long word: last column is now wrapped to fit available space
    • Fixed an issue in report when image in full size is the same file as the one in chat: Original width and height are now preserved in the chat
    • Fixed an issue in report for encoding problem with notification
    • Better support of notifications
  • Settings
    • New option: Delete temp files when finished
1.4
  • Dump Chat
    • Fixed some issues related to code change on Facebook.
1.3
  • Dump Chat
    • Download image in full size
1.1
  • Can now be translated
  • Dump Chat
    • New option "Searched part only"
    • Emoticon images is now supported
  • Configuration
    • New tab Chat options
      • Maximum scrolling value
      • Text of scrolling link
1.0 First release. Limited distribution.

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
Spanish mrpnkt 2016-11-03 4.4
French Alain Rioux 2017-02-19 5.2
French Alain Rioux 2017-01-29 5.1
French Alain Rioux 2016-11-07 4.5
German e.to 2017-02-21 5.2
German e.to 2017-01-30 5.1
German e.to 2016-11-14 4.5

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 (It never happened until now, but who knows the future?).
  • 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 (strange bug!).

License

Copyright (C) 2015-2017 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 and binaries are hosted on CodePlex. Source code is also hosted on GitHub.

ExtractFace v5.2.6 with installer Latest release (2017-07-06)
ExtractFace v5.2.6 standalone version Latest release (2017-07-06)

 

Credits to Free Website Templates for the template of this Website