This tool lets you download all of the Facebook photos that you are tagged in. It keeps track of the dates that each photo was uploaded to Facebook, so that your photos will still be organized by date when they are added to a photo management platform like Google Photos or iPhoto.
You'll need to have python, pip3, and Google Chrome WebDriver installed to use this tool. Once that's all set up:
- Clone this repository
cdinto the cloned folder- Run
pip install -r requirements.txt
To download your tagged photos, run this with your Facebook username & password:
python get-tagged-photos.py -u your@email.com -p yourpassword
You should see Chrome open, login to Facebook, navigate to your photos page, and indexing your tagged photos & videos. Once the indexing is complete, it will download all of the photos to a photos folder that should appear in the same folder as the script.
If you just want to create an index of the photos so you can see the data, add the --index flag:
python get-tagged-photos.py --index -u your@email.com -p yourpassword
If you already have the index and want to download the images again, you can run the script in download-only mode like this:
python get-tagged-photos.py --download
The credentials are not needed for download-only mode because Facebook lets anyone access the photos once you have the direct URL to the photo. Facebook can expire a URL after some time though, so if there are any issues with the downloading, try indexing again first to make sure the script has the latest photo URLs.
This script works by first creating an index of all the photos that you are tagged in with:
- Date the photo was uploaded
- Photo description (caption)
- Names tagged in the photo
- Facebook URL of the photo page
- Photo URL to the actual image
- Name, Profile URL, and user ID of the person who uploaded the photo
All of this metadata is only stored on your computer, and you can see it in tagged.json. Once the indexing process is complete, the script will then download all of the photos to your computer, and then use this index to write the metadata to them so that it's safe with the photo file.
Wanted to give a shoult to the good folks who contribute pull requests to improve this project. Thank you!
@nhwalton @mbologna @KyleKing