From 35b69544f193fbe9d07a71cca6d5f2ec25e0f2b1 Mon Sep 17 00:00:00 2001 From: Richard Mwewa <74001397+rly0nheart@users.noreply.github.com> Date: Sat, 8 Oct 2022 10:54:29 +0200 Subject: [PATCH] Update README.md --- README.md | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) diff --git a/README.md b/README.md index e69de29..0c6d979 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,71 @@ +# Facebook Downloader + +A program for downloading videos from facebook, given a video url + +# Installation +**Install from PyPI** +``` +pip install facebook-downloader +``` + +### Note +> In order to run the program, You will need to have the FireFox browser installed on your pc +> The program is dependent on selenium, so in order to run it, you will have to download and properly setup geckodriver (setup instructions available below) +>> + +# Geckodriver setup +## Linux +**1. Go to the geckodriver [releases page](https://github.com/mozilla/geckodriver/releases/). Find the latest version of the driver for your platform and download it** + +**2. Extract the downloaded file** +``` +tar -xvzf geckodriver* +``` + +**3. Make it executable** +``` +chmod +x geckodriver +``` + +**4. Add geckodriver to your system path** +``` +export PATH=$PATH:/path/to/downloaded/geckodriver +``` + +### Note +> If you encounter issues with the above commands, then you should run them as root (with sudo) + + +## Windows +**1. Go to the geckodriver [releases page](https://github.com/mozilla/geckodriver/releases/). Find the geckodriver.exe binary for your platform and download it** + +**2. Move the downloaded executable to** *C:\Users\yourusername\AppData\Local\Programs\Python\Python310* + +### Note +> The numbers on the directory 'Python310' will depend on the version of Python you have + +## Mac OS +* [Set up Selenium & GeckoDriver (Mac)](https://medium.com/dropout-analytics/selenium-and-geckodriver-on-mac-b411dbfe61bc) + + +# Usage +``` +facebook_downloader +``` + +### Note +> Upon run, the program will first check for updates. If found, users will be notified about the update + + +# Optional Arguments +| Flag | Description | +|---------|:-----------:| +| *-a/--audio* | download as audio | +| *-o/--output* | output file name | + +# Donations +If you would like to donate, you could Buy A Coffee for the developer using the button below + +Buy Me A Coffee + +Your support will be much appreciated!