explaingit

daisysg297/bangumi-rename-for-emby

Analysis updated 2026-05-18

11PythonAudience · generalComplexity · 1/5Setup · easy

TLDR

A Python script that batch renames anime video and subtitle files into one consistent Title - SxxExx - Group format, with a preview step before any changes are made.

Mindmap

mindmap
  root((repo))
    What it does
      Batch rename anime files
      Preview before renaming
      Sync subtitle names
    Tech stack
      Python
      PyInstaller
    Use cases
      Organize downloads
      Standalone EXE
      Match subtitles
    Audience
      Anime fans

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Rename a folder of downloaded anime episodes into a consistent Title - SxxExx - Group naming scheme.

USE CASE 2

Clean up subtitle file names so they match their corresponding video files.

USE CASE 3

Package the script as a standalone executable to use on a computer without Python installed.

What is it built with?

PythonPyInstaller

How does it compare?

daisysg297/bangumi-rename-for-emby2arons/llm-cliabe238/claude-video-plus
Stars111111
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity1/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Only needs Python 3.7+, no third-party packages required unless you package it as an EXE.

In plain English

This is a small Python tool that batch renames anime video and subtitle files so they follow one consistent naming pattern instead of whatever format they originally came in. Anime files downloaded from different sources use different naming styles, with brackets, dashes, or embedded release group names in different places, and this script recognizes the common variations and rewrites them all into a single format: title, then season and episode number, then the release group name. The tool scans the folder you point it at and automatically walks through every subfolder inside it too, so your files do not need to already be sorted into one place. Before it renames anything, it shows you a full preview of every planned change so you can check it and confirm before the actual renaming happens, which helps avoid mistakes. If a rename would overwrite an existing file with the same name, the script skips that file instead of replacing it. Subtitle files are renamed alongside their matching video files so the two stay in sync. The script depends only on Python's built in standard library, so there is nothing extra to install to run it directly. If you want to use it on a computer without Python installed, it can also be packaged into a single standalone executable file using PyInstaller. Season and episode numbers are automatically padded to two digits in the output, and details like resolution, video codec, audio track, or language tags are dropped from the new filename, while the original file extension is kept. It supports common video formats such as mp4, mkv, avi, mov, flv, wmv, rmvb, and m4v, along with subtitle formats like srt, ass, ssa, vtt, and mks, and these lists can be extended by editing a setting near the top of the script. To run it you need Python 3.7 or newer. The README recommends backing up important files first and checking the preview carefully, and notes that the script only changes filenames, never file contents or their location, and it automatically skips temporary download files.

Copy-paste prompts

Prompt 1
Help me run this bangumi rename script on my anime folder and preview the changes first.
Prompt 2
Show me how to package this script into a standalone EXE using PyInstaller.
Prompt 3
Explain how this script detects season and episode numbers from different anime file naming styles.

Frequently asked questions

What is bangumi-rename-for-emby?

A Python script that batch renames anime video and subtitle files into one consistent Title - SxxExx - Group format, with a preview step before any changes are made.

What language is bangumi-rename-for-emby written in?

Mainly Python. The stack also includes Python, PyInstaller.

How hard is bangumi-rename-for-emby to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is bangumi-rename-for-emby for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.