[!WARNING] > Disclaimer: Using self-bots violates Discord's Terms of Service and can result in your account being banned. Use this software at your own risk. The developer is not responsible for any consequences resulting from its use.
A sleek Discord bot for streaming video content directly to voice channels. 🍿
- 🎥 Streams video files (MP4, MKV, AVI, etc.) to Discord voice channels.
- ⚙️ Highly configurable stream settings (resolution, bitrate, codec, FPS).
- 🎞️ Automatically fetches and displays a list of available videos in a designated channel.
- 💬 Simple command-based interaction.
- 🖼️ Video preview generation using FFmpeg.
- 🔄 Automatic video list updates on refresh command.
Want to watch movies with friends or discuss the bot? Join our Discord server!
- Clone the repository:
git clone https://github.com/knull-reaper/r34p3r3ss_stream.git cd r34p3r3ss # Or your chosen directory name
- Install Dependencies: 📦
bun install
- Configure Environment Variables: 🔑
- Copy the example environment file:
cp .env.example .env
- Edit the
.env
file and fill in your specific values (Discord token, channel IDs, etc.). Refer to the comments in the file for guidance. Don't forget your self-bot token!
- Copy the example environment file:
- Ensure FFmpeg is Installed: 🛠️ This bot relies on FFmpeg for video processing. Make sure it's installed on your system and accessible in your PATH.
bun run start:node
All configuration is done via the .env
file. See .env.example
for available options and their descriptions. Key settings include:
- Discord bot token and server/channel IDs.
- Directories for video files (
VIDEOS_DIR
) and temporary cache (PREVIEW_CACHE_DIR
). - Stream quality parameters (resolution, FPS, bitrate, codec).
- Hardware acceleration options.
Use the configured prefix (default is +
) followed by the command in your designated command channel.
- Media Control 🎬
play <video_name>
: Plays a video matching the name (partial matches work if unique).stop
: Stops the current video stream and leaves the voice channel.
- Utilities 🛠️
refresh
: Re-scans the video directory and updates the movie list message in the configured channel.status
: Shows the bot's current streaming status (joined, playing).preview <video_name>
: Generates and sends preview thumbnails for the specified video.
- General ℹ️
help
: Shows a help message listing all available commands.
Here's a glimpse of the bot in action: