Subtitles Cleaner cleans English SubRip .srt subtitle files from OCR errors, Hearing-impaired lines and other junk.
The program includes many cleaning rules and several complex cleaning routines. It also has some basic nice-to-have synchronization features.
For a comprehensive subtitles editor use Subtitle Edit.
Subtitles Cleaner requires .NET Framework 4.8 Runtime.
-
Subtitles panel. The last column, Clean Text, is the text after Subtitles Cleaner gone over it. It is only a suggestion and it does not take effect until it is copied to the Text column. Double-click on a subtitle with an error will make the error list panel focus on the error. Context menu offers copy of texts and subtitles.
-
Error list panel. The headers can be sorted by subtitle numbers (#) or by errors. Double-click on an error will make the Subtitles panel focus on the subtitle. Context menu offers fixing all errors of the same type.
-
Clean all subtitles in the subtitles panel.
-
Quick Actions. Perform quick selective fixes to subtitles.
- Adjust Timing. Adjust subtitles timing by 2 sync points. The popup will open with the sync points filled with timing of the first and last subtitles. Load From File loads the first and last sync points from another subtitles file.
-
Reorder subtitles based on their show time.
-
Balance Lines. Merge short line with long line, or first line with its continuation in the second line.
-
Search and replace.
-
Load the original subtitles and discard all previous changes.
-
Time Calculator. A little utility when you need to calculate time differences and it is too hard to do the math in your head.
-
Hearing-Impaired Detection. Identifies hearing-impaired with only capital letters text or all-case text.
-
Enable English (Hunspell en-US) dictionary for cleaning misspelled words. Copyright and credits, for the dictionary, are spelled out in README_en_US.txt. The file is located in the same folder as the dictionary.
-
Selected subtitle. Changes can be made in the textbox.
-
Cleaned subtitle.
-
Fix buttons will copy the cleaned subtitle to the subtitle itself. The advance button will also jump to the next subtitle with an error.
-
Set Show Time. Set the specified show time to the selected subtitle and change the timings of all the subtitles below it based on their time differences. When the Interactive Retiming is checked, the show timings will change in the subtitles panel as the show time is changed.
-
Add Time starting from the selected subtitle. Time can be positive or negative. The time sign is clickable and changes between
+and-. -
Sync Errors & Subtitles. When checked, clicking on an error or a subtitle will also focus on the other one.
Clean subtitles.
SubtitlesCleanerCommand.exe clean --path <fileOrFolder>
[--subfolders]
[--save [--outputFile <file>] [--outputFolder <folder>]]
[--print]
[--cleanHICaseInsensitive]
[--dictionaryCleaning]
[--firstSubtitlesCount <N>]
[--suppressBackupFile]
[--suppressBackupFileOnSame]
[--suppressWarningsFile]
[--printCleaning]
[--log <logFile>]
[--log+ <logFile>]
[--csv]
[--quiet]
[--sequential]If the path points to a folder, it will clean all the subtitle files in that folder.
--path <fileOrFolder> Path to subtitle file or folder.If the path points to a folder and subfolders is enabled, Subtitles Cleaner Command will get all the subtitle files in path and any subfolder under it.
--subfolders Include all subfolders under path.Outputs the cleaned subtitles to a file. By default, Subtitles Cleaner Command will save the cleaned subtitles to the same subtitle file, overwriting it. Use outputFile switch to write to a new subtitle file with different name. use outputFolder switch to write to a different folder than the original subtitle file.
--save Save to file.
--outputFile <file> Output file. If omitted, the program outputs on the original file.
--outputFolder <folder> Output folder. If omitted, the program outputs in the original folder.Outputs the cleaned subtitles to the console.
--print Print to console.By default, Subtitles Cleaner Command identifies hearing-impaired line, which is not in any brackets, when the line is all in capital letters. Use this parameter to clean hearing-impaired lines when they are both upper and lower letters (sentence-like).
--cleanHICaseInsensitive Clean HI case-insensitive.Enable English dictionary (Hunspell dictionary) for cleaning misspelled words. This feature increases the cleaning time.
--dictionaryCleaning Clean misspelled words with English dictionary.Use this parameter to read the first N subtitles out of the file (not the first number of lines).
--firstSubtitlesCount <N> Read only the specified first number of subtitles.Subtitles Cleaner Command saves a backup file, of the original file, with extension .bak.srt. This parameter suppresses the backup file.
--suppressBackupFile Do not create backup file of the original subtitles file.Suppress creating a backup file if the subtitles after processing are the same as the original subtitles.
--suppressBackupFileOnSame Do not create backup file if processing results the same file.Subtitles Cleaner Command creates a warnings file with extension .warnings.txt. This file includes all the possible errors the program encountered but didn't cleaned up. These are meant to be viewed by a human eye and fix accordingly. This parameter suppresses the warnings file.
--suppressWarningsFile Do not create warnings file.Print to console the cleaning process.
--printCleaning Print to console what the cleaning process does.The program outputs informative messages about what it does, like reading and saving files, cleaning subtitles, etc. By default, it will print them to the console. The following switches control where and how these informative messages show.
Write informative messages to a log file. If a folder path is specified instead of a file path, the program will name its own log file and create it in that folder.
--log <logFile> Write informative messages to log file. Overwrites existing log file.
--log+ <logFile> Write informative messages to log file. Appends to existing log file.Write informative messages in a comma-separated values. Use in conjunction with .csv file extension for the log file --log logFile.csv.
--csv Write informative messages in a comma-separated values.Quiet mode will not print any informative messages, to console or log file.
--quiet Do not write informative messages.By default, the program handles multiple files concurrently. The sequential switch forces the program to process each file one at a time. Sequential processing takes considerable less resources from the CPU and memory. Concurrent processing will use as much CPU as it can. Sequential processing will take significant longer to process multiple files.
--sequential Process subtitle files in sequential order, one after another, instead of concurrently.Help screen for clean.
SubtitlesCleanerCommand.exe clean --helpExamples:
Clean subtitle file.
SubtitlesCleanerCommand.exe clean --path "C:\My Documents\Subtitle.srt" --saveClean subtitle file and save results in another folder.
SubtitlesCleanerCommand.exe clean --path "C:\My Documents\Subtitle.srt" --save --outputFolder "C:\My Documents\Subtitles"Clean hearing-impaired case-insensitive.
SubtitlesCleanerCommand.exe clean --cleanHICaseInsensitive --path "C:\My Documents\Subtitle.srt" --saveClean subtitle file and suppress backup & warnings files.
SubtitlesCleanerCommand.exe clean --path "C:\My Documents\Subtitle.srt" --save --suppressBackupFile --suppressWarningsFileClean subtitle file and suppress warnings file. Create backup file if the cleaned subtitles are not the same as the original subtitles.
SubtitlesCleanerCommand.exe clean --path "C:\My Documents\Subtitle.srt" --save --suppressBackupFileOnSame --suppressWarningsFileClean all subtitle files in the folder.
SubtitlesCleanerCommand.exe clean --path "C:\My Documents\Subtitles" --savePrint to console.
SubtitlesCleanerCommand.exe clean --path "C:\My Documents\Subtitle.srt" --printPrint to console the cleaned subtitles and the cleaning process. Very useful when tracking cleaning errors.
SubtitlesCleanerCommand.exe clean --path "C:\My Documents\Subtitle.srt" --print --printCleaning
Clean all subtitle files in the folder. Write informative messages to text log file log_clean.txt.
SubtitlesCleanerCommand.exe clean --path "C:\My Documents\Subtitles" --save --log "C:\My Documents\Subtitles\log_clean.txt"Clean all subtitle files in the folder. Write informative messages to csv log file log_clean.csv. If the file already exists, append to it.
SubtitlesCleanerCommand.exe clean --path "C:\My Documents\Subtitles" --save --log+ "C:\My Documents\Subtitles\log_clean.csv" --csvClean all subtitle files in the folder. Don't write informative messages.
SubtitlesCleanerCommand.exe clean --path "C:\My Documents\Subtitles" --save --quietClean all subtitle files in the folder, one after the other, in sequential order. Don't write informative messages.
SubtitlesCleanerCommand.exe clean --path "C:\My Documents\Subtitles" --save --quiet --sequentialClean empty lines and non-subtitles.
SubtitlesCleanerCommand.exe cleanEmptyAndNonSubtitles --path <fileOrFolder>
[--subfolders]
[--save [--outputFile <file>] [--outputFolder <folder>]]
[--print]
[--firstSubtitlesCount <N>]
[--suppressBackupFile]
[--suppressBackupFileOnSame]
[--printCleaning]
[--log <logFile>]
[--log+ <logFile>]
[--csv]
[--quiet]
[--sequential]Help screen for cleanEmptyAndNonSubtitles.
SubtitlesCleanerCommand.exe cleanEmptyAndNonSubtitles --helpAdd time to subtitles.
SubtitlesCleanerCommand.exe addTime --timeAdded <+00:00:00,000|-00:00:00,000>
--path <fileOrFolder>
[--subfolders]
[--save [--outputFile <file>] [--outputFolder <folder>]]
[--print]
[--subtitleNumber <N>]
[--firstSubtitlesCount <N>]
[--suppressBackupFile]
[--suppressBackupFileOnSame]
[--log <logFile>]
[--log+ <logFile>]
[--csv]
[--quiet]
[--sequential]--timeAdded <Time> Added time to subtitles.
--timeAdded +00:00:00,000 Shift subtitle timings forwards.
--timeAdded -00:00:00,000 Shift subtitle timings backwards.--subtitleNumber <N> Start operation from specified subtitle. If omitted, starts with first subtitle.Help screen for addTime.
SubtitlesCleanerCommand.exe addTime --helpMove subtitles to show time.
SubtitlesCleanerCommand.exe setShowTime --showTime <00:00:00,000>
--path <fileOrFolder>
[--subfolders]
[--save [--outputFile <file>] [--outputFolder <folder>]]
[--print]
[--subtitleNumber <N>]
[--firstSubtitlesCount <N>]
[--suppressBackupFile]
[--suppressBackupFileOnSame]
[--log <logFile>]
[--log+ <logFile>]
[--csv]
[--quiet]
[--sequential]--showTime <Time> Show time.--subtitleNumber <N> Start operation from specified subtitle. If omitted, starts with first subtitle.Help screen for setShowTime.
SubtitlesCleanerCommand.exe setShowTime --helpAdjust subtitles timing by 2 sync points.
SubtitlesCleanerCommand.exe adjustTiming --firstShowTime <00:00:00,000>
--lastShowTime <00:00:00,000>
--path <fileOrFolder>
[--subfolders]
[--save [--outputFile <file>] [--outputFolder <folder>]]
[--print]
[--firstSubtitlesCount <N>]
[--suppressBackupFile]
[--suppressBackupFileOnSame]
[--log <logFile>]
[--log+ <logFile>]
[--csv]
[--quiet]
[--sequential]--firstShowTime <Time> First subtitle's show time.
--lastShowTime <Time> Last subtitle's show time.Help screen for adjustTiming.
SubtitlesCleanerCommand.exe adjustTiming --helpReorder subtitles based on their show time.
SubtitlesCleanerCommand.exe reorder --path <fileOrFolder>
[--subfolders]
[--save]
[--print]
[--suppressBackupFile]
[--suppressBackupFileOnSame]
[--log <logFile>]
[--log+ <logFile>]
[--csv]
[--quiet]
[--sequential]If the path points to a folder, it will reorder all the subtitle files in that folder.
--path <fileOrFolder> Path to subtitle file or folder.Help screen for reorder.
SubtitlesCleanerCommand.exe reorder --helpMerge short line with long line, or first line with its continuation in the second line.
SubtitlesCleanerCommand.exe balanceLines --path <fileOrFolder>
[--subfolders]
[--save]
[--print]
[--suppressBackupFile]
[--suppressBackupFileOnSame]
[--log <logFile>]
[--log+ <logFile>]
[--csv]
[--quiet]
[--sequential]If the path points to a folder, it will balance the lines of all the subtitle files in that folder.
--path <fileOrFolder> Path to subtitle file or folder.Help screen for balanceLines.
SubtitlesCleanerCommand.exe balanceLines --help