https://github.com/sereneblue/fts
Instantly find subtitles via the command line
https://github.com/sereneblue/fts
command-line-tool opensubtitles subscene subtitle-downloader subtitles
Last synced: 8 months ago
JSON representation
Instantly find subtitles via the command line
- Host: GitHub
- URL: https://github.com/sereneblue/fts
- Owner: sereneblue
- License: gpl-3.0
- Created: 2017-07-05T01:11:25.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-04-29T22:16:58.000Z (over 4 years ago)
- Last Synced: 2025-01-29T08:47:02.622Z (9 months ago)
- Topics: command-line-tool, opensubtitles, subscene, subtitle-downloader, subtitles
- Language: Python
- Size: 19.5 KB
- Stars: 0
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fts (findthatsub)
Instantly find subtitles via the command line
fts will have difficulties finding subtitles for obscure media content but most recent releases should be covered by the services that it uses to find subtitles, [OpenSubtitles](https://opensubtitles.org/) and [Subscene](https://subscene.com/).
# Install
### Using pip
```
$ pip install fts
```
### Build from source
```
$ git clone https://github.com/sereneblue/fts
$ cd fts
$ python setup.py install
```
# Usage
fts [--lang ]
fts set
fts upload
### Options
-h --help Show this screen.
--version Show version
--lang= Specify language for subtitle. Default is 'eng'. Uses ISO 639-2 code
### Example
$ fts The.Pirate.Bay.Away.From.Keyboard.2013.1080p.BRrip.x264.GAZ.YIFY.mp4
Found subtitle! Downloading...
=> Subtitle downloaded to:
/home/sereneblue/Downloads/The Pirate Bay Away From Keyboard (2013 [1080p]/The.Pirate.Bay.Away.From.Keyboard.2013.1080p.BRrip.x264.GAZ.YIFY.srt
$ fts --lang spa "The Complete Metropolis Disc 1_Title1.mp4"
Can't find subtitle on OpenSubtitles. Checking subscene...
=> Couldn't find subtitle on subscene either. :'(
$ fts upload The.Pirate.Bay.Away.From.Keyboard.2013.1080p.BRrip.x264.GAZ.YIFY.mp4 The.Pirate.Bay.Away.From.Keyboard.2013.1080p.BRrip.x264.GAZ.YIFY.srt
=> Subtitle already in database!
### Use your OpenSubtitles account
It is strongly recommended that you create an OpenSubtitles account for use with this tool. Once your account is activated, store your credentials by running:
```
$ fts set user pass
```
Or create a file at '~/.ftsrc' like this:
user
pass
# Thanks
Please consider supporting [OpenSubtitles](https://www.opensubtitles.org/en/support#vip) & [Subscene](https://subscene.com) (by viewing their ads)