MarLant

• About
  • Features
  • Demonstration
• Installing
  • Requirements
• FAQ
  • No plugin commands available anywhere
  • Are there keybindings
  • Why the Sublime Text 4 requirement and v4099 as the lowest
  • Why the Python 3.8 plugin host requirement
  • The plugin is licensed under GPLv3, will it infect everything else with GPLv3
  • Who killed Laura Palmer
• Credits

About

Sublime Text plugin for working with SubRip/SRT subtitles.

UI theme and color scheme used on the screenshot and demonstration videos below: One Dark.

Features

• SubRip / SRT syntax highlighting
• various functions for working with subtitles:
  • SubRip format validation
    • additional checks (text lines length, titles duration, etc)
  • renumbering titles ordinals
  • inserting new titles
  • splitting a title in two
  • joining two titles into one
  • shifting all the timings
  • opening a translation file in a split view
  • generation of an empty translation file

Commands can be called from:

• Command Palette (CTRL/COMMAND + SHIFT + P) (all the commands)
• tab context menu (translation file creation/opening)
• text area context menu (inserting, splitting and joining titles)

Demonstration

Validating the file:

https://user-images.githubusercontent.com/6904927/168665456-589fd743-86a5-4c4d-97b2-56a6ca40435a.mp4

Joining and splitting titles:

https://user-images.githubusercontent.com/6904927/168662707-c775db65-b73e-4347-b8fa-209741ea85b9.mp4

Creating and openning a translation file:

https://user-images.githubusercontent.com/6904927/168663924-b1236762-3207-480e-895e-aa7754f62cf5.mp4

Installing

• via Package Control:
  • CTRL/COMMAND + SHIFT + P → Package Control: Install Package → MarLant
• manually:
  • clone the repository and copy its folder (marlant) to /path/to/Sublime Text/Packages/
    • the exact path to packages can be opened with CTRL/COMMAND + SHIFT + P → Preferences: Browse Packages
    • you might want to skip copying resources listed in .gitattributes file
      • or just download an archive attached to the latest tag

Requirements

• Sublime Text v4099 or newer
  • Python plugin host v3.8 or newer

FAQ

No plugin commands available anywhere

Check that the active file/view has the SubRip/SRT syntax/scope, as the plugin functionality is only enabled there.

Are there keybindings

Not out of the box, but you can certainly create your own keybinding for any plugin command. To get a command name and its arguments, enable commands logging (sublime.log_commands(True)) in Console.

For example, the following adds two keybindings: for inserting a new title before and after the current one:

{
    "keys": ["super+alt+i", "super+alt+b"],
    "command": "marlant_insert_new_title",
    "args": {"after_current_title": false }
},
{
    "keys": ["super+alt+i", "super+alt+a"],
    "command": "marlant_insert_new_title",
    "args": {"after_current_title": true }
}

Why the Sublime Text 4 requirement and v4099 as the lowest

The version 4 in general is because that's where Python plugin host v3.8 was added. And the v4099 specifically as the minimal one is because it's the one with the latest plugin host v3.8.8. But of course most likely the plugin will also work fine with the very first v4050.

Why the Python 3.8 plugin host requirement

Mostly because of f-strings that were added only in Python 3.6 and thus are not available with plugin host v3.3.

The plugin is licensed under GPLv3, will it infect everything else with GPLv3

The intention is that if you'd use this plugin sources to create something else, and/or redistribute it (as is or modified), then that would indeed be infected with GPLv3. But for the purpose of simply using the plugin in Sublime Text the GPLv3 terms shouldn't apply any restrictions/requirements.

Who killed Laura Palmer

One day, my log will have something to say about this.

Credits

• SubRip / SRT syntax definition is based on this implementation, converted to .sublime-syntax format with SublimeSyntaxConvertor tool
• timecode parsing and composing is based on the code from srt-shift
• thanks to:
  • OdatNurd for his Plugin 101 - How to write Packages for Sublime video-course
  • friendly and helpful Sublime Text community for answering my (sometimes stupid) questions