Description: A modern VLC extension for downloading subtitles from OpenSubtitles.com using their latest REST API.
Features: 🔍 Smart Search: Hash-based search for exact matches + name-based search with GuessIt integration 🌐 Multi-language Support: Select up to 3 preferred subtitle languages with intelligent prioritization 🎯 Auto-detection: Automatic locale detection from system settings, timezone, and IP geolocation 📱 Modern API: Uses OpenSubtitles.com REST API v1 for better performance and reliability 🔄 Auto-updates: Built-in update mechanism keeps the extension current 🎬 Smart Metadata: GuessIt API integration for accurate movie/TV show detection 🏆 Quality Indicators: Shows trusted uploaders, download counts, sync quality, and ratings 💾 Flexible Download: Auto-load subtitles or save manually with language codes 🌍 Country-specific Languages: Intelligent language suggestions based on your location
Manual Install: 1. Download the latest vlsubcom.lua from https://github.com/opensubtitles/vlsub-opensubtitles-com/releases/latest/download/vlsubcom.lua 2. Copy to your VLC extensions directory: - Windows: %APPDATA%\vlc\lua\extensions\ - macOS: ~/Library/Application Support/org.videolan.vlc/lua/extensions/ - Linux: ~/.local/share/vlc/lua/extensions/ 3. Restart VLC Media Player 4. Access via View → VLSub OpenSubtitles.com
Requirements
- VLC Media Player 3.0 or newer - www.OpenSubtitles.com account (free registration) - Internet connection for searching and downloading - curl command-line tool (for downloads - usually pre-installed)
How to Use
1. Setup: Open VLC → View → VLSub OpenSubtitles.com → Config 2. Login: Enter your OpenSubtitles.com username and password 3. Play: Start your video file 4. Search: Click "🎯 Search by Hash" for exact matches or "🔍 Search by Name" 5. Download: Select subtitle an click download to load automatically
Search Methods
Hash Search (Recommended) - Best for: Local video files - Accuracy: Finds exactly synchronized subtitles - How it works: Calculates unique file fingerprint for perfect matching or failback to name search
Name Search - Best for: Streaming content, renamed files, or when hash fails - Features: Uses GuessIt to extract title, year, season, episode from filename - Flexibility: Works with various naming conventions
Language Support
Multi-language Priority System: - Primary Language: Your main subtitle preference - Secondary + Third: Fallback languages shown in priority order - Auto-detection: Extension detects your locale and suggests appropriate languages + English language as default - Country-specific: Suggests languages commonly understood in your region
The extension supports 100+ languages including: - Major Languages: English, Spanish, French, German, Italian, Portuguese, Russian, Chinese, Japanese, Korean - Regional Variants: Brazilian Portuguese, Latin Spanish, Simplified/Traditional Chinese - European Languages: All EU languages plus Nordic, Slavic, and Baltic languages - Global Languages: Arabic, Hindi, Hebrew, Persian, Thai, Vietnamese, and many more
Quality Indicators
🎯 Perfect match (moviehash sync) ✓ Trusted uploader 🎬 HD quality ♿ Hearing impaired 🤖 AI translated ⚙️ Machine translated
Configuration Options
- Download Behavior: Load+Save or Manual download - Language Codes: Add language codes to filenames (e.g., movie.en.srt) - Tag Removal: Clean subtitle formatting tags - Working Directory: Custom location for subtitle storage - Auto-updates: Enable/disable automatic update checks - this is automatic
Troubleshooting
No results found - Ensure video file is local for hash search - Try name search with manual title entry - Check if subtitle exists on OpenSubtitles.com
Authentication failed - Verify OpenSubtitles.com credentials - Check internet connection - Ensure account is active (not banned)
Download failed - Check download quota (free accounts have daily limits) - Verify curl is installed: curl --version - Try again later if server is busy
Extension not visible - Restart VLC completely - Check file is in correct extensions directory - Verify VLC version 3.0+
Credits
- OpenSubtitles.com for providing the subtitle database and API - VideoLAN Team for VLC Media Player - Original vlsub authors for inspiration - GuessIt project for metadata extraction - Community contributors for testing and feedback
Support the Project
⭐ Rate, Comment or Become supporter 🐛 Report bugs to help improve the extension 💡 Suggest features for future releases 🔗 Share with other VLC users ☕ Support OpenSubtitles.com with a donation
This project is licensed under the GNU General Public License v3.0.
Ratings & Comments
0 Comments