← Back to All Articles
Tutorials & GuidesAugust 24, 2026 6 min read

How to Add Sinhala Subtitles to Any Video Player (VLC, MX Player, MPV & Mobile)

Written by Srisubs Engineering

Introduction

Watching your favorite movies and TV series with Sinhala subtitles is a fantastic experience, but older media players often struggle to render Sinhala Unicode characters correctly. You may have experienced missing vowel modifiers (පිල්ලම්), square boxes, or disconnected letters when loading an `.srt` file.

In this guide, we'll walk through how to configure the most popular media players on PC, Mac, and mobile to ensure crisp, beautifully rendered Sinhala subtitles every time.

---

1. VLC Media Player (Windows & Mac)

VLC is the world's most versatile video player, but by default, its subtitle font may not have full Sinhala Unicode glyph support.

Step-by-Step Setup: 1. **Name Matching Method**: - Place your video file and subtitle file in the exact same folder. - Give them identical names (e.g., `Inception.2010.1080p.mp4` and `Inception.2010.1080p.srt`). - Open the video in VLC, and the subtitles will load automatically.

2. **Fixing Broken Sinhala Fonts in VLC**: - Go to **Tools** > **Preferences** (or press `Ctrl + P` on Windows, `Cmd + ,` on Mac). - In the bottom-left corner, switch **Show settings** to **All**. - Navigate to **Video** > **Subtitles / OSD** > **Text renderer**. - Set **Font** to **Iskoola Pota**, **Noto Sans Sinhala**, or **Nirmala UI**. - Set **Subtitle text encoding** to **Universal (UTF-8)**. - Click **Save** and restart VLC.

3. **Adjusting Subtitle Timing (Sync Fix)**: - If the audio and subtitles are out of sync: - Press `G` to delay subtitles (if subtitles appear too early). - Press `H` to speed up subtitles (if subtitles appear too late).

---

2. MX Player (Android)

MX Player is the top choice for Android devices and natively supports UTF-8 Sinhala subtitles.

Setup Instructions: 1. Open the video in MX Player. 2. Tap the **Subtitle** icon in the top-right corner. 3. Tap **Open** > browse to your downloaded Sinhala `.srt` or `.vtt` file. 4. **Font Styling & Encoding**: - Go to **Settings** > **Subtitle** > **Character Encoding** > select **UTF-8**. - Under **Appearance**, select a clean sans-serif font and enable a subtle text shadow or black border for high legibility over bright scenes.

---

3. MPV Player (Windows, macOS, Linux)

MPV is an ultra-fast, lightweight player favored by power users. It handles complex text shaping and Sinhala diacritics natively through libass.

Configuration (`mpv.conf`): Add the following lines to your `mpv.conf` file for optimal Sinhala typography:

# Subtitle Font Settings
sub-font="Noto Sans Sinhala"
sub-font-size=48
sub-color="#FFFFFFFF"
sub-border-color="#FF000000"
sub-border-size=3.2
sub-shadow-offset=1
sub-codepage=utf-8

---

4. Web Browsers (HTML5 Video & WebVTT)

If you are embedding Sinhala subtitles on a website using the HTML5 `<video>` element, use the **WebVTT** format:

<video controls width="800" poster="movie-poster.jpg">
  <source src="movie.mp4" type="video/mp4" />
  <track
    label="Sinhala (Spoken)"
    kind="subtitles"
    srclang="si"
    src="movie.si.vtt"
    default
  />
</video>

Ensure your web page imports a web font such as `Noto Sans Sinhala` via Google Fonts so that browsers across all operating systems render the letters uniformly.

---

Summary Checklist - Always ensure your subtitle files are saved in **UTF-8 encoding**. - Keep subtitle files in the same directory as the video with matching names. - Select a Unicode font like **Noto Sans Sinhala** or **Iskoola Pota** in your player preferences.