mirror of
https://github.com/bellingcat/facebook-downloader.git
synced 2026-06-11 04:58:30 +03:00
Compare commits
51 Commits
2022.1.0.0
...
1.3.1
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ddd14c151d | ||
|
|
18213172aa | ||
|
|
99dc9e3ea7 | ||
|
|
1126a72a9f | ||
|
|
de660b30f4 | ||
|
|
07bf9a0220 | ||
|
|
0a8454fcf9 | ||
|
|
8abc59474b | ||
|
|
885676d826 | ||
|
|
59d8a30d85 | ||
|
|
fa12e7e477 | ||
|
|
d38eb6aefe | ||
|
|
eda82c051d | ||
|
|
e1c15ddb0f | ||
|
|
47844da5b8 | ||
|
|
aebb6f0e65 | ||
|
|
37e028c769 | ||
|
|
a65a1f65d5 | ||
|
|
864f80921e | ||
|
|
b1760aad56 | ||
|
|
52df5b63ae | ||
|
|
8097d273bd | ||
|
|
1f008f71fc | ||
|
|
d9c4666db9 | ||
|
|
de55a6a803 | ||
|
|
066ab0e824 | ||
|
|
8195f4a363 | ||
|
|
576e3f6bdb | ||
|
|
9ad3deb9f8 | ||
|
|
8fb3ae15f9 | ||
|
|
6ad5e5f512 | ||
|
|
1df1d5c600 | ||
|
|
c5fa0be4d1 | ||
|
|
35b69544f1 | ||
|
|
2e7269fe12 | ||
|
|
a5149c3048 | ||
|
|
f86b007aab | ||
|
|
7f9ab313a8 | ||
|
|
751f4bba62 | ||
|
|
a00d78b114 | ||
|
|
163fe48e88 | ||
|
|
3f246bd5b9 | ||
|
|
569881cf4b | ||
|
|
4031c206f8 | ||
|
|
e3b94b0871 | ||
|
|
875bae98b7 | ||
|
|
550610cbc1 | ||
|
|
2bad245ae7 | ||
|
|
cec70c0600 | ||
|
|
d734cba88c | ||
|
|
7cf8a2f74c |
38
.github/ISSUE_TEMPLATE/bug_report.md
vendored
Normal file
38
.github/ISSUE_TEMPLATE/bug_report.md
vendored
Normal file
@@ -0,0 +1,38 @@
|
||||
---
|
||||
name: Bug report
|
||||
about: Create a report to help us improve
|
||||
title: ''
|
||||
labels: ''
|
||||
assignees: ''
|
||||
|
||||
---
|
||||
|
||||
**Describe the bug**
|
||||
A clear and concise description of what the bug is.
|
||||
|
||||
**To Reproduce**
|
||||
Steps to reproduce the behavior:
|
||||
1. Go to '...'
|
||||
2. Click on '....'
|
||||
3. Scroll down to '....'
|
||||
4. See error
|
||||
|
||||
**Expected behavior**
|
||||
A clear and concise description of what you expected to happen.
|
||||
|
||||
**Screenshots**
|
||||
If applicable, add screenshots to help explain your problem.
|
||||
|
||||
**Desktop (please complete the following information):**
|
||||
- OS: [e.g. iOS]
|
||||
- Browser [e.g. chrome, safari]
|
||||
- Version [e.g. 22]
|
||||
|
||||
**Smartphone (please complete the following information):**
|
||||
- Device: [e.g. iPhone6]
|
||||
- OS: [e.g. iOS8.1]
|
||||
- Browser [e.g. stock browser, safari]
|
||||
- Version [e.g. 22]
|
||||
|
||||
**Additional context**
|
||||
Add any other context about the problem here.
|
||||
8
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
8
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
@@ -0,0 +1,8 @@
|
||||
blank_issues_enabled: false
|
||||
contact_links:
|
||||
- name: Richard Mwewa (Telegram)
|
||||
url: https://t.me/rly0nheart/
|
||||
about: Please ask and answer questions here.
|
||||
- name: Richard Mwewa (Twitter)
|
||||
url: https://m.twitter.com/rly0nheart/
|
||||
about: Please report security vulnerabilities or bugs here.
|
||||
20
.github/ISSUE_TEMPLATE/feature_request.md
vendored
Normal file
20
.github/ISSUE_TEMPLATE/feature_request.md
vendored
Normal file
@@ -0,0 +1,20 @@
|
||||
---
|
||||
name: Feature request
|
||||
about: Suggest an idea for this project
|
||||
title: ''
|
||||
labels: ''
|
||||
assignees: ''
|
||||
|
||||
---
|
||||
|
||||
**Is your feature request related to a problem? Please describe.**
|
||||
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
|
||||
|
||||
**Describe the solution you'd like**
|
||||
A clear and concise description of what you want to happen.
|
||||
|
||||
**Describe alternatives you've considered**
|
||||
A clear and concise description of any alternative solutions or features you've considered.
|
||||
|
||||
**Additional context**
|
||||
Add any other context or screenshots about the feature request here.
|
||||
13
.github/dependabot.yml
vendored
Normal file
13
.github/dependabot.yml
vendored
Normal file
@@ -0,0 +1,13 @@
|
||||
# To get started with Dependabot version updates, you'll need to specify which
|
||||
# package ecosystems to update and where the package manifests are located.
|
||||
# Please see the documentation for all configuration options:
|
||||
# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
|
||||
|
||||
version: 2
|
||||
updates:
|
||||
# Enable version updates for pip
|
||||
- package-ecosystem: "pip"
|
||||
directory: "/" # Location of package manifests
|
||||
# Check the tqdm registry for updates every day (weekdays)
|
||||
schedule:
|
||||
interval: "daily"
|
||||
74
.github/workflows/codeql.yml
vendored
Normal file
74
.github/workflows/codeql.yml
vendored
Normal file
@@ -0,0 +1,74 @@
|
||||
# For most projects, this workflow file will not need changing; you simply need
|
||||
# to commit it to your repository.
|
||||
#
|
||||
# You may wish to alter this file to override the set of languages analyzed,
|
||||
# or to provide custom queries or build logic.
|
||||
#
|
||||
# ******** NOTE ********
|
||||
# We have attempted to detect the languages in your repository. Please check
|
||||
# the `language` matrix defined below to confirm you have the correct set of
|
||||
# supported CodeQL languages.
|
||||
#
|
||||
name: "CodeQL"
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [ "master" ]
|
||||
pull_request:
|
||||
# The branches below must be a subset of the branches above
|
||||
branches: [ "master" ]
|
||||
schedule:
|
||||
- cron: '16 14 * * 6'
|
||||
|
||||
jobs:
|
||||
analyze:
|
||||
name: Analyze
|
||||
runs-on: ubuntu-latest
|
||||
permissions:
|
||||
actions: read
|
||||
contents: read
|
||||
security-events: write
|
||||
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
language: [ 'python' ]
|
||||
# CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
|
||||
# Learn more about CodeQL language support at https://aka.ms/codeql-docs/language-support
|
||||
|
||||
steps:
|
||||
- name: Checkout repository
|
||||
uses: actions/checkout@v3
|
||||
|
||||
# Initializes the CodeQL tools for scanning.
|
||||
- name: Initialize CodeQL
|
||||
uses: github/codeql-action/init@v2
|
||||
with:
|
||||
languages: ${{ matrix.language }}
|
||||
# If you wish to specify custom queries, you can do so here or in a config file.
|
||||
# By default, queries listed here will override any specified in a config file.
|
||||
# Prefix the list here with "+" to use these queries and those in the config file.
|
||||
|
||||
# Details on CodeQL's query packs refer to : https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
|
||||
# queries: security-extended,security-and-quality
|
||||
|
||||
|
||||
# Autobuild attempts to build any compiled languages (C/C++, C#, or Java).
|
||||
# If this step fails, then you should remove it and run the build manually (see below)
|
||||
- name: Autobuild
|
||||
uses: github/codeql-action/autobuild@v2
|
||||
|
||||
# ℹ️ Command-line programs to run using the OS shell.
|
||||
# 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
|
||||
|
||||
# If the Autobuild fails above, remove it and uncomment the following three lines.
|
||||
# modify them (or add more) to build your code if your project, please refer to the EXAMPLE below for guidance.
|
||||
|
||||
# - run: |
|
||||
# echo "Run, Build Application using script"
|
||||
# ./location_of_script_within_repo/buildscript.sh
|
||||
|
||||
- name: Perform CodeQL Analysis
|
||||
uses: github/codeql-action/analyze@v2
|
||||
with:
|
||||
category: "/language:${{matrix.language}}"
|
||||
39
.github/workflows/python-app.yml
vendored
39
.github/workflows/python-app.yml
vendored
@@ -1,39 +0,0 @@
|
||||
# This workflow will install Python dependencies, run tests and lint with a single version of Python
|
||||
# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
|
||||
|
||||
name: Python application
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [ "master" ]
|
||||
pull_request:
|
||||
branches: [ "master" ]
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
|
||||
jobs:
|
||||
build:
|
||||
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
- name: Set up Python 3.10
|
||||
uses: actions/setup-python@v3
|
||||
with:
|
||||
python-version: "3.10"
|
||||
- name: Install dependencies
|
||||
run: |
|
||||
python -m pip install --upgrade pip
|
||||
pip install flake8 pytest
|
||||
if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
|
||||
- name: Lint with flake8
|
||||
run: |
|
||||
# stop the build if there are Python syntax errors or undefined names
|
||||
flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
|
||||
# exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
|
||||
flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
|
||||
- name: Test with pytest
|
||||
run: |
|
||||
pytest test_download_video.py
|
||||
39
.github/workflows/python-publish.yml
vendored
Normal file
39
.github/workflows/python-publish.yml
vendored
Normal file
@@ -0,0 +1,39 @@
|
||||
# This workflow will upload a Python Package using Twine when a release is created
|
||||
# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
|
||||
|
||||
# This workflow uses actions that are not certified by GitHub.
|
||||
# They are provided by a third-party and are governed by
|
||||
# separate terms of service, privacy policy, and support
|
||||
# documentation.
|
||||
|
||||
name: Upload Python Package
|
||||
|
||||
on:
|
||||
release:
|
||||
types: [published]
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
|
||||
jobs:
|
||||
deploy:
|
||||
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
- name: Set up Python
|
||||
uses: actions/setup-python@v3
|
||||
with:
|
||||
python-version: '3.x'
|
||||
- name: Install dependencies
|
||||
run: |
|
||||
python -m pip install --upgrade pip
|
||||
pip install build
|
||||
- name: Build package
|
||||
run: python -m build
|
||||
- name: Publish package
|
||||
uses: pypa/gh-action-pypi-publish@27b31702a0e7fc50959f5ad993c78deac1bdfc29
|
||||
with:
|
||||
user: __token__
|
||||
password: ${{ secrets.PYPI_API_TOKEN }}
|
||||
129
.gitignore
vendored
129
.gitignore
vendored
@@ -1,129 +0,0 @@
|
||||
# Byte-compiled / optimized / DLL files
|
||||
__pycache__/
|
||||
*.py[cod]
|
||||
*$py.class
|
||||
|
||||
# C extensions
|
||||
*.so
|
||||
|
||||
# Distribution / packaging
|
||||
.Python
|
||||
build/
|
||||
develop-eggs/
|
||||
dist/
|
||||
downloads/
|
||||
eggs/
|
||||
.eggs/
|
||||
lib/
|
||||
lib64/
|
||||
parts/
|
||||
sdist/
|
||||
var/
|
||||
wheels/
|
||||
pip-wheel-metadata/
|
||||
share/python-wheels/
|
||||
*.egg-info/
|
||||
.installed.cfg
|
||||
*.egg
|
||||
MANIFEST
|
||||
|
||||
# PyInstaller
|
||||
# Usually these files are written by a python script from a template
|
||||
# before PyInstaller builds the exe, so as to inject date/other infos into it.
|
||||
*.manifest
|
||||
*.spec
|
||||
|
||||
# Installer logs
|
||||
pip-log.txt
|
||||
pip-delete-this-directory.txt
|
||||
|
||||
# Unit test / coverage reports
|
||||
htmlcov/
|
||||
.tox/
|
||||
.nox/
|
||||
.coverage
|
||||
.coverage.*
|
||||
.cache
|
||||
nosetests.xml
|
||||
coverage.xml
|
||||
*.cover
|
||||
*.py,cover
|
||||
.hypothesis/
|
||||
.pytest_cache/
|
||||
|
||||
# Translations
|
||||
*.mo
|
||||
*.pot
|
||||
|
||||
# Django stuff:
|
||||
*.log
|
||||
local_settings.py
|
||||
db.sqlite3
|
||||
db.sqlite3-journal
|
||||
|
||||
# Flask stuff:
|
||||
instance/
|
||||
.webassets-cache
|
||||
|
||||
# Scrapy stuff:
|
||||
.scrapy
|
||||
|
||||
# Sphinx documentation
|
||||
docs/_build/
|
||||
|
||||
# PyBuilder
|
||||
target/
|
||||
|
||||
# Jupyter Notebook
|
||||
.ipynb_checkpoints
|
||||
|
||||
# IPython
|
||||
profile_default/
|
||||
ipython_config.py
|
||||
|
||||
# pyenv
|
||||
.python-version
|
||||
|
||||
# pipenv
|
||||
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
|
||||
# However, in case of collaboration, if having platform-specific dependencies or dependencies
|
||||
# having no cross-platform support, pipenv may install dependencies that don't work, or not
|
||||
# install all needed dependencies.
|
||||
#Pipfile.lock
|
||||
|
||||
# PEP 582; used by e.g. github.com/David-OConnor/pyflow
|
||||
__pypackages__/
|
||||
|
||||
# Celery stuff
|
||||
celerybeat-schedule
|
||||
celerybeat.pid
|
||||
|
||||
# SageMath parsed files
|
||||
*.sage.py
|
||||
|
||||
# Environments
|
||||
.env
|
||||
.venv
|
||||
env/
|
||||
venv/
|
||||
ENV/
|
||||
env.bak/
|
||||
venv.bak/
|
||||
|
||||
# Spyder project settings
|
||||
.spyderproject
|
||||
.spyproject
|
||||
|
||||
# Rope project settings
|
||||
.ropeproject
|
||||
|
||||
# mkdocs documentation
|
||||
/site
|
||||
|
||||
# mypy
|
||||
.mypy_cache/
|
||||
.dmypy.json
|
||||
dmypy.json
|
||||
|
||||
# Pyre type checker
|
||||
.pyre/
|
||||
16
Dockerfile
Normal file
16
Dockerfile
Normal file
@@ -0,0 +1,16 @@
|
||||
FROM python:latest
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
COPY . .
|
||||
|
||||
RUN apt-get update && apt-get install -y --no-install-recommends \
|
||||
ca-certificates curl firefox-esr \
|
||||
&& rm -fr /var/lib/apt/lists/* \
|
||||
&& curl -L https://github.com/mozilla/geckodriver/releases/download/v0.32.0/geckodriver-v0.32.0-linux64.tar.gz | tar xz -C /usr/local/bin \
|
||||
&& apt-get purge -y ca-certificates curl
|
||||
|
||||
RUN pip install --upgrade pip && pip install build && python -m build
|
||||
RUN pip install dist/*.whl
|
||||
|
||||
ENTRYPOINT ["facebook_downloader"]
|
||||
4
LICENSE
4
LICENSE
@@ -631,7 +631,7 @@ to attach them to the start of each source file to most effectively
|
||||
state the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
Facebook video downloader
|
||||
facebook video downloader
|
||||
Copyright (C) 2022 Richard Mwewa
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
@@ -652,7 +652,7 @@ Also add information on how to contact you by electronic and paper mail.
|
||||
If the program does terminal interaction, make it output a short
|
||||
notice like this when it starts in an interactive mode:
|
||||
|
||||
Facebook-Downloader Copyright (C) 2022 Richard Mwewa
|
||||
Facebook-Downloader Copyright (C) 2023 Richard Mwewa
|
||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
81
README.md
81
README.md
@@ -1,58 +1,71 @@
|
||||
# Facebook-Downloader
|
||||
A program for downloading Facebook videos
|
||||
# Facebook Downloader
|
||||
A program for downloading videos from Facebook, given a video url
|
||||
|
||||
[](https://github.com/rly0nheart/facebook-downloader/actions/workflows/python-publish.yml)
|
||||
[](https://github.com/rly0nheart/facebook-downloader/actions/workflows/codeql.yml)
|
||||
|
||||
# Installation
|
||||
**1. Clone the project**
|
||||
## Install from PyPI
|
||||
```
|
||||
git clone https://github.com/rly0nheart/Facebook-Downloader.git
|
||||
pip install facebook-downloader
|
||||
```
|
||||
|
||||
**2. Move to Facebook-Downloader directory**
|
||||
### Note
|
||||
> You will need to have the FireFox browser installed on your pc (for the PyPI Package)
|
||||
>> 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)
|
||||
|
||||
# Docker
|
||||
## Pull the image
|
||||
```
|
||||
cd Facebook-Downloader
|
||||
docker pull rly0nheart/facebook-downloader:facebook-downloader
|
||||
```
|
||||
# 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. Add geckodriver to your system path**
|
||||
```
|
||||
export PATH=$PATH:/path/to/downloaded/geckodriver
|
||||
```
|
||||
|
||||
**3. Install dependencies**
|
||||
## Note
|
||||
> *This will install tqdm, selenium, and requests*
|
||||
> > *You will need to have Firefox installed to run the program*
|
||||
> > > *For user convenience, the program will come with a geckodriver.exe binary*
|
||||
```
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
### Note
|
||||
> If you encounter issues with the above commands, then you should run them as root
|
||||
|
||||
|
||||
## 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
|
||||
```
|
||||
python downloader.py <facebook-url>
|
||||
facebook_downloader <video-url>
|
||||
```
|
||||
|
||||
> *Alternatively, you could grant execution permission to the downloader and run it as shown below*
|
||||
|
||||
**1. Grant execution permission**
|
||||
# Docker
|
||||
```
|
||||
chmod +x downloader.py
|
||||
docker run -it -v $PWD/downloads:/app/downloads facebook-downloader <facebook_url>
|
||||
```
|
||||
|
||||
**2. Run downloader**
|
||||
```
|
||||
./downloader.py <facebook-url>
|
||||
```
|
||||
|
||||
## Example
|
||||
```
|
||||
python downloader.py https://www.facebook.com/PageName/videos/VideoID
|
||||
```
|
||||
|
||||
## Note
|
||||
> Upon run, the downloader will first check for updates. If found, users will be prompted to download the updates
|
||||
> The url format should be as follows; https://www.facebook.com/PageName/videos/VideoID
|
||||
|
||||
|
||||
# Optional Arguments
|
||||
| Flag | Description |
|
||||
|---------|:-----------:|
|
||||
| *-A/--audio* | download audio only (coming soon) |
|
||||
| *-o/--output* | output filename |
|
||||
| *-v/--version* | show program's version number and exit |
|
||||
| *-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
|
||||
|
||||
@@ -1,97 +0,0 @@
|
||||
import time
|
||||
import logging
|
||||
import argparse
|
||||
import requests
|
||||
from tqdm import tqdm
|
||||
from selenium import webdriver
|
||||
from selenium.webdriver.common.by import By
|
||||
from selenium.webdriver.common.keys import Keys
|
||||
|
||||
|
||||
option = webdriver.FirefoxOptions()
|
||||
option.add_argument('--headless')
|
||||
driver = webdriver.Firefox(options=option)
|
||||
program_version_number = "2022.1.0.0"
|
||||
downloading_url = "https://getfvid.com"
|
||||
update_check_endpoint = "https://api.github.com/repos/rly0nheart/Facebook-Downloader/releases/latest"
|
||||
|
||||
|
||||
def notice():
|
||||
notice_msg = f"""
|
||||
Facebook-Downloader {program_version_number} Copyright (C) 2022 Richard Mwewa
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
"""
|
||||
print(notice_msg)
|
||||
|
||||
|
||||
def check_and_get_updates():
|
||||
notice()
|
||||
response = requests.get(update_check_endpoint).json()
|
||||
if response['tag_name'] == program_version_number:
|
||||
"""Ignore if the program is up to date"""
|
||||
pass
|
||||
else:
|
||||
update_prompt = input(f"[?] A new release is available ({response['tag_name']}). Would you like to install it? (y/n) ")
|
||||
if update_prompt.lower() == "y":
|
||||
files_to_update = ['downloader.py', 'geckodriver.exe', 'README.md', 'requirements.txt']
|
||||
for file in tqdm(files_to_update, desc=f'Updating'):
|
||||
data = requests.get(f'https://raw.githubusercontent.com/rly0nheart/Facebook-Downloader/master/{file}')
|
||||
with open(file, "wb") as f:
|
||||
f.write(data.content)
|
||||
f.close()
|
||||
print("Updated: Re-run program.")
|
||||
else:
|
||||
pass
|
||||
|
||||
|
||||
def download_video(url, output):
|
||||
driver.get(downloading_url) # Opening getfvid.com, a website that downloads facebook videos
|
||||
url_entry_field = driver.find_element(By.NAME, "url") # Find the url entry field
|
||||
url_entry_field.send_keys(url) # write facebook url in the entry field
|
||||
url_entry_field.send_keys(Keys.ENTER) # press enter
|
||||
print('Please standby (20 seconds)...')
|
||||
time.sleep(20) # Sleep for at least 20 seconds to wait for the next page to load
|
||||
driver.refresh
|
||||
|
||||
"""
|
||||
HD: "/html/body/div[2]/div/div/div[1]/div/div[2]/div/div[3]/p[1]/a"
|
||||
SD: "/html/body/div[2]/div/div/div[1]/div/div[2]/div/div[3]/p[2]/a"
|
||||
Audio: "/html/body/div[2]/div/div/div[1]/div/div[2]/div/div[3]/p[3]/a"
|
||||
"""
|
||||
|
||||
download_btn = driver.find_element(By.XPATH, '/html/body/div[2]/div/div/div[1]/div/div[2]/div/div[3]/p[1]/a') # Find the download button (this clicks the first button which returns a video in hd)
|
||||
download_url = download_btn.get_attribute('href')
|
||||
|
||||
with requests.get(download_url, stream=True) as response:
|
||||
response.raise_for_status()
|
||||
with open(f'downloads/{output}.mp4', 'wb') as file:
|
||||
for chunk in tqdm(response.iter_content(chunk_size=8192), desc=f'Downloading: {output}.mp4'):
|
||||
file.write(chunk)
|
||||
print(f'Downloaded: {file.name}')
|
||||
driver.close()
|
||||
|
||||
|
||||
parser = argparse.ArgumentParser(description='Facebook-Downloader — by Richard Mwewa')
|
||||
parser.add_argument('url', help='facebook video url (eg. https://www.facebook.com/PageName/videos/VideoID')
|
||||
parser.add_argument('-A', '--audio', help=argparse.SUPPRESS, action='store_true')
|
||||
parser.add_argument('-o', '--output', help='output filename')
|
||||
parser.add_argument('-v', '--version', version='2022.1.0.0', action='version')
|
||||
args = parser.parse_args()
|
||||
url = args.url
|
||||
output = args.output
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
try:
|
||||
check_and_get_updates()
|
||||
download_video(url, output)
|
||||
|
||||
except KeyboardInterrupt:
|
||||
print('Process interrupted with Ctrl+C.')
|
||||
|
||||
except Exception as e:
|
||||
print('An error occured:', e)
|
||||
@@ -1 +0,0 @@
|
||||
|
||||
0
facebook_downloader/__init__.py
Normal file
0
facebook_downloader/__init__.py
Normal file
91
facebook_downloader/downloader.py
Normal file
91
facebook_downloader/downloader.py
Normal file
@@ -0,0 +1,91 @@
|
||||
import os
|
||||
import argparse
|
||||
import requests
|
||||
from tqdm import tqdm
|
||||
from selenium import webdriver
|
||||
from selenium.webdriver.common.by import By
|
||||
from selenium.webdriver.common.keys import Keys
|
||||
from selenium.webdriver.support.ui import WebDriverWait
|
||||
from selenium.webdriver.support import expected_conditions
|
||||
|
||||
|
||||
class FacebookDownloader:
|
||||
def __init__(self):
|
||||
parser = argparse.ArgumentParser(description='facebook-downloader — by Richard Mwewa')
|
||||
parser.add_argument('url', help='facebook video url (eg. https://www.facebook.com/PageName/videos/VideoID')
|
||||
parser.add_argument('-a', '--audio', help='download file as audio', action='store_true')
|
||||
parser.add_argument('-o', '--output', help='output filename')
|
||||
self.args = parser.parse_args()
|
||||
|
||||
option = webdriver.FirefoxOptions()
|
||||
option.add_argument('--headless')
|
||||
self.driver = webdriver.Firefox(options=option)
|
||||
|
||||
self.program_version_number = "1.3.1"
|
||||
self.downloading_url = "https://getfvid.com"
|
||||
self.update_check_endpoint = "https://api.github.com/repos/rly0nheart/facebook-downloader/releases/latest"
|
||||
|
||||
|
||||
def notice(self):
|
||||
return f"""
|
||||
facebook-downloader v{self.program_version_number} Copyright (C) 2023 Richard Mwewa
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
|
||||
"""
|
||||
|
||||
|
||||
def check_updates(self):
|
||||
print(self.notice())
|
||||
response = requests.get(self.update_check_endpoint).json()
|
||||
if response['tag_name'] == self.program_version_number:
|
||||
"""Ignore if the program is up to date"""
|
||||
pass
|
||||
else:
|
||||
print(f"[UPDATE] A new release is available ({response['tag_name']}). Run 'pip install --upgrade facebook-downloader' to get the updates.")
|
||||
|
||||
|
||||
def download_type(self):
|
||||
"""
|
||||
The elements change according to what file type will be downloaded
|
||||
So, we pass an option to specify what file type we want, by default the file is an HD video
|
||||
"""
|
||||
"""
|
||||
HD: "/html/body/div[2]/div/div/div[1]/div/div[2]/div/div[3]/p[1]/a"
|
||||
SD: "/html/body/div[2]/div/div/div[1]/div/div[2]/div/div[3]/p[2]/a"
|
||||
Audio: "/html/body/div[2]/div/div/div[1]/div/div[2]/div/div[3]/p[3]/a"
|
||||
"""
|
||||
if self.args.audio:
|
||||
download_type_element = "/html/body/div[2]/div/div/div[1]/div/div[2]/div/div[3]/p[3]/a"
|
||||
else:
|
||||
download_type_element = "/html/body/div[2]/div/div/div[1]/div/div[2]/div/div[3]/p[1]/a"
|
||||
|
||||
return download_type_element
|
||||
|
||||
|
||||
def path_finder(self):
|
||||
os.makedirs("downloads", exist_ok=True)
|
||||
|
||||
|
||||
def download_video(self):
|
||||
self.path_finder()
|
||||
self.check_updates()
|
||||
self.driver.get(self.downloading_url) # Opening getfvid.com, a website that downloads facebook videos
|
||||
url_entry_field = self.driver.find_element(By.NAME, "url") # Find the url entry field
|
||||
url_entry_field.send_keys(self.args.url) # write facebook url in the entry field
|
||||
url_entry_field.send_keys(Keys.ENTER) # press enter
|
||||
print('[INFO] Loading web resource, please wait...')
|
||||
# self.driver.refresh
|
||||
|
||||
download_btn = WebDriverWait(self.driver, 20).until(expected_conditions.presence_of_element_located((By.XPATH, self.download_type()))) # Find the download button (this clicks the first button which returns a video in hd)
|
||||
download_url = download_btn.get_attribute('href')
|
||||
|
||||
with requests.get(download_url, stream=True) as response:
|
||||
response.raise_for_status()
|
||||
with open(os.path.join('downloads', f'{self.args.output}.mp4'), 'wb') as file:
|
||||
for chunk in tqdm(response.iter_content(chunk_size=8192), desc=f'[INFO] Downloading: {self.args.output}.mp4'):
|
||||
file.write(chunk)
|
||||
print(f'[INFO] Downloaded: {file.name}')
|
||||
self.driver.close()
|
||||
|
||||
12
facebook_downloader/main.py
Normal file
12
facebook_downloader/main.py
Normal file
@@ -0,0 +1,12 @@
|
||||
from facebook_downloader.downloader import FacebookDownloader
|
||||
|
||||
def main():
|
||||
try:
|
||||
start = FacebookDownloader()
|
||||
start.download_video()
|
||||
|
||||
except KeyboardInterrupt:
|
||||
print('[WARNING] Process interrupted with Ctrl+C.')
|
||||
|
||||
except Exception as e:
|
||||
print('[ERROR]', e)
|
||||
BIN
geckodriver.exe
BIN
geckodriver.exe
Binary file not shown.
@@ -1,3 +0,0 @@
|
||||
tqdm
|
||||
selenium
|
||||
requests
|
||||
31
setup.py
Normal file
31
setup.py
Normal file
@@ -0,0 +1,31 @@
|
||||
import setuptools
|
||||
|
||||
with open('README.md', 'r', encoding='utf-8') as file:
|
||||
long_description = file.read()
|
||||
|
||||
setuptools.setup(
|
||||
name='facebook-downloader',
|
||||
version='1.3.1',
|
||||
author='Richard Mwewa',
|
||||
author_email='rly0nheart@duck.com',
|
||||
packages=['facebook_downloader'],
|
||||
description='Facebook video downloader',
|
||||
long_description=long_description,
|
||||
long_description_content_type='text/markdown',
|
||||
url='https://github.com/rly0nheart/facebook-downloader',
|
||||
license='GNU General Public License v3 (GPLv3)',
|
||||
install_requires=['requests', 'selenium', 'tqdm'],
|
||||
classifiers=[
|
||||
'Development Status :: 5 - Production/Stable',
|
||||
'Intended Audience :: Information Technology',
|
||||
'License :: OSI Approved :: GNU General Public License v3 (GPLv3)',
|
||||
'Operating System :: OS Independent',
|
||||
'Natural Language :: English',
|
||||
'Programming Language :: Python :: 3'
|
||||
],
|
||||
entry_points={
|
||||
'console_scripts': [
|
||||
'facebook_downloader=facebook_downloader.main:main',
|
||||
]
|
||||
},
|
||||
)
|
||||
@@ -1,6 +0,0 @@
|
||||
from downloader import download_video
|
||||
|
||||
def test_download_video():
|
||||
# I find this video very interesting, enjoy! ;)
|
||||
url = 'https://www.facebook.com/VICE/videos/663211078474482'
|
||||
download_video(url, output='test_video_making-a-weed-smoothie')
|
||||
Reference in New Issue
Block a user