Project

subfinder

0.0
No commit activity in last 3 years
No release in over 3 years
Download or rename subtitle files to match video files
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 5.0
~> 3.1.8
~> 4.0.0
~> 3.5.1

Runtime

~> 2.0.1
~> 0.8
~> 1.10.1
~> 10.0
~> 2.0.1
~> 1.2.2
 Project Readme

CircleCI Maintainability Gem Version

How-to

This Gem only works for video files with S[Number]E[Number] (i.e., S01E02) format in their names.

Subfinder

You have a TV series video files on you computer but you don't have subtitles or you have them but the name of each episode is not the same as teh video file. Open the terminal, go to the folder where you saved your files, and run subfinder. It will find the similar subtitle files (only .srt) on the folder and rename it to video file. If the subtitles are not exists on your disk, then it will download them from Subscene, only if you provided the Subscene TV series list page URL.

Installation

First you need to have Ruby and Gem on your machine. Run ruby -v and gem -v to make sure you have the. If not Google how to install them. It's easy. Your Ruby version should be at least 2.5.1.

Then run:

$ gem install subfinder

Usage

$ subfinder
Without any switches, this will unzip all zipped or compressed files and find/rename them to correspondent video file.

$ subfinder -u https://subscene.com/subtitles/the-kominsky-method -l fa

  • Use -u or --url to specify a URL page of a TV series on subscene.com website.
  • Use -l or --languagefor subtitle language you want. Default is English. fa, en, ar, fr, es are supported.
  • Run subfinder --dryrun to create set of mock files on you current directory and running Subfinder.
  • Also see sunfinder -h for help

Development

To run tests, run rake test. To see all logs, run with -d or --degub
Clone the project. Make changes and then rake build inside the project folder to create Gem. Then gem install pkg/subfinder-0.0.1.gem to install it locally.

License

The gem is available as open source under the terms of the MIT License.

TODO

  • Add all language codes