autotitle mydehq

Features

• 🎯 Automatic Episode Renaming - Pattern-based filename matching and generation
• 🎨 Flexible Pattern Matching - Support for multiple filename formats with {{TEMPLATE}} variables
• 🔖 Filler Detection - Automatically marks filler episodes with [F] tag
• 📚 Episode Database - Caches episode data from MyAnimeList and AnimeFillerList
• 🧠 Smart Updates - Auto-updates database when new episodes air
• 💾 Smart Backups - Automatic backup before renaming with restore capability
• 🏷️ Metadata Tagging - Embeds episode/series info into .mkv (mkvpropedit) and .mp4/.m4v (atomicparsley) files
• 📦 Library & CLI - Use as standalone tool or import as Go package

Installation

CLI Tool

# From my-repo (Arch Linux)
curl -sL https://mydehq.github.io/my-repo/install | bash
sudo pacman -S autotitle

# Or from AUR
paru -S autotitle

# In Windows, from winget
winget install mydehq.autotitle

# Or build manually
git clone https://github.com/mydehq/autotitle.git && cd autotitle
mise install-bin

As Library

go get github.com/mydehq/autotitle

Quick Start

cd /path/to/anime/videos

# Initialize with URLs directly
autotitle init . -u "https://myanimelist.net/anime/XXXXX"

# Or create template config to edit manually
autotitle init .

# Edit _autotitle.yml, preview & add changes

# Perform rename
autotitle .

# Tag already-renamed files without re-renaming
autotitle tag .

# Rename without tagging
autotitle --no-tag .

# Restore if needed
autotitle undo .

Basic Configuration

Running autotitle init creates _autotitle.yml:

targets:
  - path: "."
    url: "https://myanimelist.net/anime/XXXXX/Series_Name"
    filler_url: "https://www.animefillerlist.com/shows/series-name"
    patterns:
      - input:
          - "Episode {{EP_NUM}} {{RES}}"
        output:
          fields: [SERIES, EP_NUM, FILLER, EP_NAME]
          offset: 0 # Optional: Offset local episode numbers (e.g. 1 -> 11)

Documentation

📚 Full Documentation — Complete guides, commands, flags, configuration reference, and library API

Data Sources

Currently Below Data sources are implemented:

Episode Data

Source	Type
MyAnimeList	Anime

Filler Info

Source	Type
AnimeFillerList	Anime