ExtractFace Documentation

Using ExtractFace

  1. You must start Google Chrome in remote debug mode. I suggest you to create a shortcut on your desktop. You must add the string --remote-debugging-port=9222 in the target field.
  2. Login to your profile;
  3. Go to your target profile;
  4. Right-click on ExtractFace taskbar icon to popup the menu.
Menu

Dump Albums

This function can be use to gather all (or selected) albums of photos. It works with any type of profile that may contain albums like people, page and group profiles.

DumpAlbumsWindow

When you select this function, ExtractFace:

  1. Displays the Dump albums window (as shown above)
  2. Checks if you are in the right page:
    • If you are not in the right page: If you selected Load and scroll automatically in Settings, ExtractFace will load it for you. Otherwise, it will display an error message.
  3. When you are in the right page, ExtractFace determine the profile type, get the username (or the userid) to propose it as filename. Then, it load the available albums.

Available options are:

  • Report format: You have three choices: XLSX, HTML and TXT (TSV). Default is HTML. XLSX and TXT (TSV) are good choices if you only want the URLs or the number of albums is too big to be displayed on a single page.
  • Open album folder: At the end of the process, the folder where the album have been saved will be opened in Window Explorer.
  • Small pictures: Download the small picture (the one in the album page).
  • Large pictures: To get the large image, ExtractFace must open the page of each picture and wait for the image to load.
  • Publication date: If you select this option, ExtractFace will gather the date that the photo or video has been published.

ExtractFace will create a directory for each album selected and download all the images from that album. The HTML report contain all albums with the small pictures. You can click on any small picture to get the large picture. You must know that if you don't download the pictures, they will be displayed in the HTML report, but as links. Download of videos is not supported actually.

Top of the page

Dump Friends

This function can be use to gather all friend lists (or selected) of a profile. It produces a report that contains details of profile's friends.

DumpFriendsWindow

When you select this function, ExtractFace:

  1. Displays the Dump friends window (as shown above)
  2. Checks if you are in the right page:
    • If you are not in the right page: If you selected Load and scroll automatically in Settings, ExtractFace will load it for you. Otherwise, it will display an error message.
  3. When you are in the right page, ExtractFace get the username (or the userid) to propose it as filename. Then, it load the available friend lists.

Available options are:

  • Report format: You have three choices: XLSX, HTML and TXT (TSV). Default is XLSX (see sample below). HTML is a good choice if you want to print the profiles. Note that XLSX format could crash ExtractFace if too much images have to be inserted in a workbook.
  • Include profile icons: Image of profiles are included in the report. For HTML format, profile icon are always included, but if you check this option, images will be save locally instead of links. If you have problems, you can use HTML format without checking this option. Then, when you open the report, you can use "Save as" in Chrome to save profile icon locally. You'll have to do this for each page. The option is not available for TXT format.

The XLSX report will look like this:

DumpFriendsSample

Top of the page

Dump Mutual Friends

This function can be used to get the friends from a mutual friends page. The report is similar to Dump Friends.

DumpMutualFriendsWindow

Available options are:

  • Report format: You have three choices: XLSX, HTML and TXT (TSV). Default is XLSX. HTML is a good choice if you want to print the profiles. Note that XLSX format could crash ExtractFace if too much images have to be inserted in a workbook.
  • Include profile icons: Image of profiles are included in the report. For HTML format, profile icon are always included, but if you check this option, images will be save locally instead of links. If you have problems, you can use HTML format without checking this option. Then, when you open the report, you can use "Save as" in Chrome to save profile icon locally. You'll have to do this for each page. The option is not available for TXT format.
  • Autoscroll: You can scroll the page manually before using this function or you can select this option. If you do it, the page will be scrolled at the moment of the dump. This is particularly important if you use the Queue.
Top of the page

Dump Contributors

This function can be used to list all persons that contribute to a particular page. It can be used on any page that contains comments and/or Likes. For people profile, ExtractFace can browse picture pages and gather all contributors.

DumpContribWindow

This function produce the same kind of report than Dump Friends, but there is an additional column, that contains the number of times a contributor is found. It can be used to determine who are the biggest contributor to a particular page. Types of contributors are:

  • Comments: All person that post a comment on the page. It includes replies.
  • Likes: Any types of Likes. This one should be the slowest, because ExtractFace has to open a page for every group of Likes.

Available options are:

  • Report format: You have three choices: XLSX, HTML and TXT (TSV). Default is XLSX. HTML is a good choice if you want to print the profiles.
  • Include profile icons: Image of profiles are included in the report. For HTML format, profile icon are always included, but if you check this option, images will be save locally instead of links.
  • Auto scroll: If you select this option, the page will be scrolled and expanded. Note also that Likes pages are always scrolled when dumping.

When you click on Picture pages option, ExtractFace load the album page of the profile to gather the album names and urls.

Top of the page

Dump Comments

This function can be used dump all comments posted on a particular page. It can be used on any page that contains comments. For people profile, ExtractFace can browse picture pages and gather comments on those pages too.

DumpCommentsWindow

Available options are:

  • Report format: You have three choices: XLSX, HTML and TXT (TSV). Default is HTML.
  • Include Images: This includes image of profiles, but also images inside each comment. For HTML format, images are always included, but if you check this option, they will be save locally instead of links.
  • Auto scroll: If you select this option, the page will be scrolled and expanded.

When you click on Picture pages option, ExtractFace load the album page of the profile to gather the album names and urls.

Top of the page

Dump Group Members

This function can be used to list all the members of a group. The report is similar to Dump Friends.

DumpGMWindow

When you select this function, ExtractFace:

  1. Displays the Dump Group Members window (as shown above)
  2. Checks if you are in the right page:
    • If you are not in the right page: If you selected Load and scroll automatically in Settings, ExtractFace will load it for you. Otherwise, it will display an error message.
  3. When you are in the right page, ExtractFace get the username (or the userid) to propose it as filename. Then, it load the available lists.

Available options are:

  • Report format: You have three choices: XLSX, HTML and TXT (TSV). Default is XLSX. HTML is a good choice if you want to print the profiles. Note that XLSX format could crash ExtractFace if too much images have to be inserted in a workbook.
  • Include profile icons: Image of profiles are included in the report. For HTML format, profile icon are always included, but if you check this option, images will be save locally instead of links. If you have problems, you can use HTML format without checking this option. Then, when you open the report, you can use "Save as" in Chrome to save profile icon locally. You'll have to do this for each page. The option is not available for TXT format.
  • Auto scroll: You can scroll the page manually before using this function or you can select this option. If you do it, the page will be scrolled at the moment of the dump. This is particularly important if you use the Queue.

Queue

The queue allows you to batch multiple dump processes and start them all at the same time.

When you use a dump function, ExtractFace build a database that contains all the selected parameters and start a new ExtractFace process that is independant from the main program. This new process loads the database and executes the dumping process while the main program is waiting (to prevent that more than one process run at the same time).

When you click the Add to queue button instead of the Dump Now button, the database is still created, but the process is not started. Instead, it is queued.

QueueWindow

All databases are stored in a Queue subfolder in the user directory. The Queue window (as shown above) contain the filename of the database ([DumpFonction]-[Unixtime]), the filename for the report and the starting url associated to the dump process.

You can delete any of the process from the queue by right clicking on it and selecting the appropriate function.

While a process is running, the database associated with it is updated to indicates the current status of the process and the data that has been collected so far. If the process crashes, it can be restarted manually by restarting the main program.

When ExtractFace starts, it look for any pending job in the queue. This can be a job that hasn't been started yet, or a job that crashed. Whatever reason, ExtractFace will ask you to load or delete all the remaining database in queue.

Top of the page

Settings

There are a few parameters that can be set in ExtractFace.

General options

SettingsWindow

In Tool section, we have the following functions and options:

  • Export Lang.ini: Use this function to translate ExtractFace GUI. See Translation for help about this functionality.
  • Open user dir: This is the directory where settings are saved. Copy the content of this directory if you want to backup your settings.
  • Check Update: Check on le-tools.com if a tool update is available.
  • Check for update at startup: When ExtractFace starts, check on website for available update of the tool.

In Functions section, you have:

  • Remember position of all windows: By default, every windows are centered in your main screen. If you use multiple monitor, it can be useful to have ExtractFace on the same screen as Chrome. Use this option to remember the position of any window. Position is saved when the window is closed.
  • Time for loading: Time to wait when a page (or new content) must be loaded in Chrome. Default value is 2 seconds. As ExtractFace must often gather content from internet, it can be affected by network latency.
  • Charset: ExtractFace supports UTF8 (used on Facebook) internally, but the interface (Win32-GUI) doesn't support it. So, in some cases (ex.: Friends categories, album names, etc.), it may be a problem. Sometime, the charset will depend on the language of your profile and sometime, it will depend on the language of the target profile. To deal with that, ExtractFace supports different charsets. Default is cp1252.
  • Logging: Logging can be useful for troubleshooting. When enabled, all errors are stored in a file in the user directory.


Dump options

SettingsWindow2

These options are related to the dump functions.

  • When loading:
    • Load and scroll automatically: If you check this option, ExtractFace will automatically load the page associated with the dump function you called. For example, if you selected Dump Albums, the page that contains all albums will be opened, as long as the page exists. Then, ExtractFace will scroll the page if necessary. Disable this option if you want to select the page manually or want to dump only a part of a page.
    • Scroll back to top when loaded: When a page is fully loaded (using automatic scrolling), it will scroll back to top.
    • Remember folder used for report: In each dump window, you must select a directory where the report and downloaded files will be saved. If you select this option, the report will be automatically saved.
  • When processing:
    • Silent progression when using queue: When you are using Queue, it usually means you want to do something else while the process running. If you select this option, the progress window will start minimized and there will be no popup about error or success. You should use Logging, if you want to keep information about errors. You should also check Disable opening when using queue (see below).
  • When finished:
    • Open report: The report is opened with the default program (associated with the extension of the report format) when the dumping process is finished.
    • Disable opening when using queue: If you started a Queue with many tasks in it, it could be a problem to see files be constantly opened.
    • Delete temp files when finished: When ExtractFace saves data, it uses a temp directory, usually in the same directory as the report. If this option is checked, the temp directory is deleted when function ends.
Top of the page

 

Credits to Free Website Templates for the template of this Website