Load custom .srt and .ass subtitle files for YouTube videos

Latest Version

Version
1.1.8
Update
December 17, 2024
Size
20.01KiB
Developer
Category
Users
0
Rating
0 ★
Manifest Version
3
Web Store Status
Languages Support
English (United States)
See more
Permissions
ActiveTab
Storage
Tabs
See more

YouTube Custom Subtitles Extension

# YouTube Custom Subtitles Extension

A Chrome browser extension that allows users to load and display custom subtitle files on YouTube videos.

## Key Features

### Subtitle File Support
- Supports .srt subtitle file format
- Supports .ass subtitle file format
- Real-time subtitle loading

### Subtitle Display Customization
- Font size adjustment (100% - 300%)
- Line spacing adjustment (-30px - +30px)
- Subtitle position adjustment (0% - 95%)
- Dual-line subtitle color selection
- Independent top line color setting
- Independent bottom line color setting
- Multiple preset color options: White, Yellow, Green, Cyan, Orange

### Preset Management
- Save current settings as preset
- Load saved presets
- Reset to system defaults

### Smart Video Detection
- Auto-detect YouTube video ID from subtitle filename
- One-click video loading
- Automatic subtitle synchronization

### Last Subtitle Memory
- Remembers the last loaded subtitle
- Quick reload of previous subtitles
- Persistent subtitle settings

### Subtitle Style
- Semi-transparent black background
- Text shadow effect
- Auto-centered alignment
- Click-through functionality (no mouse interference)

## How to Use

1. Click the extension icon to open the control panel
2. Click \"Choose File\" to load your subtitle file
3. Use sliders to adjust subtitle size, spacing, and position
4. Click color blocks to change subtitle colors
5. Save your settings as presets for future use
6. Use \"Load Last Subtitle\" to quickly reload previous subtitles

## Important Notes

- Subtitle files must be UTF-8 encoded
- Subtitle timestamps must sync with video timing
- Extension works only on YouTube website
- Settings are automatically saved in browser local storage
- For automatic video detection, include the YouTube video ID in the subtitle filename (e.g., \"subtitle[dQw4w9WgXcQ].srt\")

## Technical Features

- Real-time subtitle synchronization
- Support for YouTube dynamic page switching
- No interference with YouTube native functions
- Low resource usage
- Real-time subtitle style updates

## System Requirements

- Latest version of Chrome browser
- Active internet connection
- YouTube website access

## Privacy & Permissions

This extension:
- Does not collect any user data
- Works completely offline
- Requires minimal permissions (YouTube access only)
- Does not modify or interfere with other websites

## Support

For issues, suggestions, or contributions, please visit our GitHub repository.

## Version

Current version: 1.1.8
Read more

Source Manifest.json

{"update_url": "https://clients2.google.com/service/update2/crx", "manifest_version": 3, "name": "YouTube Custom Subtitles", "version": "1.1.8", "description": "Load custom .srt and .ass subtitle files for YouTube videos", "icons": { "48": "icon.png" }, "permissions": [ "activeTab", "storage", "tabs" ], "host_permissions": [ "*://*.youtube.com/*" ], "action": { "default_popup": "popup.html", "default_icon": "icon.png" }, "content_scripts": [ { "matches": ["*://*.youtube.com/*"], "js": ["content.js"], "css": ["subtitles.css"], "run_at": "document_start", "all_frames": true } ], "web_accessible_resources": [{ "resources": ["subtitles.css"], "matches": ["*://*.youtube.com/*"] }]}
Read more