media-downloader-ez
Version:
download videos from URLs and autocrop (Instagram, YouTube, TikTok, X, etc.) to send directly to Discord or other!
137 lines (105 loc) • 4 kB
Markdown
<div align="center">
<a href="https://nodei.co/npm/media-downloader-ez" title="npm"><img src="https://nodei.co/npm/media-downloader-ez.png?downloads=true&downloadRank=true&stars=true"></img></a>
</div>
# media-downloader-ez
A simple npm package to download videos from various platforms, including Instagram, YouTube, TikTok, X/Twitter, and more.
## Features
- **AutoCompress**: Automatically compress videos with a size limit.
- **AutoCrop**: Automatically crop videos to remove black bars.
- **Rotate**: Rotate the video left or right.
## Supported Platforms
- Facebook
- TikTok
- Twitter (X)
- Instagram
- YouTube
- Pinterest
- Google Drive
- CapCut
- Likee
- Threads
- Mediafire
**Note:** Some Instagram posts/reels/stories can fail with the default extractor. This package includes an alternate Instagram method called "option3" (uses `instagramcustom.js`) that you can force when needed.
## Basic Example
```js
const MediaDownloader = require('media-downloader-ez');
let url = "http://";
MediaDownloader(url, {
autocrop: true, // Automatically crop black bars (useful for TikTok, Instagram videos)
limitSizeMB: "10", // Maximum size limit in MB
rotation: null, // Rotate video: "right", "left", or null
useInstaOption3: false // Set to true to force the custom Instagram downloader
});
```
## Example for Discord.js
```js
const MediaDownloader = require('media-downloader-ez');
const Discord = require('discord.js-v11-stable');
const client = new Discord.Client({
disableEveryone: true
});
client.on('message', async (message) => {
try {
if (message.content.startsWith('!download') && message.content.includes('http')) {
let attachment = await MediaDownloader(message.content, {
autocrop: true,
limitSizeMB: "10"
});
message.channel.send({ content: `Downloaded by: \`${message.author.username}\``, files: [attachment] });
}
} catch (error) {
console.error('Error downloading video:', error);
message.reply('An error occurred while downloading the video.').then((m) => { m.delete(); });
}
});
client.login("your token").catch((err) => {
console.log('INCORRECT TOKEN LOGIN!');
});
```
> **Note:** Keep your Discord bot token private and secure.
## YouTube Download and Get Cookie
To download YouTube videos requiring authentication, follow these steps:
1. Open **youtube.com** in your browser.
2. Press `CTRL + SHIFT + I` (or right-click → Inspect).
3. Open the **Console** tab.
4. In the console, **type**:
```
allow pasting
```
and press Enter. *(This allows pasting commands into the console.)*
5. Then, type:
```
copy(document.cookie)
```
6. Your cookie will now be copied to your clipboard. Paste it into your script where required.
### Example with YouTube Cookie
```js
const MediaDownloader = require('media-downloader-ez');
let url = "http://";
let cookie = "your_cookie_here";
MediaDownloader(url, {
YTBcookie: cookie, // YouTube cookie
YTBmaxduration: 80, // Maximum duration in seconds
autocrop: true, // Automatically crop black bars
limitSizeMB: "10", // Maximum size limit in MB
rotation: null // Rotate video: "right", "left", or null
});
```
## Only Safe Links Example
```js
if (MediaDownloader.isVideoLink(url)) {
let attachment = await MediaDownloader(url, {
autocrop: true,
limitSizeMB: "10",
rotation: "left" // or "right" or null
});
}
```
