Skip to content

Latest commit

 

History

History
29 lines (21 loc) · 2.27 KB

README.md

File metadata and controls

29 lines (21 loc) · 2.27 KB

Subtitles Mangler

It is Kodi Media Center service plugin aiming to be a comprehensive subtitle helper.

It allows:

  1. invoking subtitle search dialog at playback start taking into account local subtitle files availability
  • recognizes if there are subtitle files already downloaded or not
  • recognizes 'noautosubs' file (per directory) and '.noautosubs' extension (per file) whose presence prevents subtitle search dialog from opening. Allows to manage it from within UI
  • tries to identify if video file includes internal forced subtitles matching preferred language
  1. detecting if subtitle file was downloaded locally and perform conversion
  • supports subtitle input formats: microDVD, SubRip, MPL2, Substation Alpha and TMP
  • allows to filter subtitle contents based on various Regular Expression type criteria, which gives ability to remove unwanted texts, such as Hearing Impaired tags, advertisements, credits, etc.
  • allows to increase subtitle display time to match at least minimum calculated time based on subtitle text length, taking into account start time of the next subtitle line
  • allows to shrink subtitle display time to avoid overlapping the next subtitle line
  1. detecting if video was removed from local storage and removing any related subtitle files

Note:

  • As Kodi 18 (Leia) introduced native support for adding solid background to displayed subtitles and also because Substation Alpha type subtitles are scaled to fit within the bottom of the movie image (not the bottom of the physical screen), file is converted to SubRip format.
  • Beginning with version 1.3.0 the file extension of subtitle output file was changed to .utf (instead of previous .ass) in order to distinguish converted subtitles from original ones. Substation Alpha format (.ass) is now supported as input format.
  • Beginning with version 2.0.0 the plugin was redesigned to support Python 3 only. Therefore, newer versions will only work with Kodi 19 (Matrix) onwards.

Known issues:

  • so far the plugin does not work well with streaming services
  • Kodi's subtitle settings (Font size, Font style, Font color, Font opacity, Background color, Background opacity) are synchronized from Kodi UI to the plugin only at Kodi start. These settings were removed in 2.1.0 due to broken compatibility with Kodi 20 Nexus