Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 

WARNING

Using this script may lock out the account you've set up in your configuration file. Use with caution! I'm not responsible for anyone getting locked out of their account; nor is the fbchat library. 😄


Facebook Messenger: Hi-Res Image Downloader

fb-messenger-image-scraper

Simple little script to bulk download high-resolution images from your Facebook Messenger account for a specific chat exchanged between your account and a friend's.

Configuration

Carefully create and configure a config.ini file to your needs under the same directory as this script. Use config.ini.example as a reference guide.

Key-value pairs

  • [Credentials][email]: Your FB account email used for authentication.
  • [Credentials][password]: Your FB account password used for authentication.
  • [Friend][url]: The URL to your friend's FB page.
  • [Threads][search_limit]: Number of threads to look through (from most recent). If the conversation you're looking for is very old, you'll have to increase this number. Otherwise, you'll want to set this to a low value for speed.
  • [Threads][before_date]: (Optional*) Specify a date (in format Y-m-d, i.e. 2019-08-15) from which point to retrieve threads.
  • [Messages][search_limit]: Number of messages to search through for images once the thread with your friend has been found. Again, if the media you want to download is hundreds of messages go, you'll want to increase this value proportionally.
  • [Messages][before_date]: (Optional*) Specify a date (in format Y-m-d, i.e. 2019-08-15) from which point to retrieve messages. For instance, for a given thread, the script will only download images sent in last [Messages][search_limit] starting from the date specified here.
  • [Media][sender_only]: Simple true or false value. If true, only images from your target Friend will be downloaded.
  • [Media][ext_blacklist]: (Optional*) In a comma delimited string, list out extensions you'd like to skip during image attachment download.
  • [Download][path]: Local target path for the images to be downloaded to.

* Note: If not used, leave value after = blank.

Execution

  1. Install Python 3.x
  2. Open cmd (Windows) or terminal (Unix)
  3. Install pip prerequisites: pip install -r requirements.txt
  4. Create and configure config.ini
  5. Execute python ./fbm-scraper.py

About

Helper script to scrape your Facebook Messenger account for images shared in your conversations quickly and efficiently.

Resources

License

Releases

No releases published

Packages

No packages published

Languages