https://github.com/imhappykumar/happy-dl

A simple tool to generate direct download links for media from Instagram, Facebook, and Twitter! Just provide the post URL, and this package will return a direct download URL.
https://github.com/imhappykumar/happy-dl

downloader facebook facebook-api facebook-downloader instagram instagram-api instagram-downloader npm npm-package social-media twitter twitter-api

Last synced: about 1 month ago
JSON representation

A simple tool to generate direct download links for media from Instagram, Facebook, and Twitter! Just provide the post URL, and this package will return a direct download URL.

• Host: GitHub
• URL: https://github.com/imhappykumar/happy-dl
• Owner: ImHappyKumar
• License: mit
• Created: 2024-12-20T10:18:34.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2024-12-26T05:47:26.000Z (about 1 month ago)
• Last Synced: 2024-12-26T05:47:40.730Z (about 1 month ago)
• Topics: downloader, facebook, facebook-api, facebook-downloader, instagram, instagram-api, instagram-downloader, npm, npm-package, social-media, twitter, twitter-api
• Homepage: https://www.npmjs.com/package/happy-dl
• Size: 22.5 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# HAPPY DOWNLOADER (HAPPY DL)

![NPM Info](https://nodei.co/npm/happy-dl.png?downloads=true&downloadRank=true&stars=true)

[![GitHub stars](https://img.shields.io/github/stars/ImHappyKumar/happy-dl?style=social&color=blue)](https://github.com/ImHappyKumar/happy-dl)

[![npm total downloads](https://img.shields.io/npm/dt/happy-dl?color=blue)](https://www.npmjs.com/package/happy-dl)

[![npm version](https://img.shields.io/npm/v/happy-dl?color=blue)](https://www.npmjs.com/package/happy-dl)

[![License](https://img.shields.io/npm/l/happy-dl?color=blue)](LICENSE)

A simple tool to generate direct download links for media from Instagram, Facebook, and Twitter! Just provide the post URL, and this package will return a direct download URL.

## Installation

You can install `happy-dl` via npm:

```bash

npm install happy-dl

```

Or, if you're using Yarn:

```bash

yarn add happy-dl

```

## Usage

### Importing the Package

You can import the entire `happy-dl` module:

```javascript

const happyDL = require("happy-dl");

```

Or destructure specific functions:

```javascript

const {

  instagramDownloader,

  facebookDownloader,

  twitterDownloader,

} = require("happy-dl");

```

### Example Usage

#### Instagram Downloader

```javascript

async function fetchInstagramData() {

  try {

    const result = await happyDL.instagramDownloader(

      "https://www.instagram.com/reel/C2xQMDBBY6v/"

    );

    console.log("Fetched Instagram media details:", result);

  } catch (error) {

    console.error("Error fetching Instagram media details:", error);

  }

}

fetchInstagramData();

```

#### Facebook Downloader

```javascript

async function fetchFacebookData() {

  try {

    const result = await happyDL.facebookDownloader(

      "https://www.facebook.com/share/r/yfF9ZULaNJnQ72Ur/"

    );

    console.log("Fetched Facebook media details:", result);

  } catch (error) {

    console.error("Error fetching Facebook media details:", error);

  }

}

fetchFacebookData();

```

#### Twitter Downloader

```javascript

async function fetchTwitterData() {

  try {

    const result = await happyDL.twitterDownloader(

      "https://x.com/ImHappyKumar/status/1758877530776547450"

    );

    console.log("Fetched Twitter media details:", result);

  } catch (error) {

    console.error("Error fetching Twitter media details:", error);

  }

}

fetchTwitterData();

```

## Supported Platforms

- Instagram

- Facebook

- Twitter

- More coming soon!

## Contributing

Contributions are welcome! If you find any issues or want to contribute new features, feel free to fork the repository and create a pull request.

### Steps to Contribute:

1. Fork the repository.

2. Create a new branch (`git checkout -b feature-branch`).

3. Make your changes and commit them (`git commit -am 'Add new feature'`).

4. Push to the branch (`git push origin feature-branch`).

5. Create a pull request.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.