Skip to main content

Download YouTube videos and burn Netflix-style subtitles automatically

Project description

SubPlz - Subtitle Pipeline for Everyone

Automatically download YouTube videos and burn Netflix-style subtitles into them!

PyPI version Python 3.8+ License: MIT

Features

  • One-command processing - Just provide a YouTube URL or local video
  • Netflix-style subtitles - Professional yellow text with black background
  • AI-powered transcription - Uses OpenAI Whisper for accurate subtitles
  • Multiple formats - Supports YouTube URLs and local video files
  • Smart dependency handling - Guides you through installing missing dependencies
  • Automatic cleanup - Removes temporary files after processing

Installation

pip install subtitle-for-everyone

System Requirements

Required Dependencies

  • Python 3.8+
  • FFmpeg - For video processing
    • Windows: Download from ffmpeg.org
    • macOS: brew install ffmpeg
    • Linux: sudo apt install ffmpeg

Python Dependencies (Installed Automatically)

  • yt-dlp - YouTube video downloading
  • openai-whisper - AI subtitle generation
  • torch - Machine learning backend
  • ffmpeg-python - Video processing
  • tqdm - Progress bars

Quick Start

Process YouTube Videos

# Single YouTube video
subplz https://www.youtube.com/watch?v=VIDEO_ID

# The command will:
# 1. Download the video
# 2. Generate subtitles using AI
# 3. Burn Netflix-style subtitles into the video
# 4. Save to 'processed_videos' folder

Process Local Videos

# Local video file
subplz /path/to/your/video.mp4
subplz "C:\\Users\\Name\\Videos\\myvideo.mp4"

Custom Output Directory

subplz https://www.youtube.com/watch?v=VIDEO_ID -o my_output_folder

Netflix-Style Subtitles

SubPlz creates professional subtitles that look just like Netflix:

  • Yellow text (#FFFF00) for visibility
  • Black background box with semi-transparency
  • Arial Bold font at size 22
  • Bottom center positioning with proper margins
  • Thick black outline for readability on any background

Output

  • Processed videos are saved with _with_subtitles suffix
  • Original video quality is preserved
  • Subtitles are permanently burned into the video
  • Temporary files are automatically cleaned up

Dependency Troubleshooting

If you get dependency errors, SubPlz will guide you:

Missing FFmpeg

Missing dependencies: ffmpeg

Installation Instructions:
To install FFmpeg:
   Windows: Download from https://ffmpeg.org/download.html
   macOS: brew install ffmpeg  
   Linux: sudo apt install ffmpeg
   Then add FFmpeg to your system PATH

Missing yt-dlp

Missing dependencies: yt-dlp

Installation Instructions:  
To install yt-dlp:
   pip install yt-dlp

Advanced Configuration

SubPlz uses sensible defaults, but you can customize behavior by modifying the config:

# In your Python code
from subplz.config import NETFLIX_SUBTITLE_STYLE

# Customize subtitle appearance
NETFLIX_SUBTITLE_STYLE['fontsize'] = 24  # Bigger text
NETFLIX_SUBTITLE_STYLE['primary_colour'] = "&Hffffff"  # White text

Examples

Basic Usage

# Download and add subtitles to a YouTube video
subplz "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

Batch Processing Script

import subprocess

urls = [
    "https://www.youtube.com/watch?v=VIDEO1",
    "https://www.youtube.com/watch?v=VIDEO2", 
    "https://www.youtube.com/watch?v=VIDEO3"
]

for url in urls:
    subprocess.run(["subplz", url])

Local Video Processing

# Add subtitles to local videos
subplz "/Users/name/Movies/lecture.mp4"
subplz "C:\\Downloads\\presentation.mp4"  

Troubleshooting

Common Issues

  1. "Command not found: subplz"

    pip install --upgrade subtitle-for-everyone
    # Or try: python -m subplz
    
  2. "FFmpeg not found"

    • Install FFmpeg and add to system PATH
    • Restart terminal after installation
  3. Out of memory errors

    • Use smaller Whisper model: modify WHISPER_MODEL = "tiny" in config
  4. Video download failures

    • Some videos may be region-blocked or private
    • Try different video URLs

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

Acknowledgments


Made with care by Sid & Kan

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

subtitle_for_everyone-1.0.2.tar.gz (11.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

subtitle_for_everyone-1.0.2-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

File details

Details for the file subtitle_for_everyone-1.0.2.tar.gz.

File metadata

  • Download URL: subtitle_for_everyone-1.0.2.tar.gz
  • Upload date:
  • Size: 11.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.0

File hashes

Hashes for subtitle_for_everyone-1.0.2.tar.gz
Algorithm Hash digest
SHA256 446960a311865278af93bddb33fc3e51cbcc59967b184d96054af3c6a96b14ae
MD5 96e22c942bd914608d676f58dbcb51f7
BLAKE2b-256 cff5921b77d70b919bb69ef358e7381222f585355d6e51166e2ad220ca728768

See more details on using hashes here.

File details

Details for the file subtitle_for_everyone-1.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for subtitle_for_everyone-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ef07f86684842a8afcdff1fe2abe9167257aac1e4a5753ff4bcc71a25e5ced86
MD5 43c255f5c177acaf489b5b07fcf74eb7
BLAKE2b-256 122114a3ff09e8dde39f2848a8c34457a3b05341466b2c864d6fd9d821a80278

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page