Skip to content

IbraTech04/subly

Repository files navigation

Subly Logo

Subly

Chrome Extension JavaScript

A powerful Chrome extension that injects your own SRT subtitles into YouTube videos

🚀 Quick Start✨ Features📖 Usage Guide


Overview

Ever been frustrated by missing captions on YouTube videos? Or wanted to add your own custom subtitles for language learning, accessibility, or creative projects? Subly is here to revolutionize your YouTube viewing experience!

This lightweight Chrome extension allows you to effortlessly inject SRT subtitle files directly into any YouTube video, displaying them using YouTube's native subtitle interface for a completely seamless experience.

Features

  • Full support for SRT subtitle files, including subtitle styling and formatting
  • Native support for my Sendokai Subtitles project!
  • Easy-to-use popup interface for loading subtitles
  • Customizable subtitle styles, syncing, and more
  • Toggle subtitles on/off with a single click
  • Works with any YouTube video!

🚀 Installation

📦 Stable Release

# Chrome Web Store (Coming Soon!)
🌐 Stay tuned for the official release

🛠️ Development Version

  1. Clone the repository

    git clone https://github.com/IbraTech04/subly
    cd subly
  2. Open your browser's extension manager

    • Chrome: Navigate to chrome://extensions/
    • Edge: Navigate to edge://extensions/
    • Brave: Navigate to brave://extensions/
  3. Enable Developer Mode

    • Toggle the "Developer mode" switch in the top-right corner
  4. Load the extension

    • Click "Load unpacked"
    • Select the cloned subly folder
    • ✅ You're all set!

Usage

Quick Start Guide

  1. 📺 Open any YouTube video

    • Navigate to your favorite YouTube content
  2. 🔧 Access Subly

    • Click the Subly extension icon in your browser toolbar
    • The intuitive popup interface will appear
  3. 📁 Load your subtitles

    • Option A: Upload an SRT file directly
    • Option B: Paste a URL to your online SRT file then click "Fetch"
  4. 🎬 Inject subtitles

    • Click "Load Subtitles"
    • Watch as your custom subtitles seamlessly integrate with YouTube's player!
    • Subly also injects a button to toggle subtitles on/off in the native YouTube player!

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

What this means:

  • ✅ You can use this project for personal and commercial purposes
  • ✅ You can modify and distribute this code
  • ✅ You can contribute to this project
  • ⚠️ You must include the original license notice

🤝 Contributing

We welcome contributions from the community! Whether it's bug fixes, feature additions, or documentation improvements, your help makes Subly better for everyone.

About

YouTube SRT Injector Chrome Extension

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published