https://github.com/acgtools/sub-renamer

CLI tool to automatically rename subtitle files to match corresponding video files. 自动为字幕文件匹配视频并重命名的 CLI 工具。
https://github.com/acgtools/sub-renamer

anime cli cli-app go golang open-source video

Last synced: 5 months ago
JSON representation

CLI tool to automatically rename subtitle files to match corresponding video files. 自动为字幕文件匹配视频并重命名的 CLI 工具。

• Host: GitHub
• URL: https://github.com/acgtools/sub-renamer
• Owner: acgtools
• License: mit
• Created: 2023-11-20T18:35:18.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-12-09T18:33:56.000Z (over 2 years ago)
• Last Synced: 2026-01-12T00:51:44.263Z (6 months ago)
• Topics: anime, cli, cli-app, go, golang, open-source, video
• Language: Go
• Homepage:
• Size: 1.79 MB
• Stars: 8
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Sub-Renamer

English | [简体中文](./README_ZH_CN.md)

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






![](https://political-capable-roll.glitch.me/get/@acgtoolssubrenamer?theme=rule34)

## Installation

### Using `go`

```sh

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

```

### Download from releases

[Release page](https://github.com/acgtools/sub-renamer/releases)

## Quick Start

```sh

$ sub-reanmer -h

sub-renamer  

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`:

   ```cmd

   cd /d ""

   ```

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.

   ```cmd

   # Rename subtitle files only

   .\sub-renamer.exe "" ""

   

   # Using -c will copy subtitle files to the video folder after renaming

   .\sub-renamer.exe -c "" ""

   ```

![](./docs/assets/how_to_use.gif)

## Issue

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