Download an album of photos from facebook
Project description
Facebook Album Downloader - FAD
Download all photos of an album with one-line command
A command-line interface application that you can use to download an album (of a page, a group or an user) from Facebook (on new version since Sep 2020)
Completely FREE for all purposes
✨ FEATURES
- 🚀 Fast: You can download an facebook album of 500 photos in a few minutes. If you have a stable network, you can reduce the timeout option to make it run faster.
- 📦 Minimal: FAD runs on Firefox driver in headless mode (without GUI). In terms of memory and CPU utilizatioon, Firefox is far better and utilizes few resources compare with Chromium browsers.
- 🐶 Easy To Use: FAD read its arguments from the command line. If you are not familiar with CLI (command-line interface), you can create a JSON configuration file. You can use FAD without programming knowledge.
⚔️ INSTALLATION
✈️ Prerequisites
- Install Python 3.9+
- Download latest geckodriver
from the releases page (Linux, MacOS & Windows) and extract excecutable file to
$HOME/.local/bin/geckodriver
(on Windows File Explorer, create a directory named.local.
, with a dot at the end of the directory's name) - Install Firefox Browser if you need to run the script with Debug Mode enabled.
🔧 Install FAD
To install Facebook Album Downloader (FAD), run:
pip install fad
To completely remove FAD, just remove Python (if you want) and executable driver. Finally, just run:
pip uninstall fad
🎮 USAGE
You can run FAD script from command line or use a configuration file formatted in JSON.
Method 1: Download an album from command line
Run fad -h
or see Configurations.md
before following the instructions to configure your download options.
Method 2: Use a configuration file formatted in JSON
The default configuration file located $HOME/.config/fad/config.json
, you can
create a new configuration file following an Example Config File
or see Configurations.md.
Run fad
to run the script with default configuration file.
If you want to use a external configuration file, run
fad -C <path_to_config_file>
.
🤔 FAQ
1. Can FAD download videos?
The answer is NO.
FAD uses Selenium & Python to crawl photos. And it only accepts the url of an album of photos.
2. What is an facebook album URL?
An facebook album is a HTML page that contains a grid of photos.
3. How to get url of an album?
To get the url of an album, watch this Youtube video and follow the instructions.
4. Will I paid for a premium plan or something to use FAD in the future?
No and never. This application is completely free to use, FOREVER.
📝 LICENSE
Copyright © 2021, Allan Wu
This project is GNU GPLv3 license.
📮 CONTACT
- Author: Allan Wu (Dang Minh Ngo)
- Email: wuallanx@gmail.com
- Github: https://github.com/wuallanx
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.