• 📁 Stream videos from a local folder
• 🎬 Stream and search YouTube videos by title
• 🔗 Stream YouTube videos/live streams by link
• 🌐 Stream from arbitrary links (video files, live streams, Twitch, etc.)
• ⚡ Playback controls: play, stop
• 📋 Video library management

• Bun v1.1.39+
• FFmpeg (in PATH or working directory)

This project is hosted on GitHub.

1. Clone the repository:

git clone https://github.com/ysdragon/StreamBot

2. Install dependencies:

bun install

3. Configure environment:
   • Rename .env.example to .env
   • Update configuration values

Start with Bun:

bun run start

Start with Node.js:

bun run build
bun run start:node

1. Create a directory and navigate to it:

mkdir streambot && cd streambot

2. Download the compose file:

wget https://raw.githubusercontent.com/ysdragon/StreamBot/main/docker-compose.yml

3. Configure environment variables in docker-compose.yml

4. Launch container:

docker compose up -d

1. Download WARP compose file:

wget https://raw.githubusercontent.com/ysdragon/StreamBot/main/docker-compose-warp.yml

2. Configure docker-compose-warp.yml and add your WARP license key

3. Launch with WARP:

docker compose -f docker-compose-warp.yml up -d

Configuration is done via .env:

# Selfbot options
TOKEN = "" # Your Discord self-bot token
PREFIX = "$" # The prefix used to trigger your self-bot commands
GUILD_ID = "" # The ID of the Discord server your self-bot will be running on
COMMAND_CHANNEL_ID = "" # The ID of the Discord channel where your self-bot will respond to commands
VIDEO_CHANNEL_ID = "" # The ID of the Discord voice/video channel where your self-bot will stream videos

# General options
VIDEOS_DIR = "./videos" # The local path where you store video files
PREVIEW_CACHE_DIR = "./tmp/preview-cache" # The local path where your self-bot will cache video preview thumbnails

# Stream options
STREAM_RESPECT_VIDEO_PARAMS = "false"  # This option is used to respect video parameters such as width, height, fps, bitrate, and max bitrate.
STREAM_WIDTH = "1280" # The width of the video stream in pixels
STREAM_HEIGHT = "720" # The height of the video stream in pixels
STREAM_FPS = "30" # The frames per second (FPS) of the video stream
STREAM_BITRATE_KBPS = "2000" # The bitrate of the video stream in kilobits per second (Kbps)
STREAM_MAX_BITRATE_KBPS = "2500" # The maximum bitrate of the video stream in kilobits per second (Kbps)
STREAM_HARDWARE_ACCELERATION = "false" # Whether to use hardware acceleration for video decoding, set to "true" to enable, "false" to disable
STREAM_VIDEO_CODEC = "H264" # The video codec to use for the stream, can be "H264" or "H265" or "VP8"

# STREAM_H26X_PRESET: Determines the encoding preset for H26x video streams. 
# If the STREAM_H26X_PRESET environment variable is set, it parses the value 
# using the parsePreset function. If not set, it defaults to 'ultrafast' for 
# optimal encoding speed. This preset is only applicable when the codec is 
# H26x; otherwise, it should be disabled or ignored.
# Available presets: "ultrafast", "superfast", "veryfast", "faster", 
# "fast", "medium", "slow", "slower", "veryslow".
STREAM_H26X_PRESET = "ultrafast"

# Videos server options
SERVER_ENABLED = "false" # Whether to enable the built-in video server
SERVER_USERNAME = "admin" # The username for the video server's admin interface
SERVER_PASSWORD = "admin" # The password for the video server's admin interface
SERVER_PORT = "8080" # The port number the video server will listen on

# Jellyfin integration options (optional)
JELLYFIN_ENABLED = "false" # Enable Jellyfin media library integration
JELLYFIN_BASE_URL = "http://localhost:8096" # Jellyfin server URL
JELLYFIN_API_KEY = "" # Jellyfin API key (generate in Dashboard > API Keys)
JELLYFIN_USER_ID = "" # Optional: specific user ID for user libraries
JELLYFIN_LIBRARY_ID = "" # Optional: restrict to specific library

Check the Get token wiki

An optional basic HTTP server can be enabled to manage the video library:

• List videos
• Upload videos
• Delete videos
• Generate video preview thumbnails

StreamBot can integrate with your Jellyfin media server to browse and play your media library directly through Discord commands.

1. Enable Jellyfin Integration:

   JELLYFIN_ENABLED="true"
   JELLYFIN_BASE_URL="http://your-jellyfin-server:8096"

2. Generate API Key:

   • Go to Jellyfin Dashboard → API Keys
   • Create a new API key for StreamBot
   • Add it to your configuration:

   JELLYFIN_API_KEY="your-api-key-here"

3. Optional Configuration:

   • User ID: Restrict to a specific user's libraries
   • Library ID: Restrict to a specific library (movies, TV shows, etc.)

• 🔍 Search: Find media by title across your entire library
• 📺 TV Show Navigation: Browse shows → seasons → episodes hierarchically
• 🖼️ Rich Media Display: Episode thumbnails and detailed synopses
• 📅 Recent: Browse recently added content
• 📚 Libraries: View available media libraries
• 🎬 Smart Playback: Automatically uses local files when available, streams when remote
• ℹ️ Details: View comprehensive media information

1. Search for Shows: $jfshows breaking bad

   Shows are displayed with rich Discord embeds featuring:

   • Show posters as thumbnails
   • Complete series descriptions from Jellyfin
   • Production year and season count

   1. 📺 `Breaking Bad` (2008) - 5 seasons - ID: `12345`
   [Discord Embed with show poster and description]
   

2. Browse Seasons: $jfseasons 12345

   📅 Seasons for "Breaking Bad"
   1. 📅 Season 1 (7 episodes) - ID: `54321`
   2. 📅 Season 2 (13 episodes) - ID: `54322`
   

3. View Episodes: $jfepisodes 54321

   Episodes are displayed with rich Discord embeds featuring:

   • Episode screenshots as full-size images
   • Complete synopses from Jellyfin metadata
   • Series context and episode information

   Each episode appears as a separate message with:

   1. 🎬 E1: `Pilot` - 58m - ID: `98765`
   [Discord Embed with episode screenshot and synopsis]
   
   2. 🎬 E2: `Cat's in the Bag...` - 48m - ID: `98766`
   [Discord Embed with episode screenshot and synopsis]
   

4. Play Episode: $jfplay 98765

StreamBot intelligently handles media sources:

• Local Access: If the bot and Jellyfin are on the same machine/network and can access the media files directly, it will use the local file path for optimal performance
• Remote Streaming: If local access isn't available, it generates a streaming URL from Jellyfin for remote playback

This ensures the best possible streaming quality and performance regardless of your setup.

• Adding ytsearch and ytplay commands
• Jellyfin media server integration
• Smart local/remote streaming detection
• Comprehensive media search and browsing

Contributions are welcome! Feel free to:

• 🐛 Report bugs via issues
• 🔧 Submit pull requests
• 💡 Suggest new features

This bot may violate Discord's ToS. Use at your own risk.

أتبرأ من أي استخدام غير أخلاقي لهذا المشروع أمام الله.

Licensed under MIT License. See LICENSE for details.