YouTube Custom Subtitles

About

# 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
2024.12.17
First release. version: 1.1.8

2024.12.18
Version 1.1.9 Updates:
• Fixed background opacity adjustment
• Optimized settings interface layout
• Updated default values
• Improved overall user experience
• Unified interface design

版本 1.1.9 更新內容：
• 修復背景透明度調整功能
• 優化設置界面佈局和視覺效果
• 更新預設值設定
• 改進整體使用體驗
• 統一界面樣式設計

2024.12.23
Version 1.2.0 Update Notes

New Features & Improvements:
- Enhanced subtitle background height control system for more precise adjustments
- Optimized background height range to a more reasonable interval (0-40px)
- Improved subtitle style processing mechanism for better display
- Enhanced subtitle background rendering performance

Bug Fixes:
- Fixed issue with excessive subtitle background height
- Corrected background height calculation method
- Improved height control precision

Other Updates:
- Enhanced real-time settings update mechanism
- Optimized overall user experience

版本 1.2.0 更新說明

新功能與改進：
- 優化字幕背景高度控制系統，提供更精確的調整
- 調整背景高度範圍至更合理的區間（0-40px）
- 改進字幕樣式處理機制，提升顯示效果
- 優化字幕背景渲染效能

修復：
- 修復字幕背景高度過大的問題
- 修正背景高度的計算方式
- 改進高度控制的精確度

其他更新：
- 改進設定值的即時更新機制
- 優化整體使用體驗