sub-batch

Download and match subtitle files to video files

Install

cargo install sub-batch

``` USAGE: sub-batch [FLAGS] [OPTIONS] [url]

FLAGS: -h, --help Prints help information -r, --rename If subs should be renamed to match the corresponding video file. -V, --version Prints version information

OPTIONS: -e, --encoding Needed to parse text-based subtitle formats (only needed when adjusting timing). [default: utf-8] --fps Needed for MicroDVD .sub files. Specifies the FPS that the video file is encoded in (only needed when adjusting timing). [default: 25] -p, --path The path to download to and look for subs in. [default: .] -s, --subarea Specifies a regular expression that defines the part of the subtitle filename where episode number should be extracted from. -t, --timing Adjusts the timing of all subs. The value is specified in milliseconds, and can be negative. -v, --videoarea Specifies a regular expression that defines the part of the video filename where episode number should be extracted from.

ARGS: The kitsunekko.net url to download subs from. May be omitted. ```

Matching subtile files and video files

Put the subs and the videos in the same directory, for example: ```

ls FullmetalAlchemistBrotherhood001.ass '[Reaktor] Fullmetal Alchemist Brotherhood - E01 v2 [1080p][x265][10-bit][Dual-Audio].mkv' FullmetalAlchemistBrotherhood002.ass '[Reaktor] Fullmetal Alchemist Brotherhood - E02 v2 [1080p][x265][10-bit][Dual-Audio].mkv' FullmetalAlchemistBrotherhood003.ass '[Reaktor] Fullmetal Alchemist Brotherhood - E03 v2 [1080p][x265][10-bit][Dual-Audio].mkv' FullmetalAlchemistBrotherhood004.ass '[Reaktor] Fullmetal Alchemist Brotherhood - E04 v2 [1080p][x265][10-bit][Dual-Audio].mkv' Run sub-batch with the --rename flag to rename the subtitle files to have the same name as the corresponding video file: sub-batch --rename ./[Reaktor] Fullmetal Alchemist Brotherhood - E01 v2 [1080p][x265][10-bit][Dual-Audio].mkv -> ./FullmetalAlchemistBrotherhood001.ass ./[Reaktor] Fullmetal Alchemist Brotherhood - E02 v2 [1080p][x265][10-bit][Dual-Audio].mkv -> ./FullmetalAlchemistBrotherhood002.ass ./[Reaktor] Fullmetal Alchemist Brotherhood - E03 v2 [1080p][x265][10-bit][Dual-Audio].mkv -> ./FullmetalAlchemistBrotherhood003.ass ./[Reaktor] Fullmetal Alchemist Brotherhood - E04 v2 [1080p][x265][10-bit][Dual-Audio].mkv -> ./FullmetalAlchemistBrotherhood004.ass Ok? (y/n) ``` By deafult sub-batch extracts the first number (searching from left to right) in the subtitle file name and then tries to find another non-subtitle file that contains that number.

Limiting the number match area

The previous example matches the files correctly by default but sometimes it is needed to restrict the area of the file names that the number is extracted from. Consider for example: ```

ls 1337FullmetalAlchemistBrotherhood001.ass '[Reaktor] Fullmetal Alchemist Brotherhood - E01 v2 [1080p][x265][10-bit][Dual-Audio].mkv' 1337FullmetalAlchemistBrotherhood002.ass '[Reaktor] Fullmetal Alchemist Brotherhood - E02 v2 [1080p][x265][10-bit][Dual-Audio].mkv' 1337FullmetalAlchemistBrotherhood003.ass '[Reaktor] Fullmetal Alchemist Brotherhood - E03 v2 [1080p][x265][10-bit][Dual-Audio].mkv' 1337FullmetalAlchemistBrotherhood004.ass '[Reaktor] Fullmetal Alchemist Brotherhood - E04 v2 [1080p][x265][10-bit][Dual-Audio].mkv' sub-batch --rename found no match for any sub file No matches are found because the first number in each subtitle is now 1337. To fix this specify the subtitle area like this: sub-batch --rename --subarea "hood_.+" ``` The regular expression given to --subarea (and --videoarea) limits the number extraction to only the part of the file name that is matched by the regular expression.

Adjusting the subtitle timings

sub-batch can also batch adjust the timings for all subtitle files. To do this you use the --timing option, for example: sub-batch --timing 100 which moves all subtitles forward by 100 ms, or: sub-batch --timing -50 which moves all subtitles back by 50 ms.