Sub-Renamer

English | 简体中文

A CLI tool designed to automatically rename subtitle files corresponding to matched video files.

If this repo is helpful to you, please consider giving it a star (o゜▽゜)o☆ . Thank you OwO.

Random Wink OvO

Installation

Using go

$ go install -ldflags "-w -s" github.com/acgtools/sub-renamer@latest

Download from releases

Release page

Quick Start

$ sub-reanmer -h
sub-renamer <video dir> <sub dir>

Usage:
  sub-renamer [flags]

Flags:
  -c, --copy               copy subtitles after renaming
  -h, --help               help for sub-renamer
      --log-level string   log level, options: debug, info, warn, error (default "info")
  -v, --version            version for sub-renamer

How to use on windows

1. Download the zip file and extract it to the folder you’d like.

2. Open the cmd: you can search for “cmd” in the Windows search bar, then click "Command Prompt"

3. Copy the path of the folder you just extracted. Input the following command and press enter:

   cd /d "<path you copied>"

4. Copy the path of the video and subtitle folder, input the following command, and press enter:

   Caution: Please ensure that the video file path is provided as the first argument.

   Since it will rename files in the second parameter, this process is irreversible. Creating backups for video files is otherwise cumbersome due to their large size.

   # Rename subtitle files only
   .\sub-renamer.exe "<video path>" "<subtitle path>"
   
   # Using -c will copy subtitle files to the video folder after renaming
   .\sub-renamer.exe -c "<video path>" "<subtitle path>"

Issue

Feel free to create issues to report bugs or request new features.