Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eartharoid/discord-media-helper
A Discord bot to fix media embeds
https://github.com/eartharoid/discord-media-helper
discord-js
Last synced: 3 months ago
JSON representation
A Discord bot to fix media embeds
- Host: GitHub
- URL: https://github.com/eartharoid/discord-media-helper
- Owner: eartharoid
- License: mit
- Created: 2022-10-25T22:54:13.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-17T23:55:45.000Z (4 months ago)
- Last Synced: 2024-10-21T01:43:57.317Z (3 months ago)
- Topics: discord-js
- Language: TypeScript
- Homepage: https://lurc.cc
- Size: 275 KB
- Stars: 6
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MediaHelper
This bot watches chat for video links and replies to messages containing supported links with an embedded video,
so you don't need to click the link to watch shared videos.
Idea and hosting by [@RTCFlyer](https://github.com/RTCFlyer).
[**Click here to add MediaHelper**](https://discord.com/oauth2/authorize?client_id=1026547091121655808&permissions=274878032960&scope=bot%20applications.commands)
## Supported links
Links to these website will cause an automatic reply with either an image/video attachment or a rich embed.
### Videos
Videos and some images from posts, shorts, reels, stories, etc are attached in chat as if uploaded directly to Discord.
- Facebook
- iFunny
- Instagram
- Reddit
- TikTok
#### Other
Using the message context menu command (Apps > Embed media)
will cause the bot to attempt to download media from any (including unrecognised) links using [yt-dlp](https://github.com/yt-dlp/yt-dlp).
### Rich embeds
For multimedia social websites where text is often the primary content,
the bot replies with links to existing "embed fixer" services which
usually provide text content, author name, number of likes and comments, and improved image and video embeds.
- Bluesky (via [bskye.app](https://bskye.app))
- Twitter (via [fxtwitter.com](https://fxtwitter.com))
## Self-hosting
### Requirements
- Node.js v18 or higher
- A local webserver to serve static files
- `yt-dlp`
- `ffmpeg`
- https://rapidapi.com/social-api1-instagram/api/instagram-scraper-api2/pricing
- https://rapidapi.com/nguyenmanhict-MuTUtGWD7K/api/auto-download-all-in-one/pricing
### Installation
Clone the repository:
```
git clone https://github.com/eartharoid/discord-media-helper.git bot && cd bot
```
Then create a `.env` file with the following contents:
```
DISCORD_CLIENT_ID=
DISCORD_TOKEN=
DOWNLOAD_DIR=
FFMPEG_BIN=ffmpeg
HOST=
MAX_FILE_SIZE=50M
RAPID_API_KEY=
YTDL_BIN=yt-dlp
```
Create a Discord application and bot **with the message content privileged intent enabled** and paste the token into the `.env` file.
Also, set the other environment variables:
- `DISCORD_CLIENT_ID`: the client ID of the Discord application
- `DOWNLOAD_DIR`: the directory which is served by a web server (e.g. `/var/www/html/videos`) where videos will be downloaded to
- `HOST`: the web server URL, which must end with a `/` (e.g. `https://example.com/videos/`)
Install Node.js dependencies:
```bash
npm i
```
Compile:
```bash
npm run build
```
Download `yt-dlp`:
```bash
curl -o /usr/bin/yt-dlp https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp
```
And then [install `ffmpeg`](https://www.ffmpeg.org/download.html).
Finally, register the commands:
```bash
node scripts/commands
```