https://github.com/alexpresso/srt-downloader

Node CLI app to download subtitles from OpenSubtitles for every medias in a directory
https://github.com/alexpresso/srt-downloader

opensubtitles opensubtitles-downloader srt srt-subtitles subtitle subtitle-downloader subtitles

Last synced: 6 days ago
JSON representation

Node CLI app to download subtitles from OpenSubtitles for every medias in a directory

• Host: GitHub
• URL: https://github.com/alexpresso/srt-downloader
• Owner: AlexPresso
• Created: 2023-07-26T20:35:01.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-11-06T15:20:22.000Z (about 1 year ago)
• Last Synced: 2024-10-31T18:13:08.834Z (19 days ago)
• Topics: opensubtitles, opensubtitles-downloader, srt, srt-subtitles, subtitle, subtitle-downloader, subtitles
• Language: JavaScript
• Homepage:
• Size: 125 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# SRT Downloader

A NodeJS CLI app to download subtitles for every media files in a directory.

Subtitles are downloaded from [opensubtitles.com](https://opensubtitles.com).



  



## How it works

1. The app is looking for every media files and subtitles in directory and subdirectories.

2. For every detected media file, the app checks for missing subtitle languages

3. The missing subtitle languages are researched on opensubtitles

4. The subtitles are downloaded and placed next to the media files

## Prerequisites

- ffmpeg (or at least ffprobe) must be installed on your system

- OpenSubtitles.com account

- OpenSubtitles.com consumer API key (you can create one [here](https://www.opensubtitles.com/fr/consumers))

## Usage

`npx srt-downloader -a  -u  -p `

| Flags | Required | Description                 | Default           |

|-------|----------|-----------------------------|-------------------|

| -a    | Yes      | OpenSubtitles ApiKey        | -                 |

| -u    | Yes      | OpenSubtitles username      | -                 |

| -p    | Yes      | OpenSubtitles password      | -                 |

| -d    | No       | Media files directory       | Current directory |

| -l    | No       | Languages (comma separated) | en                |

## Todo

- Multiple subtitles providers

- Start by searching by media hash and fallback on media name search