# 📥 fbvid-downloader

A lightweight Node.js package to **download public Facebook videos in MP4 format**. Simple, fast, and perfect for automation, scraping, or media backup.

## ✨ Features

- 🔗 Download from public Facebook video URLs
- 📁 Get high-quality MP4 files
- ⚡ Built with Axios — fast and reliable
- 🧠 Developer-friendly and easy to use

---

## 📦 Installation

```bash
npm install fbvid-downloader

or with Yarn: yarn add fbvid-downloader


## 🚀 Usage

import { downloadFacebookVideo } from 'fbvid-downloader';

const url = 'https://www.facebook.com/share/v/1LgRe5euce/';

downloadFacebookVideo(url)
  .then((filePath) => {
    console.log('Video saved to:', filePath);
  })
  .catch((err) => {
    console.error('Failed to download:', err);
  });
⚠️ Note: This package only supports public Facebook videos.

🧰 API
downloadFacebookVideo(url: string): Promise<string>
url: The public Facebook video URL

Returns: The path where the MP4 file is saved

📄 License
MIT © robindev2007

🧠 Disclaimer
This project is intended for educational and personal use only. Downloading content without permission may violate Facebook’s terms of service. Use responsibly.

---

Let me know if you want to include:
- CLI support
- Proxy settings
- Reels/private video support (if added)
- Custom file naming or download paths

I can extend the README accordingly.
```