Is there a tool that can be added to Pantheon Files context menu for the purpose of downloading video subtitles?

1 Answer 1


Just like VLSub, the solutions below can search both by hash and name (on that aspect, more here), but unlike VLSub, they can be added to a file manager's context menu.

It is designed for Nautilus but it works in Pantheon Files by creating a contract file for it.

gedit ~/.local/share/contractor/opensubtitles.contract


[Contractor Entry]
Name=Download subtitles
Exec=sh -c "path/to/OpenSubtitlesDownload.py %f" 

enter image description here

This script is (along VLSub with VLC) one of the most effective, as it searches both by hash and name, as indicated here.

enter image description here

The general command is filebot -get-subtitles /path/to/video/.

To search also by name (beside hash) the -non-strict option should be used.

To download English subtitles no language option is needed, but for other languages there is the option --lang with the 2 or 3 letter language code, but only one language can be specified per command, so you have to use separate commands for each language.

To rename the media files (using TMDb) and match their names, a useful option is -rename.

The command can be added to context menu in a contract file; for French it should be:

gedit ~/.local/share/contractor/opensubtitles-FR.contract


[Contractor Entry]
Name=Download French subtitles
Exec=pantheon-terminal -e "filebot -get-subtitles  --lang fr -rename -non-strict %f" 

enter image description here

enter image description here

In order to download subtitles for multiple videos at once, put those in a folder and the option can be applied to that folder, and it will download for all of them.

Very similar to filebot is subliminal, said to search more databases than just opensubtitles. That's why it takes a bit more time to search, but it may worth the waiting.

To add it to custom menu, follow the same steps as for filebot, but add after in the Exec= line the command:

pantheon-terminal -e "subliminal download -l en %f"

(that's for English)

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.