Skip to content

blackaly/fb-dl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📽️ fb-dl — Facebook Video Downloader (.NET CLI Tool)

fb-dl is a lightweight and efficient command-line tool built with .NET 9.0 that allows you to download public Facebook videos and reels by simply passing their URL. This tool is designed for developers, automation tasks, and anyone who wants a reliable way to retrieve Facebook-hosted video content.


✨ Features

  • Download public Facebook videos by URL
  • Built with modern .NET SDK
  • Fast and minimal
  • Easy to run from terminal or integrate into scripts
  • Ready for NuGet packaging and GitHub integration

📥 Installation & Setup

Prerequisites

Make sure the following are installed:

📦 Clone the Repository

git clone https://github.com/blackaly/fb-dl.git
cd fb-dl

🛠️ Build the Project

dotnet build -c Release

This will compile the application into the bin/Release/ directory.


Usage

To download a video, run the tool from the CLI:

dotnet run --project src/facebook-downloader/facebook-downloader.csproj -- "https://www.facebook.com/watch/?v=YOUR_VIDEO_ID"

Replace the URL with a public Facebook video link.


Example

dotnet run --project src/facebook-downloader/facebook-downloader.csproj -- "https://www.facebook.com/watch/?v=123456789012345"

After running, the video will be downloaded to your working directory.


GitHub Integration for NuGet

Add the following to your .csproj to associate the package with this GitHub repository:

<PackageProjectUrl>https://github.com/blackaly/fb-dl</PackageProjectUrl>
<RepositoryUrl>https://github.com/blackaly/fb-dl</RepositoryUrl>
<RepositoryType>git</RepositoryType>

Run with Docker

Make sure you're in the root directory (where the Dockerfile is):

docker build -t fb-dl-app .
docker run --rm fb-dl-app https://www.facebook.com/watch/?v=YOUR_VIDEO_ID

you can also run interactively if needed:

docker run -it --rm fb-dl-app

Contributing

Contributions, bug reports, and feature requests are welcome! 0

How to Contribute

  1. Fork the repository
  2. Create a new branch (git checkout -b feature/your-feature)
  3. Make your changes
  4. Commit your changes (git commit -m "Add your message here")
  5. Push to your fork (git push origin feature/your-feature)
  6. Create a Pull Request

Code Guidelines

  • Follow .NET naming conventions
  • Keep commits clear and concise
  • Test your code before submitting PRs

License

This project is licensed under the MIT License.


Contact

For support or questions, feel free to open an issue or contact the maintainer via GitHub Issues.

About

Easily download Facebook videos and Reels in various qualities.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •