<h1 align="center">fzdown-api</h1>
<p align="center">
<a href="#"><img alt="Python version" src="https://img.shields.io/pypi/pyversions/fdown-api"/></a>
<a href="https://github.com/Simatwa/fdown-api/actions/workflows/python-test.yml"><img src="https://github.com/Simatwa/fdown-api/actions/workflows/python-test.yml/badge.svg" alt="Python Test"/></a>
<a href="LICENSE"><img alt="License" src="https://img.shields.io/static/v1?logo=MIT&color=Blue&message=MIT&label=License"/></a>
<a href="https://pypi.org/project/fdown-api"><img alt="PyPi" src="https://img.shields.io/pypi/v/fdown-api"></a>
<a href="https://github.com/Simatwa/fdown-api/releases"><img src="https://img.shields.io/github/v/release/Simatwa/fdown-api?label=Release&logo=github" alt="Latest release"></img></a>
<a href="https://github.com/Simatwa/fdown-api/releases"><img src="https://img.shields.io/github/release-date/Simatwa/fdown-api?label=Release date&logo=github" alt="release date"></img></a>
<a href="https://github.com/psf/black"><img alt="Black" src="https://img.shields.io/badge/code%20style-black-000000.svg"/></a>
<a href="https://github.com/Simatwa/fdown-api/actions/workflows/python-publish.yml"><img src="https://github.com/Simatwa/fdown-api/actions/workflows/python-publish.yml/badge.svg" alt="Python-publish"/></a>
<a href="https://pepy.tech/project/fdown-api"><img src="https://static.pepy.tech/personalized-badge/fdown-api?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads" alt="Downloads"></a>
<a href="https://github.com/Simatwa/fdown-api/releases/latest"><img src="https://img.shields.io/github/downloads/Simatwa/fdown-api/total?label=Asset%20Downloads&color=success" alt="Downloads"></img></a>
<a href="https://hits.seeyoufarm.com"><img src="https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com/Simatwa/fdown-api"/></a>
</p>
> Download facebook videos with ease.
## Installation
```sh
$ pip install fdown-api
```
> [!NOTE]
> For CLI to work you have to install fdown-api along with its cli-dependencies:
> `$ pip install fdown-api[cli]`
Alternatively, you can download standalone executable for your system from [here](https://github.com/Simatwa/fdown-api/releases/latest).
## Usage
### Developers
```python
from fdown_api import Fdown
f = Fdown()
video_links = f.get_links(
"https://www.facebook.com/reel/8365833600105776\?mibextid\=rS40aB7S9Ucbxw6v"
)
saved_to = f.download_video(video_links)
print(saved_to)
# Will show download progress
"""
3 MB ███████████████████ 43%|
"""
```
### CLI
`$ python -m fdown_api <facebook-video-url>`
<details>
<summary>
<code>$ fdown --help</code>
</summary>
```
usage: fdown [-h] [-d PATH] [-o PATH] [-q normal|hd] [-t TIMEOUT]
[-c chunk-size] [--resume] [--quiet] [--version]
url
Download Facebook videos seamlessly.
positional arguments:
url Link to the target facebook video
options:
-h, --help show this help message and exit
-d, --dir PATH Directory for saving the video to -
/home/smartwa/git/smartwa/fdown-api
-o, --output PATH Filename under which to save the video to - random
-q, --quality normal|hd
Video download quality - hd
-t, --timeout TIMEOUT
Http request timeout in seconds - 20
-c, --chunk-size chunk-size
Chunk-size for downloading files in KB - 512
--resume Resume an incomplete download - False
--quiet Do not stdout any informational messages - False
--version show program's version number and exit
This script has no official relation with fdown.net.
```
</details>
# Disclaimer
This repository contains an unofficial Python wrapper for fdown.net. It is not affiliated with or endorsed by the official fdown.net service or its developers.
This wrapper is intended for personal use and education only. The author(s) of this repository are not responsible for any misuse of this code or any damages caused by its use.
Raw data
{
"_id": null,
"home_page": "https://github.com/Simatwa/fdown-api",
"name": "fdown-api",
"maintainer": "Smartwa",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "facebook, fdown",
"author": "Smartwa",
"author_email": "simatwacaleb@proton.me",
"download_url": "https://files.pythonhosted.org/packages/32/3f/5a36ec48d90f0307457d1e2e31e25645c850cf65d3d6a2c8223905af3942/fdown_api-0.0.3.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">fzdown-api</h1>\n\n<p align=\"center\">\n<a href=\"#\"><img alt=\"Python version\" src=\"https://img.shields.io/pypi/pyversions/fdown-api\"/></a>\n<a href=\"https://github.com/Simatwa/fdown-api/actions/workflows/python-test.yml\"><img src=\"https://github.com/Simatwa/fdown-api/actions/workflows/python-test.yml/badge.svg\" alt=\"Python Test\"/></a>\n<a href=\"LICENSE\"><img alt=\"License\" src=\"https://img.shields.io/static/v1?logo=MIT&color=Blue&message=MIT&label=License\"/></a>\n<a href=\"https://pypi.org/project/fdown-api\"><img alt=\"PyPi\" src=\"https://img.shields.io/pypi/v/fdown-api\"></a>\n<a href=\"https://github.com/Simatwa/fdown-api/releases\"><img src=\"https://img.shields.io/github/v/release/Simatwa/fdown-api?label=Release&logo=github\" alt=\"Latest release\"></img></a>\n<a href=\"https://github.com/Simatwa/fdown-api/releases\"><img src=\"https://img.shields.io/github/release-date/Simatwa/fdown-api?label=Release date&logo=github\" alt=\"release date\"></img></a>\n<a href=\"https://github.com/psf/black\"><img alt=\"Black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"/></a>\n<a href=\"https://github.com/Simatwa/fdown-api/actions/workflows/python-publish.yml\"><img src=\"https://github.com/Simatwa/fdown-api/actions/workflows/python-publish.yml/badge.svg\" alt=\"Python-publish\"/></a>\n<a href=\"https://pepy.tech/project/fdown-api\"><img src=\"https://static.pepy.tech/personalized-badge/fdown-api?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads\" alt=\"Downloads\"></a>\n<a href=\"https://github.com/Simatwa/fdown-api/releases/latest\"><img src=\"https://img.shields.io/github/downloads/Simatwa/fdown-api/total?label=Asset%20Downloads&color=success\" alt=\"Downloads\"></img></a>\n<a href=\"https://hits.seeyoufarm.com\"><img src=\"https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com/Simatwa/fdown-api\"/></a>\n</p>\n\n> Download facebook videos with ease.\n\n## Installation\n\n```sh\n$ pip install fdown-api\n```\n\n> [!NOTE]\n> For CLI to work you have to install fdown-api along with its cli-dependencies:\n> `$ pip install fdown-api[cli]`\n\nAlternatively, you can download standalone executable for your system from [here](https://github.com/Simatwa/fdown-api/releases/latest).\n\n## Usage\n \n### Developers\n\n```python\nfrom fdown_api import Fdown\n\nf = Fdown()\nvideo_links = f.get_links(\n \"https://www.facebook.com/reel/8365833600105776\\?mibextid\\=rS40aB7S9Ucbxw6v\"\n)\nsaved_to = f.download_video(video_links)\nprint(saved_to)\n# Will show download progress\n\"\"\"\n3 MB \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588 43%|\n\"\"\"\n```\n\n### CLI\n\n`$ python -m fdown_api <facebook-video-url>`\n\n<details>\n<summary>\n<code>$ fdown --help</code>\n\n</summary>\n\n```\nusage: fdown [-h] [-d PATH] [-o PATH] [-q normal|hd] [-t TIMEOUT]\n [-c chunk-size] [--resume] [--quiet] [--version]\n url\n\nDownload Facebook videos seamlessly.\n\npositional arguments:\n url Link to the target facebook video\n\noptions:\n -h, --help show this help message and exit\n -d, --dir PATH Directory for saving the video to -\n /home/smartwa/git/smartwa/fdown-api\n -o, --output PATH Filename under which to save the video to - random\n -q, --quality normal|hd\n Video download quality - hd\n -t, --timeout TIMEOUT\n Http request timeout in seconds - 20\n -c, --chunk-size chunk-size\n Chunk-size for downloading files in KB - 512\n --resume Resume an incomplete download - False\n --quiet Do not stdout any informational messages - False\n --version show program's version number and exit\n\nThis script has no official relation with fdown.net.\n```\n</details>\n\n# Disclaimer\n\nThis repository contains an unofficial Python wrapper for fdown.net. It is not affiliated with or endorsed by the official fdown.net service or its developers.\nThis wrapper is intended for personal use and education only. The author(s) of this repository are not responsible for any misuse of this code or any damages caused by its use.\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Unofficial Python wrapper for fdown.net",
"version": "0.0.3",
"project_urls": {
"Bug Report": "https://github.com/Simatwa/fdown-api/issues/new",
"Documentation": "https://github.com/Simatwa/fdown-api/",
"Download": "https://github.com/Simatwa/fdown-api/releases",
"Homepage": "https://github.com/Simatwa/fdown-api",
"Issue Tracker": "https://github.com/Simatwa/fdown-api/issues",
"Source Code": "https://github.com/Simatwa/fdown-api"
},
"split_keywords": [
"facebook",
" fdown"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d3a3893849644661770464465fd793ad6d2274f45b552def3b2bd421f2767b74",
"md5": "ecbe6b43a1968c48f3729a90c3791233",
"sha256": "8fa9a64fdba7944f1a6153c085a4f1c737aad55891c321aeb85fb7af0744ddab"
},
"downloads": -1,
"filename": "fdown_api-0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ecbe6b43a1968c48f3729a90c3791233",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 8898,
"upload_time": "2024-10-18T11:29:32",
"upload_time_iso_8601": "2024-10-18T11:29:32.641045Z",
"url": "https://files.pythonhosted.org/packages/d3/a3/893849644661770464465fd793ad6d2274f45b552def3b2bd421f2767b74/fdown_api-0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "323f5a36ec48d90f0307457d1e2e31e25645c850cf65d3d6a2c8223905af3942",
"md5": "8d6c4f18a6eb06c745f0f44505ec50af",
"sha256": "df7c33e0c612d72eface81dc854740875838fed4802d21b45ef88d1aa736459f"
},
"downloads": -1,
"filename": "fdown_api-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "8d6c4f18a6eb06c745f0f44505ec50af",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 9949,
"upload_time": "2024-10-18T11:29:33",
"upload_time_iso_8601": "2024-10-18T11:29:33.778483Z",
"url": "https://files.pythonhosted.org/packages/32/3f/5a36ec48d90f0307457d1e2e31e25645c850cf65d3d6a2c8223905af3942/fdown_api-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-18 11:29:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Simatwa",
"github_project": "fdown-api",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "fdown-api"
}
JSON
