SuberCool 😎 0.0.1 is out

I slapped this little thing together last week, it’s ready now, here is the documentation.

Download subtitles in any language from the Gnome β€œFiles” manager (Nautilus) or directly from the shell.
subercool-01subercool-01

Installation

sh
1
2
3
4
sudo apt install python3 exiftool
pip install requests zenipy
mkdir -p ~/.local/bin
wget https://framagit.org/yphil/subercool/-/raw/master/subercool.py -O ~/.local/bin/subercool.py

Nautilus plugin

Then to install it as a Nautilus plugin:

sh
1
2
3
4
mkdir -p ~/.local/share/nautilus/scripts
ln -s ~/.local/bin/subercool.py ~/.local/share/nautilus/scripts/Download__Subtitles
mkdir -p ~/.config/nautilus
echo "<Control><Shift>s Download__Subtitles" >> ~/.config/nautilus/scripts-accels

subercool-02subercool-02

Configuration

Follow the instructions to get an api key (it’s quite simple really) which is a simple string of 32 characters.
Then, either pass this string as an argument like this:

1
subercool.py -k API_KEY ~/Videos/MyMovie.mp4

Or (simpler, and mandatory for the Nautilus plugin mode) put in in a file named ~/.local_variables.json like this:

~/.local_variables.json
1
2
3
4
{
"opensubtitles_api_key": "API_KEY"
}

Usage

subercool.py -h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# subercool.py -h
usage: subercool.py [-h] [-k [API_KEY]] file

Download video subtitle(s)

positional arguments:
file File to search in the opensubtitles database

options:
-h, --help show this help message and exit
-k [API_KEY], --api_key [API_KEY]
API key to the opensubtitles database

See full documentation : https://framagit.org/yphil/subercool/

subercool-03.pngsubercool-03.png

Yes, I have syntax coloring in my shell, get over it πŸ™‚

Commit history

Here.

Brought to you by yPhil ; Please (please?) consider helping ❀️