🚀Quick Start

Just 4 steps to get your Ytify server running in 30 seconds

1

Download the Project

Clone the project from GitHub to your computer

git clone https://github.com/Jeffrey0117/Ytify.git
cd Ytify
2

Run the Startup Script

Windows: run run.bat, Linux/Mac: run ./run.sh

run.bat # Windows
./run.sh # Linux/Mac
3

Choose Startup Mode

Not sure which to pick? Just press Enter to select the recommended option

💡 The script auto-detects and installs Python, FFmpeg, Git. Even if not in PATH, it will find them automatically
4

Start Using

Open your browser and go to the download page

http://localhost:8765/download

⚙ī¸Startup Modes

Choose the best mode based on your computer's specs

đŸŗ Docker Mode

For high-spec machines, cleaner isolated environment

  • ⚠ī¸ Requires 4GB+ RAM
  • ✓ Auto updates (Watchtower)
  • ✓ Container isolation

🐍 Python Mode

Lightest weight, for temporary use or low-spec machines

  • ✓ Lowest resource usage
  • ✓ Fastest startup
  • ⚠ī¸ Manual updates required

🚀 Python + Auto Update

Lightweight with auto updates, suitable for most users

  • ✓ Low resource usage
  • ✓ Auto updates every 5 min
  • ✓ No Docker needed

🌐Remote Access

Want to use from phone or outside network? Two options available

⚡ Quick Tunnel

No domain needed, simplest way

  • ✓ Zero config, one command
  • ✓ No domain required
  • ⚠ī¸ URL changes each time
cloudflared tunnel --url http://localhost:8765
📝 Generates temp URL like: https://xxx-yyy.trycloudflare.com

🔗 Fixed URL

For long-term use, permanent URL

  • ✓ URL never changes
  • ✓ run.bat auto-starts
  • ⚠ī¸ Requires your own domain
# First-time setup (once)
cloudflared tunnel login
cloudflared tunnel create ytify
cloudflared tunnel route dns ytify your.domain.com
🚀 Run setup wizard: setup-tunnel.bat

🔧Tampermonkey Setup

3 minutes to set up, one-click download on YouTube pages

1

Install Tampermonkey Extension

Choose the installation link for your browser:

🌐 Chrome đŸĻŠ Firefox 📘 Edge
2

Add Ytify Script

  1. Click the Tampermonkey icon in browser toolbar
  2. Select "Create new script"
  3. Delete default content, paste contents of scripts/ytify.user.js
  4. Press Ctrl + S to save
💡 Script file is located at scripts/ytify.user.js in the project
3

Start Using

  1. Make sure Ytify server is running
  2. Go to any YouTube video page
  3. A red "Download" button appears at bottom right of video
  4. Click to select quality and download
🔧 To connect to a remote server, click "Info" button to change server address

❓FAQ

Downloaded video has no sound?
Install FFmpeg:

Windows: winget install FFmpeg
Linux: sudo apt install ffmpeg
Tampermonkey script not working?
1. Make sure Ytify service is running
2. Click the script's Info button to check connection status
3. If using remote server, update the server address in script
Will auto-update interrupt downloads?
No! Ytify has a "graceful restart" mechanism that waits for all download tasks to complete before updating.
Which websites are supported?
Ytify uses yt-dlp, supporting YouTube, Bilibili, Twitter, and 1000+ websites.
Full list: yt-dlp supported sites
Window closes immediately?
run.bat will automatically detect and install Python, FFmpeg, Git. If already installed but not in PATH, the script will find and use them automatically.

If issues persist, make sure you're using Windows 10 1709+ or Windows 11 (requires winget).

📋Changelog

v10.7 2025-01 LATEST
  • NEW Failed task "Retry" button
  • NEW Task "Close" button (manually close completed/failed tasks)
  • NEW Panel "Clear" button (clear all tasks at once)
  • FIX Multi-task downloads no longer block
  • FIX Fixed rapid consecutive download freeze issue
v10.6 2025-01
  • NEW Concurrent download support (up to 3 simultaneous)
  • NEW "Merging" status display (FFmpeg processing phase)
  • NEW Graceful restart mechanism (auto-update doesn't interrupt downloads)
  • NEW Change server address while offline
v10.5 2025-01
  • NEW Real-time connection status detection
  • NEW Offline-friendly popup prompts
v10.0 2024-12
  • NEW WebSocket real-time progress push
  • NEW Playlist batch download
  • NEW Download history persistence
  • NEW Proxy pool support
  • NEW Smart retry with quality downgrade