fad 0.0.4

Download an album of photos from facebook

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: [e-mail]
• Github: https://github.com/wuallanx