subbub

A CLI frontend for using mkvextract, ffsubsync, dualsub, etc to manage and merge subtitles

Requirements

Must have the following installed and available in PATH

https://ffmpeg.org/
- including ffmpeg and ffprobe
https://github.com/smacke/ffsubsync
https://mkvtoolnix.download/downloads.html

Usage

$ subbub -h
Usage: subbub.exe [OPTIONS] <COMMAND>

Commands:
  subtitles  commands to modify subtitles
  debug      command for testing
  help       Print this message or the help of the given subcommand(s)

Options:
  -l, --log-level <LOG_LEVEL>  overrides the log level [default: WARN]
  -k, --keep-tmp-files         when specified, keeps temporary files around
  -h, --help                   Print help
  -V, --version                Print version

$ subbub subtitles -h
commands to modify subtitles

Usage: subbub.exe subtitles [OPTIONS] --input <INPUT> --output <OUTPUT> <COMMAND>

Commands:
  convert-subtitles  converts the given subtitle file(s) to srt format
  strip-html         strips html from the given subtitle file(s)
  shift-timing       shifts the timing of the given subtitle(s) earlier or later by the given value in seconds
  sync               syncs the timing of the given subtitles(s) to the secondary subtitle(s)
  combine            combines the given subtitles with another set of subtitles, creating dual subtitles (displaying both at the same time) primary subtitles will be displayed below the video secondary subtitles will be displayed above the video
  match-videos       takes the subtitles from their current directory and places them alongside the videos present in the output directory also renames them to match the videos this makes the subtitles discoverable by various media library management applications
  add-subtitles      adds given subtitle(s) (-i/--input) to the given video(s) (-v/--video_path)
  help               Print this message or the help of the given subcommand(s)

Options:
  -i, --input <INPUT>    the subtitles used as input
                         this may be a subtitles file, a video file, or a directory containing either subtitles files or video files
  -t, --track <TRACK>    the subtitles track to use if the input is a video
  -o, --output <OUTPUT>  the location to output the modified subtitles
                         if the input contains multiple subtitles, this will be considered a directory, otherwise, a filename
  -h, --help             Print help
  -V, --version          Print version

Examples

Sync

Sync subs in the folder subs with the subs on track 0 of videos in the current working directory, outputting the synced subs to synced/ subbub subtitles -i ./subs -o ./synced sync -r ./ -y 0

Combine

Combine subs in the folder ja with the subs on track 1 of videos in current working directory, outputting them to dual-ja/ subbub subtitles -i ./ja -o ./dual-ja combine -s ./ -y 1

Match

Match subs in the folder subs/ with the videos in the current working directory, moving the subs next to the videos subbub subtitles -i ./subs -o ./ match-videos

Complex

Sync subs in the folder subs/ to track 1 of the subs in the current working directory, then combine them with that track, then match both sets of subs to the videos (I use this command to sync downloaded Japanese subs to existing anime series with embedded English subs)

export TRACK=1; export SUBS_DIR="./subs"; export VIDEOS_DIR="./videos" && \
subbub subtitles -i $SUBS_DIR -o ./converted convert-subtitles && \
subbub subtitles -i ./converted -o ./ja sync -r $VIDEOS_DIR -y $TRACK && \
subbub subtitles -i ./ja -o ./dual-ja combine -s $VIDEOS_DIR -y $TRACK && \
subbub subtitles -i ./ja -o $VIDEOS_DIR match-videos && \
subbub subtitles -i ./dual-ja -o $VIDEOS_DIR match-videos && \
rm -rf ./ja && \
rm -rf ./dual-ja && \
rm -rf ./converted

Performs the same operations as the above command, but adds the subtitles to the video file container instead of copying them to the same directory

export EN_TRACK=1; export JA_TRACK=2; export DUAL_TRACK=3; export SUBS_DIR="./subs"; export VIDEOS_DIR="./" && \
subbub subtitles -i $SUBS_DIR -o ./converted convert-subtitles && \
subbub subtitles -i ./converted -o ./ja sync -r $VIDEOS_DIR -y $EN_TRACK && \
subbub subtitles -i ./ja -o ./dual-ja combine -s $VIDEOS_DIR -y $EN_TRACK && \
subbub subtitles -i ./ja -o ./ja-videos add-subtitles -v $VIDEOS_DIR -n $JA_TRACK -c ja && \
subbub subtitles -i ./dual-ja -o ./dual-ja-videos add-subtitles -v ./ja-videos -n $DUAL_TRACK -c dual-ja && \
rm -rf ./ja && \
rm -rf ./dual-ja && \
rm -rf ./ja-videos && \
rm -rf ./converted

Riizade/subbub