한글

A powerful Telegram bot for downloading videos and audio from YouTube and 1000+ other media sites. Works anywhere Docker can be installed (Linux servers, Synology NAS, etc.).

• Features
• Installation
• Environment Configuration
• Usage
• Update

This bot uses the powerful media downloader yt-dlp internally. It automatically adds channel name and upload date to downloaded filenames for better organization.

• Supports YouTube and 1000+ other sites (Twitter, Instagram, TikTok, etc.)

  • Complete list of supported sites

• Supported Formats: mp3, mp4, m4a, flac, ogg, wav, webm

• Send URL to bot and choose format from interactive buttons

• Instant download starts after format selection

• Set default formats with setft command for automatic downloads (multiple formats supported)

  

• Automatically detects URLs starting with https://www.youtube.com/playlist?list
• Downloads all videos in the playlist sequentially
• Note: Playlist must be public
• Stop download anytime: send 정지, 멈춤, s, or stop

• Initial admin is set via TELEGRAM_ADMIN_USERNAME in .env file
• Admins can register regular users or additional admins

Reply to any download completed message with one of these words to delete the file:

• 지우기, 삭제, d, del, delete

  

.env file settings

• Docker
• Docker Compose

1. Clone Repository

   git clone https://github.com/yellowgg2/youngs-ytdl
   cd youngs-ytdl

2. Configure Environment

   cp .env.sample .env
   # Edit .env file with your settings

3. Start the Bot

   docker compose up -d --build

To integrate with DS Audio:

1. Create a scheduled task in Control Panel (triggered at startup)
2. Add the download-watch.sh script to the task
3. Modify DOWNLOAD_PATH in the script to match DS Audio's watch folder

   DOWNLOAD_PATH="/music"  # Path monitored by DS Audio

1. Search for your bot in Telegram and start it
2. Send a YouTube URL to the bot
3. Choose desired format (or use pre-configured defaults)
4. Wait for download completion

Update to the latest yt-dlp version (for YouTube compatibility):

# Update only yt-dlp image
docker compose pull yt-dlp-service

Update to the latest bot code from repository:

# Pull latest code
git pull

# Rebuild and restart services
docker compose down
docker compose up -d --build

Update everything to the latest versions:

git pull
docker compose pull
docker compose down
docker compose up -d --build

Tip: If YouTube downloads start failing, updating yt-dlp usually fixes the issue.