📌 Kodi subtitles are on-screen text displays that translate or transcribe dialogue in movies and TV shows. Kodi supports both stand-alone subtitle files (SRT, ASS) and embedded subtitles within video containers. To download subtitles automatically, you need to install a subtitle addon like OpenSubtitles.com (requires a free account) or a4kSubtitles (no account needed).
⚠️ ADDON STATUS DISCLAIMER
Current Addon Status: 🟢 FULLY WORKING
Important Note: Both OpenSubtitles.com and a4kSubtitles are actively maintained and working. However, OpenSubtitles.org (the old version) is deprecated and will not work — you must use the new OpenSubtitles.com addon.
🔴 Critical Changes (2026):
- The old OpenSubtitles.org addon is broken — the service has migrated to
.com- OpenSubtitles.com now requires a free account (registration is mandatory)
- OpenSubtitles.com free accounts have daily download limits — see the rate limit warning below
- Kodi 22 “Piers” (Beta) introduces major subtitle improvements including visibility and timing fixes
✅ Verified Working Subtitle Addons (August 2026):
- OpenSubtitles.com — Official, 8M+ subtitles, 75 languages
- a4kSubtitles v3.24.2 — Multi-source, no account needed
- Subtris Subtitles v0.9.2 — Official repo addon, subt.is aggregation
- OpenSubtitles.com-dualsub v2.0.4 — Dual subtitle display
🔒 Privacy Warning: Subtitle downloads expose your IP address to third-party services. A VPN is strongly recommended for privacy when using any Kodi subtitle addon.
🚨 CRITICAL: OpenSubtitles.com Rate Limits
⚠️ Free accounts on OpenSubtitles.com are subject to daily download limits.
- Limit: Typically 100 subtitle downloads per day for free users.
- Consequence: Exceeding the limit will result in “No subtitles found” errors until the next day.
- Why it matters: If you binge‑watch multiple episodes or movies, you can hit the cap quickly, leaving you without subtitles for the rest of your session.
🔄 Immediate Fallback: Install a4kSubtitles (or Subtris Subtitles) alongside OpenSubtitles.com. When you hit the limit, simply use one of the fallback addons (which have no download caps) to continue watching without interruption.
For more details on OpenSubtitles.com’s policies, visit their official website.
What Are Kodi Subtitles?
Kodi subtitles are text overlays that display dialogue, translations, or captions during video playback. Whether you’re watching foreign films, struggling with accents, or in a noisy environment, subtitles enhance accessibility and comprehension.
Who Is This Guide For?
- Kodi users who want to add subtitles to movies and TV shows
- Users needing subtitles for foreign language content
- Those with hearing accessibility needs
- Anyone experiencing audio issues or watching in quiet environments
What You’ll Learn:
- 📝 How subtitles work in Kodi
- 🔧 Built-in subtitle settings and configuration
- 📥 Installing OpenSubtitles.com, a4kSubtitles, and Subtis Subtitles
- 🎮 Using subtitles during playback (OSD)
- 🛠️ Troubleshooting common subtitle issues
- 🚀 Advanced features (AI translation, dual subtitles, subtitle editing)
📋 “No-Click” Quick-Reference Cheatsheet
For experienced users — skip the reading and configure now.
| Item | Details |
|---|---|
| Official Subtitle Addon | OpenSubtitles.com (from Kodi repository) |
| Community Subtitle Addon | a4kSubtitles (multi-source, no account) |
| Official Alternative | Subtis Subtitles (subt.is aggregation) |
| OpenSubtitles Registration | https://www.opensubtitles.com/en |
| a4kSubtitles Repository URL | https://a4k-openproject.github.io/a4kSubtitles/packages/ |
| a4kSubtitles Repository ZIP | a4kSubtitles-repository.zip |
| Current OpenSubtitles.com Version | v1.0.10 (July 1, 2026) |
| Current a4kSubtitles Version | v3.24.2 (August 2, 2026) |
| Current Subtis Subtitles Version | v0.9.2 (February 15, 2026) |
| Kodi Compatibility | Kodi 20 Nexus, Kodi 21 Omega, Kodi 22 Piers |
| Addon Status | 🟢 All Working |
🟢 Subtitle Addons Status Report & Testing Log
| Metric | Status |
|---|---|
| OpenSubtitles.com Version | v1.0.10 — actively maintained |
| a4kSubtitles Version | v3.24.2 — actively maintained |
| Subtris Subtitles Version | v0.9.2 — official repository |
| OpenSubtitles Database | 8,000,000+ subtitles in 75 languages |
| a4kSubtitles Providers | Addic7ed, BSPlayer, OpenSubtitles, Podnadpisi.NET, SubDL, SubSource |
| Supported Formats | SRT, VPlayer, SAMI, MPL2, MicroDVD, SSA/ASS, WebVTT, VobSub, PGS, SUP |
| Tested Hardware | Amazon Fire TV Stick 4K Max, Chromecast with Google TV, NVIDIA Shield, Windows PC |
| VPN Requirement | ⚠️ Highly Recommended — protects privacy when downloading subtitles |
📥 Installation Tutorial: Subtitle Addons on Kodi
Prerequisite Phase (Part 1): No Special Setup Required
Unlike third-party video addons, subtitle addons do not require enabling “Unknown Sources“ because they are installed from the official Kodi repository (OpenSubtitles.com, Subtis Subtitles) or from a trusted community repository (a4kSubtitles).
Note: For a4kSubtitles, you will need to add a file source, but this does not require changing the “Unknown Sources” setting.
Part 2: Install OpenSubtitles.com (Official — Recommended)
OpenSubtitles.com is the official subtitle addon available directly from the Kodi repository. It provides access to over 8 million subtitles in 75 languages with daily updates.
Step 1: Create an OpenSubtitles Account
⚠️ CRITICAL: OpenSubtitles.com requires a free account to download subtitles. The old OpenSubtitles.org will not work.
- Open a browser and go to:
https://www.opensubtitles.com/en
- Click the Register link at the top of the page
- Enter your username, email, and password
Complete the CAPTCHA and agree to the terms
Click Register
Open your email and click the confirmation link to verify your account
Step 2: Install the OpenSubtitles.com Addon
Launch Kodi and go to the Settings (gear icon) at the top left
Select Add-ons (puzzle piece icon)
Choose Install from repository
Kodi Addon Repository
Select Subtitles (or Subtitle services)
Find and click OpenSubtitles.com
Click the Install button
Wait for the “Addon installed” notification
Step 3: Configure OpenSubtitles.com
- In the addon list, click OpenSubtitles.com again
- Select Configure
- Enter your OpenSubtitles username and password created earlier
Click Test Connection to verify your credentials (added in v1.0.9)
Click OK to save
💡 Pro Tip: OpenSubtitles.com v1.0.9 also added search results caching with configurable duration for faster repeated searches.
Part 3: Install a4kSubtitles (Alternative — No Account Required)
a4kSubtitles is a community-developed subtitle addon that does not require an account and aggregates subtitles from multiple sources.
Providers included: Addic7ed, BSPlayer, OpenSubtitles, Podnadpisi.NET, SubDL, SubSource
Step 1: Add the Repository Source
- Launch Kodi and go to the Settings (gear icon)
- Select File Manager
- Click Add source
- Click on
<None>and enter the repository URL:https://a4k-openproject.github.io/a4kSubtitles/packages/ - Name the source
a4kSubtitles-repoand click OK
Step 2: Install the Repository
- Go back to the main menu and select Add-ons
- Click the Add-on browser (open box icon) at the top left
- Select Install from zip file
- Find and select the
a4kSubtitles-repofolder - Click
a4kSubtitles-repository.zip - Wait for the repository installation notification
Step 3: Install a4kSubtitles
- Select Install from repository
- Find and select the a4kSubtitles repository
- Select the a4kSubtitles addon and click Install
Part 4: Install Subtis Subtitles (Official Alternative)
Subtris Subtitles is an official Kodi repository addon (v0.9.2, updated February 15, 2026) that downloads subtitles from the subt.is aggregation service.
Installation Steps:
- Launch Kodi and go to the Settings (gear icon)
- Select Add-ons → Install from repository
- Select Kodi Add-on repository → Subtitles
- Find and click Subtris Subtitles
- Click Install
- Wait for the “Addon installed” notification
💡 Why Subtis Subtitles? It’s a lightweight, official alternative that doesn’t require an account and pulls from a dedicated subtitle aggregation service.
⚙️ Configuring Subtitle Settings in Kodi
Set Default Subtitle Language
To set your preferred subtitle language for all videos:
Go to Settings → Player → Language
Under Subtitles, select your Preferred Subtitle Language
Configure Download Services
To tell Kodi which subtitle provider to use:
- Go to Settings → Player → Language
- Scroll down to Download Services
- Set Default TV Shows service → Select your installed addon
- Set Default Movie service → Select your installed addon
Advanced Subtitle Settings
Access additional subtitle options:
- Go to Settings → Player → Subtitles
- Available options include:
| Setting | Description |
|---|---|
| Font | Select subtitle font. Additional .ttf/.otf fonts can be added to \media\fonts\ in the Kodi data folder |
| Subtitle position | Adjust vertical on-screen location |
| Brightness (HDR) | Adjust GUI peak luminance for HDR subtitles |
🎮 Using Subtitles During Playback
Enabling & Downloading Subtitles
- Start playing a movie or TV show in Kodi
- Bring up the On-Screen Display (OSD) by:
- Pressing the Enter/OK button on your remote
- Pressing the Tab key on a keyboard
- Clicking the screen on a touch device
Select the subtitle/audio options icon (speech bubble or speaker icon)
Available options:
- Enable subtitles — Toggle on/off
- Subtitle offset — Adjust sync in milliseconds
- Subtitle — Select which subtitle stream to display
- Browse for subtitle — Load an external subtitle file
- Download subtitle — Fetch subtitles from your configured addon
- Set as default for all videos — Save current settings
Downloading Subtitles On-the-Fly
- During playback, bring up the OSD
- Select the subtitle/audio options icon
- Click Download subtitle (or use the Manual search button for custom titles)
- Kodi will search for available subtitles
- Choose a subtitle from the list (preferably one with a high user rating)
- The subtitle will download and display automatically
Adjusting Subtitle Sync (Offset)
If subtitles are out of sync:
- During playback, bring up the OSD
- Select the subtitle/audio options icon
- Use the Subtitle offset slider
- Adjust in milliseconds — positive values delay subtitles, negative values advance them
Keyboard shortcuts:
- SubtitleShiftUp — Shift subtitles later (delay)
- SubtitleShiftDown — Shift subtitles earlier
Setting Subtitles Off by Default
If you prefer subtitles off by default:
- During playback, bring up the OSD
- Select the subtitle/audio options icon
- Turn off the “Subtitles” toggle
- Scroll down and select “Save as default for all videos”
🚀 Advanced Subtitle Features (2026)
Dual Subtitles (OpenSubtitles.com-dualsub)
The OpenSubtitles.com-dualsub addon allows displaying two subtitles simultaneously — perfect for language learning.
Current Version: v2.0.4 (July 14, 2026)
Installation:
- Available from the OpenSubtitles.com-dualsub GitHub repository
AI Subtitle Translation
Several addons now offer AI-powered subtitle translation:
- PolyglotSubs-Kodi — Fork of a4kSubtitles enhanced with AI-translated subtitles
- kodi-subtitle-translator — Supports 10 translation services including DeepL, Google Translate, OpenAI
Subtitle Editing (Sublissimo)
Sublissimo is a Kodi addon that allows editing and synchronizing subtitles directly within Kodi using your remote.
Key Features:
- Edit specific lines
- Move or stretch subtitles
- Synchronize with other subtitles
- Synchronize with a videofile
Current Version: v2.0.7 (May 29, 2026)
Installation: Available from the Kodi official repository under Program add-ons
Translatarr
Translatarr detects subtitles during playback, translates them automatically, and switches to the translated version.
🔄 Kodi 22 “Piers”: What’s New for Subtitles (2026)
⚠️ Note: Kodi 22 “Piers” is currently in Beta 1 (released June 28, 2026). It is intended for testing only — not recommended for daily use on primary devices.
Kodi 22 “Piers” Beta 1 introduces significant subtitle improvements:
| Improvement | Details |
|---|---|
| Subtitle visibility | Fixed issues with subtitles not displaying properly |
| Subtitle timing | Improved sync accuracy |
| ASS/SSA handling | Fixed script header parsing |
| Subtitle CODEC display | Shows the codec of the current subtitle during playback |
| HDR subtitle brightness | Fixed very bright subtitles when playing HDR/DolbyVision content |
| WebVTT (ISOBMFF) | Fixed handling |
| PGS/VobSub selection | Fixed subtitle selection for foreign audio tracks |
| H264 AVCC subtitles | Added support |
For the latest updates, see our guide on how to update Kodi to the latest version.
🔄 Working Alternatives to OpenSubtitles
If OpenSubtitles doesn’t work for you, here are verified alternatives:
| Addon | Account Required | Sources | Status | Version |
|---|---|---|---|---|
| a4kSubtitles | ❌ No | Addic7ed, BSPlayer, OpenSubtitles, Podnadpisi.NET, SubDL, SubSource | 🟢 Working | v3.24.2 |
| Subtris Subtitles | ❌ No | subt.is aggregation service | 🟢 Working | v0.9.2 |
| Podnapisi | ❌ No | Multi-language service | 🟢 Working | — |
| Subscene Subtitles | ❌ No | Subscene website | 🔴 Unreliable/Inactive | — |
🧰 Troubleshooting: Common Subtitle Errors
❌ “No subtitles found” or subtitles not downloading
Solutions:
- Check OpenSubtitles credentials: Ensure you’ve entered the correct username and password in the addon configuration.
- Verify account is verified: Check your email for the OpenSubtitles confirmation link.
- Use opensubtitles.com, not .org: The old
.orgAPI is deprecated and will not work. - For a4kSubtitles: No account needed, but ensure the addon is properly installed.
- Check your internet connection: Subtitles require an active connection.
- Test Connection: Use the Test Connection button in OpenSubtitles.com settings (v1.0.9+).
- ⚠️ Rate limit hit: If you’ve downloaded many subtitles today, you may have exceeded the free daily cap. Switch to a4kSubtitles or Subtris Subtitles as a fallback.
⏱️ Subtitles out of sync (too early or too late)
Solutions:
- Use the Subtitle offset slider during playback — adjust in milliseconds.
- For persistent issues, try a different subtitle source.
- Use
SubtitleShiftUpandSubtitleShiftDownkeyboard shortcuts. - For ASS/SSA subtitles, Kodi 22 “Piers” includes timing improvements.
📺 External subtitles not showing
Solutions:
- Verify file naming: This is the #1 cause of external subtitle failures. Follow the exact syntax:
<video_filename>.<language_code>.<extension>(e.g.,Avatar.en.srt). - The subtitle file must be in the same folder as the video file, and the base name must exactly match the video file’s base name.
- Nvidia Shield users: Go to Shield Settings → Apps → Kodi → Permissions → Files and Media → select “Allow all the time”.
- Check file permissions: Ensure Kodi has permission to read the subtitle files.
🔤 ASS/SSA subtitles not displaying correctly
Solutions:
- Kodi 22 “Piers” has improved ASS/SSA handling — consider updating.
- Check the
ScriptTypeline in the ASS file — add a space afterScriptType:if missing. - Ensure you have the correct fonts installed for ASS/SSA subtitles.
- Try converting ASS to SRT format using external tools.
🔴 “Wrong username/do not use email as username” error
Solutions:
- OpenSubtitles requires your username, not your email address, for login.
- Log in to opensubtitles.com to confirm your username.
- Update the addon configuration with your correct username.
🔄 Subtitles buffer or load slowly
Solutions:
- Check your internet connection: Subtitle downloads require stable internet.
- Try a different subtitle source: Some providers may be slower than others.
- Clear Kodi cache: Go to
Settings→System→Add-ons→Manage dependencies→ clear cache. - Check OpenSubtitles server status: Visit the official OpenSubtitles forum for updates.
📦 Inputstream.adaptive compatibility issues
Solutions:
- Some users report Inputstream.adaptive incompatibility with newer Kodi versions.
- Try disabling Inputstream.adaptive in the addon playback settings.
- Update Kodi to the latest version (21.2 or 22 Piers Beta).
❓ Frequently Asked Questions
Does Kodi have built-in subtitles?
Yes, Kodi has built-in subtitle support for both embedded and external subtitle files. However, to download subtitles automatically, you need to install a subtitle addon like OpenSubtitles.com, a4kSubtitles, or Subtis Subtitles.
Is OpenSubtitles free?
Yes, OpenSubtitles.com offers free accounts with access to over 8 million subtitles. Registration is required for downloading subtitles through Kodi. Free accounts have daily download limits — typically around 100 downloads per day.
Do I need an account for a4kSubtitles?
No — a4kSubtitles does not require any account registration. It aggregates subtitles from multiple sources including OpenSubtitles, Addic7ed, and others.
What subtitle formats does Kodi support?
Kodi supports text-based formats (SRT, VPlayer, SAMI, MPL2, MicroDVD, SSA/ASS, WebVTT) and image-based formats (VobSub, PGS, SUP) introduced in Kodi 20.
How do I fix out-of-sync subtitles?
During playback, bring up the OSD, select the subtitle options, and use the Subtitle offset slider to adjust timing in milliseconds.
Why aren’t my external subtitles showing?
Check that the subtitle file is named correctly: <movie name>.<language_code>.<extension> (e.g., Avatar.en.srt). Use 2-digit language codes like en instead of eng. Also ensure the file is in the same folder as the video and that the base name matches exactly.
Can I use multiple subtitle addons?
Yes — you can install multiple subtitle addons and set their priority order in Settings → Player → Language → Download Services.
Does Kodi 22 change anything about subtitles?
Yes — Kodi 22 “Piers” Beta 1 includes subtitle visibility improvements, timing improvements, fixed ASS/SSA handling, and shows the subtitle CODEC during playback.
OpenSubtitles.org vs OpenSubtitles.com — what’s the difference?
OpenSubtitles.org is deprecated and will not work with Kodi anymore. You must use the new OpenSubtitles.com addon, which requires creating a new account on the .com website.
How do I set subtitles off by default?
During playback, bring up the OSD, turn off the “Subtitles” toggle, and select “Save as default for all videos”.
What is Subtis Subtitles?
Subtris Subtitles is an official Kodi repository addon (v0.9.2) that downloads subtitles from the subt.is aggregation service. It’s a lightweight alternative that doesn’t require an account.
What is Sublissimo?
Sublissimo is a Kodi addon that allows editing and synchronizing subtitles directly within Kodi using your remote. You can edit specific lines, move or stretch subtitles, and synchronize with other subtitles or a videofile.
What are the OpenSubtitles.com rate limits?
Free accounts on OpenSubtitles.com are limited to approximately 100 subtitle downloads per day. If you exceed this, you’ll get errors until the next day. Install a4kSubtitles as a fallback to avoid interruptions.
✅ Conclusion
Setting up subtitles on Kodi is essential for enjoying foreign language content, improving comprehension, and accommodating different viewing environments. With the right configuration, Kodi can automatically fetch subtitles for almost any movie or TV show.
Key Takeaways:
- 📝 Kodi supports multiple subtitle formats — SRT, ASS, PGS, and more
- 📥 OpenSubtitles.com is the official recommended addon — requires a free account and has daily download caps
- 🔄 a4kSubtitles v3.24.2 is a great alternative — no account needed, multiple sources, and no daily limits
- 🆕 Subtris Subtitles v0.9.2 — official repo alternative from subt.is
- 🎯 Always use the correct file naming syntax —
<filename>.<lang>.srt— to ensure external subtitles load - ⚙️ Configure your preferred subtitle language in Player settings
- 🎮 Use the OSD during playback to enable, download, or sync subtitles
- ⏱️ Adjust subtitle offset if subtitles are out of sync
- 🔒 Use a VPN for privacy when using third-party addons
- 🚀 Kodi 22 “Piers” brings significant subtitle improvements
- ⚠️ OpenSubtitles.org is dead — use OpenSubtitles.com instead
- ✏️ Sublissimo lets you edit and sync subtitles with your remote
Stream smart, stay safe, and enjoy your content with perfect subtitles! 🎬
📚 See Also
- Best Kodi Addons Guide — Complete guide to the top Kodi addons
- Kodi Maintenance Addons — Keep Kodi running smoothly
- Best VPN Providers — Protect your privacy while streaming
- Install Kodi on Firestick — Get Kodi setup on Amazon devices
- Fix Common Kodi Problems — Troubleshooting guide
This guide was written by Simturax – a technology and streaming media specialist with over 10 years of experience covering Kodi, Firestick, Android TV, and IPTV. All instructions were physically tested on actual hardware (Fire TV Stick 4K Max, NVIDIA Shield, Chromecast with Google TV) and verified. We prioritize accuracy, transparency, and user safety above all else.
