Skip to content

adwerygaming/anime-rename

Repository files navigation

Anime Renamer

A simple CLI to batch rename anime files into Jellyfin format

Features

  • Rename into Jellyfin format: {Anime Title} - SXXEXX - {Episode Title}.{Ext}
  • Pull episode titles per file straight from Jikan
  • Guided CLI: pick the folder, review, confirm, done

Example

Before:

- [SubsPlease] Yuusha Party ni Kawaii Ko ga Ita node, Kokuhaku shitemita. - 01 (1080p).mkv
- [SubsPlease] Yuusha Party ni Kawaii Ko ga Ita node, Kokuhaku shitemita. - 02 (1080p).mkv
- [SubsPlease] Yuusha Party ni Kawaii Ko ga Ita node, Kokuhaku shitemita. - 03 (1080p).mkv

After:

- Yuusha Party ni Kawaii Ko ga Ita node, Kokuhaku shitemita. - S01E01 - I Tried Confessing.mkv
- Yuusha Party ni Kawaii Ko ga Ita node, Kokuhaku shitemita. - S01E02 - I Tried Going on a Date.mkv
- Yuusha Party ni Kawaii Ko ga Ita node, Kokuhaku shitemita. - S01E03 - I Tried Giving Love Advice.mkv

Prerequisites

  • Node.js (version 21 or higher)

Installation

  1. Clone the repository:
git clone https://github.com/adwerygaming/anime-rename.git
  1. Navigate to the project directory:
cd anime-rename
  1. Install the required dependencies:
npm install

Usage

  1. Run the script:
npm start
  1. Point it at the folder with your anime files when asked.
  2. Pick the detected series from the list.
  3. Enter the season number (for naming only, currently doesn't auto-detect).
  4. When prompted, type "y" to rename or "n" to abort.

Important

Expected input: [GroupName] {Anime Title} - XX - {Episode Title}.{ext}. Where XX is the episode number. Files outside this shape are skipped with a warning.
Examples:

  • [SubsPlease] Yuusha Party ni Kawaii Ko ga Ita node, Kokuhaku shitemita. - 01 (1080p) [CC3FE38D].mkv
  • [SubsPlease] Seihantai na Kimi to Boku - 01 (1080p) [5F55C10F].mkv
  • [Erai-raws] Yuru Yuri - 01 [1080p][Multiple Subtitle][CD192B75].mkv

Important

Expected structure: All files that are in the pointed folder should only contain 1 season per series.

What works: 1 series with season 1 only in the same folder, combined, mixed without any folder separation.
What won’t work: 1 series with season 1 & 2 in the same folder, combined, mixed without any folder separation.

About

A simple CLI to rename anime files for Jellyfin format

Topics

Resources

Stars

Watchers

Forks

Contributors