Fix FFmpeg Arabic Subtitles

Fix Arabic Words Showing Square Boxes and Burnt Subtitles with FFmpeg

Abstract: Learn how to resolve issues with Arabic text displaying as square boxes and burnt subtitles in your video files using FFmpeg. This guide covers font selection, encoding, and file format adjustments for optimal playback.

Created: 2024-12-22 by

Working with subtitles, especially in non-Latin scripts like Arabic, can sometimes be challenging. One such issue is when Arabic words appear as square boxes in burnt subtitles. This article will explain the causes of this problem and provide a solution using the FFmpeg tool.

Understanding Subtitles and FFmpeg

Subtitles are textual versions of a film or television program's dialogue that appear on screen. They can be separate (soft) subtitles that users can enable or disable, or they can be burnt (hard) subtitles, which are permanently embedded into the video.

FFmpeg is a powerful, open-source tool that can handle a wide range of multimedia tasks, including video and audio encoding, decoding, and manipulation. It supports various subtitle formats, such as SRT, ASS, and SSA.

The Issue: Square Boxes in Arabic Subtitles

When Arabic words appear as square boxes in burnt subtitles, it is usually due to a font-related issue. This problem typically occurs when the Arabic characters are not properly encoded, or the required font is not installed on the system used to burn the subtitles.

Improperly Encoded Characters

Arabic characters might not be encoded correctly if the subtitle file uses the wrong character encoding or if the encoding conversion was not done properly. In such cases, FFmpeg might not be able to render the characters correctly, displaying square boxes instead.

Missing Fonts

If the required Arabic font is not installed on the system, FFmpeg might not be able to display the characters correctly. Instead, it will show square boxes. This issue is more likely to occur with burnt subtitles since the system rendering the video does not have direct access to the required font files.

Solution: Fix Arabic Words Showing Square Boxes in FFmpeg

To fix Arabic words showing square boxes in burnt subtitles with FFmpeg, follow these steps:

  1. Obtain the necessary Arabic font files if they are not already installed on your system. Choose a font that supports the Arabic characters you plan to use in your subtitles.
  2. Convert the subtitle file to the ASS/SSA format if it is in a different format (e.g., SRT). The ASS format provides better support for complex subtitles and font configurations. You can use a tool like Freemake SRT to ASS Converter or a command-line tool like ffmpeg -i input.srt -c:s ass output.ass.
  3. Edit the ASS file to embed the Arabic font within the file, so FFmpeg can use the correct font for rendering. You can use a text editor like Notepad++ or an ASS editor like Aegisub to add the following lines at the beginning of the file (replace "arial.ttf" with the actual path and name of your Arabic font file):
[Fonts] File="arial.ttf"

Embed Subtitle Font into the Video

After preparing the ASS subtitle file with the embedded font, burn the subtitles into the video using FFmpeg:

ffmpeg -i input.mp4 -vf "subtitles=fixed_arabic_subtitle.ass" output.mp4

Arabic words showing square boxes in burnt subtitles can be fixed by embedding the required Arabic font within the ASS subtitle file and then burning the subtitles into the video using FFmpeg. This ensures that the correct font is used during rendering, displaying the Arabic characters properly.

References

Latest News

Generating SSH Key Failed on Windows 11 (Simplified Chinese)
Generating SSH Key Failed on Windows 11 (Simplified Chinese)

This article provides solutions for the issue of SSH key generation failure on Windows 11 in Simplified Chinese. Learn how to resolve this problem and continue with your Git installation.

Read More
Windows 11: Duplicate and Extend Displays in a Home Office Setup
Windows 11: Duplicate and Extend Displays in a Home Office Setup

Learn how to duplicate and extend displays in a home office setup using Windows 11. This guide provides step-by-step instructions to optimize your workspace comfort.

Read More
Increase Timeout Limit in Firefox
Increase Timeout Limit in Firefox

Learn how to increase the timeout limit in Firefox to avoid high network latency issues causing the browser to hit the timeout limit while loading pages.

Read More
Creating Non-Persistent Shadow Copy Backups on Windows 11 Pro
Creating Non-Persistent Shadow Copy Backups on Windows 11 Pro

Learn how to create non-persistent shadow copy backups on Windows 11 Pro using WSL and Google Cloud Storage, solving the issue of WSL seeing open Windows files locked.

Read More
HP ProLiant MicroServer Gen8: DHCP Server Not Pinging Gateway
HP ProLiant MicroServer Gen8: DHCP Server Not Pinging Gateway

This article provides a solution for connecting an HP ProLiant MicroServer Gen8 running a fresh install of Linux Mint 22.1, using an Ethernet cable previously used with an HP laptop, which has proven internet connectivity, but fails to connect with the DHCP server not pinging the gateway.

Read More
Disabling Tenor GIF selector window in Emoji picker on Windows 11
Disabling Tenor GIF selector window in Emoji picker on Windows 11

Learn how to disable the Tenor GIF selector window in the Emoji picker on Windows 11, which starts flashing distracting animations when invoked.

Read More
Troubleshooting Webcam Upgrade on Windows 11 N Pro
Troubleshooting Webcam Upgrade on Windows 11 N Pro

This article provides a solution for the error encountered while upgrading a computer running Windows 11 N Pro, as the upgrade is not officially supported due to the lack of TPM. The issue starts when attempting to launch the Windows Camera app.

Read More
Setting up Office PC Server with Raspberry Pi: Multihop SSH Tunnel Reverse Forward Tunnel
Setting up Office PC Server with Raspberry Pi: Multihop SSH Tunnel Reverse Forward Tunnel

Learn how to set up an Office PC Server with a Raspberry Pi using a Multihop SSH Tunnel Reverse Forward Tunnel. This guide will walk you through the process of connecting your home PC (192.168.1.42) to a Raspberry Pi and opening an SSH remote tunnel. Follow this tutorial to securely access your office server from home.

Read More
Why does the mouse cursor trail on older Windows versions?
Why does the mouse cursor trail on older Windows versions?

Older versions of Windows sometimes cause the mouse cursor to trail, leaving copies of the cursor on the screen as it moves. This can be a problem when the computer is running slowly.

Read More
Optimizing ChatGPT Web App Performance in Firefox
Optimizing ChatGPT Web App Performance in Firefox

This article provides tips and tricks to improve the performance of a ChatGPT web app in Firefox without losing functionality. Long conversations and slow typing input delays are common issues addressed in this article.

Read More
Troubleshooting HDR Luminance Levels Mapping/Scaling while Playing HDR on PC
Troubleshooting HDR Luminance Levels Mapping/Scaling while Playing HDR on PC

This article provides solutions for issues encountered while playing downloaded HDR content on PC, such as incorrect luminance levels, mapping, or scaling. Common problems include games and YouTube not supporting HDR, even when setup is correct.

Read More
Conditional Formatting: Chart Title Greyed
Conditional Formatting: Chart Title Greyed

This article explains how to use Conditional Formatting in a chart, but the chart title is greyed out. Here's how to resolve this issue...

Read More
VeraCrypt Dual Boot Setup Disappears After Windows Reinstallation
VeraCrypt Dual Boot Setup Disappears After Windows Reinstallation

This article provides a solution for the issue where the VeraCrypt dual boot setup disappears after a Windows reinstallation.

Read More
Options for Installing NVME PCIe Adapter on IBM System x3650 M3 Type 9745KPG
Options for Installing NVME PCIe Adapter on IBM System x3650 M3 Type 9745KPG

Recently purchased an old IBM System x3650 M3 Type 9745KPG without drives. Wanting to install an NVME PCIe adapter for read support. What are the options?

Read More
Transparent Selection in Microsoft Paint Windows 11
Transparent Selection in Microsoft Paint Windows 11

Learn how to use the Transparent Selection option in Microsoft Paint Windows 11 for seamless image editing. Follow this guide to make your editing experience more efficient.

Read More
Inspiron 155000 Black Screen Boot Loop
Inspiron 155000 Black Screen Boot Loop

A Dell Inspiron 155000 laptop is stuck in a boot loop while charging and downloading a file. The laptop returns 'Found laptop', and turning the charging lights blinks 3 amber and 1 white.

Read More
Check Bitvise SSH Server License Validity Period on Windows 10
Check Bitvise SSH Server License Validity Period on Windows 10

Bitvise SSH Server license has expired and the server stops working, causing loss of access to remote computers. Check the current license validity date to plan ahead.

Read More
Preserving Layers Saving in Microsoft Paint on Windows 11
Preserving Layers Saving in Microsoft Paint on Windows 11

Learn how to preserve layers when saving an image in Microsoft Paint on Windows 11 to avoid flattening and losing the ability to edit the image.

Read More
Change Time Windows CMD Without Admin Rights
Change Time Windows CMD Without Admin Rights

Learn how to change the system time in Windows CMD without requiring admin rights using GitHub's Action Runner and Clock Sync.

Read More
How to Transpose Rows/Columns in Notepad++ using Python Script Plugin
How to Transpose Rows/Columns in Notepad++ using Python Script Plugin

Learn how to transpose rows or columns in Notepad++ using the Python Script plugin. This article provides a step-by-step guide to install and use the plugin for efficient data manipulation.

Read More
File Complaint Expedia
File Complaint Expedia

Learn how to file a complaint with Expedia. This guide covers steps for filing a complaint on Linux, Windows, and MacOS platforms.

Read More
Unable to Connect Home Sky Broadband Network on Win10 Laptop: WiFi/Ethernet not valid IP configuration
Unable to Connect Home Sky Broadband Network on Win10 Laptop: WiFi/Ethernet not valid IP configuration

This article provides solutions for Win10 laptop users who are unable to connect their home Sky Broadband network due to the 'WiFi/Ethernet not valid IP configuration' error.

Read More
Change Visited Link Color in Firefox (Latest Update: April 2025, v138.0)
Change Visited Link Color in Firefox (Latest Update: April 2025, v138.0)

Learn how to change the visited link color in Firefox with the latest update (April 2025, v138.0). This article provides step-by-step instructions to customize your Firefox browser.

Read More
Resolved Dispute Expedia
Resolved Dispute Expedia

Learn how to resolve disputes with Expedia effectively. This article provides a step-by-step guide to help you through the process.

Read More
Since upgrading to Windows 11, how to use Ctrl-Alt-Delete to login?
Since upgrading to Windows 11, how to use Ctrl-Alt-Delete to login?

After upgrading to Windows 11, the Ctrl-Alt-Delete key combination no longer brings up the prompt to enter a PIN (logging into Windows). No indication is given when the keys are pressed.

Read More
Cron Won't Start VirtualBox VM: A Solution
Cron Won't Start VirtualBox VM: A Solution

In this article, we will discuss a solution to a common issue where Cron won't start a VirtualBox VM. This problem can occur on various operating systems, and we will provide a solution that should work across Linux, Windows, and MacOS.

Read More
Block Internet Access for VLAN using EdgeRouter X5
Block Internet Access for VLAN using EdgeRouter X5

This article will guide you on how to block Internet access for a VLAN using EdgeRouter X5. By the end of this article, you will learn how to isolate your printer from the Internet while connected to a specific VLAN.

Read More
Export Command Line Column Task Manager Data to CSV
Export Command Line Column Task Manager Data to CSV

Learn how to export the Task Manager's memory usage data to a CSV file using the command line. This guide covers Windows, Linux, and macOS.

Read More
Configuring OS/Browser to Open Certain File Extensions in Specific Websites (Browser-Specific) - Tech Support
Configuring OS/Browser to Open Certain File Extensions in Specific Websites (Browser-Specific) - Tech Support

Learn how to configure your operating system and browser to open specific file extensions in certain websites, making it easier to handle old computers and access modern web applications.

Read More
Recommendation for Weird/Big Multi-Monitor KVM Setup
Recommendation for Weird/Big Multi-Monitor KVM Setup

This article provides a recommendation for a weird/big multi-monitor KVM setup using a Thunderbolt port and drive. It will guide you through the process of setting up a desktop replacement with six screens, ensuring a seamless and efficient work environment.

Read More
Running rsync on Windows using MSYS2: Source/Dest Path Formats
Running rsync on Windows using MSYS2: Source/Dest Path Formats

This article provides instructions on how to use rsync on Windows with MSYS2, converting Windows source/dest paths to a Linux-compatible format. This allows syncing through rsync.

Read More
Automating Keyboard Shortcuts with PowerShell and Task Scheduler
Automating Keyboard Shortcuts with PowerShell and Task Scheduler

Learn how to automate keyboard shortcuts using PowerShell and Task Scheduler. This guide will show you how to create and schedule a PowerShell script that sends specific keystrokes to open applications.

Read More
Splitting Multiline Text Words - PowerShell
Splitting Multiline Text Words - PowerShell

Learn how to split multiline text words using PowerShell. This article provides a simple solution to the problem of splitting text at specific characters, even when they are followed by whitespace. Try the provided script to effortlessly split your multiline text.

Read More
Creating a User-Defined Snippets Repository in Kate
Creating a User-Defined Snippets Repository in Kate

This article provides a step-by-step guide on creating and setting up a user-defined snippets repository in Kate, a powerful and feature-rich text editor. Follow these instructions to streamline your coding experience.

Read More
Creating a Spreadsheet List with Addresses and Tickbox for Payment Received
Creating a Spreadsheet List with Addresses and Tickbox for Payment Received

Learn how to create a spreadsheet list with addresses and a tickbox for payment received. This tutorial will guide you step-by-step to organize your data effectively.

Read More