Медиатека

Переименовать аудио по тегам

Строит имена из исполнителя, альбома и названия, показывает план и переименовывает только с --apply.

Python Windows macOS Linux Средний
Скачать rename_by_tags.py
Описание

Что делает скрипт

Скрипт читает теги mutagen, подставляет их в шаблон и очищает недопустимые символы. Конфликты имён и файлы без обязательных тегов попадают в отчёт и не меняются. По умолчанию выполняется только предпросмотр, оригиналы остаются на месте.

Перед запуском
  • Переименование меняет пути к файлам. Сначала проверьте предпросмотр.
Запуск

Быстрый старт

python rename_by_tags.py --dir ~/Music --pattern "{artist} - {title}"

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python rename_by_tags.py --dir ~/Music
  • python rename_by_tags.py --dir ~/Music --pattern "{track} - {artist} - {title}" --apply
  • python rename_by_tags.py --dir ./album --pattern "{track} - {artist} - {title}" --apply
Зависимости

Что понадобится

Python 3.10+ Интерпретатор и стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
mutagen Чтение и запись тегов аудио
Windows py -m pip install mutagen
macOS python3 -m pip install mutagen
Linux python3 -m pip install mutagen
Исходник

rename_by_tags.py

#!/usr/bin/env python3
"""Переименовывает аудиофайлы по тегам."""
from __future__ import annotations

import argparse
import re
from pathlib import Path

from mutagen import File as MutagenFile

AUDIO_EXTENSIONS = {".mp3", ".flac", ".m4a", ".ogg", ".opus", ".wav"}
INVALID = re.compile(r'[<>:"/\\|?*\x00-\x1f]')


def clean(value: str) -> str:
    value = INVALID.sub("_", value)
    value = re.sub(r"\s+", " ", value).strip(" .")
    return value


def tag_value(tags, key: str) -> str:
    raw = tags.get(key)
    if isinstance(raw, list):
        raw = raw[0] if raw else ""
    if raw is None:
        return ""
    return str(raw).strip()


def main() -> int:
    parser = argparse.ArgumentParser(description="Переименовать аудио по тегам")
    parser.add_argument("--dir", type=Path, required=True, help="Папка с музыкой")
    parser.add_argument("--pattern", default="{artist} - {title}", help="Шаблон имени без расширения")
    parser.add_argument("--apply", action="store_true", help="Выполнить переименование")
    args = parser.parse_args()

    root = args.dir.expanduser().resolve()
    if not root.is_dir():
        parser.error(f"Папка не найдена: {root}")

    planned = 0
    skipped = 0
    for path in sorted(root.rglob("*")):
        if not path.is_file() or path.suffix.lower() not in AUDIO_EXTENSIONS:
            continue
        try:
            audio = MutagenFile(path, easy=True)
        except Exception as error:
            print(f"Теги не прочитаны: {path}: {error}")
            skipped += 1
            continue
        if audio is None or not audio.tags:
            print(f"Нет тегов: {path}")
            skipped += 1
            continue

        tags = audio.tags
        artist = tag_value(tags, "artist")
        title = tag_value(tags, "title")
        if not artist or not title:
            print(f"Нет исполнителя или названия: {path}")
            skipped += 1
            continue

        track = tag_value(tags, "track").split("/")[0]
        if track.isdigit():
            track = track.zfill(2)
        values = {
            "artist": clean(artist),
            "title": clean(title),
            "album": clean(tag_value(tags, "album")),
            "track": clean(track),
            "year": clean(tag_value(tags, "date")[:4]),
        }
        try:
            new_name = args.pattern.format(**values)
        except KeyError as error:
            parser.error(f"Неизвестное поле шаблона: {error}")
        new_name = clean(new_name)
        if not new_name:
            print(f"Пустое имя после очистки: {path}")
            skipped += 1
            continue

        target = path.with_name(new_name + path.suffix)
        if target == path:
            continue
        if target.exists():
            print(f"Конфликт, пропуск: {target}")
            skipped += 1
            continue

        if args.apply:
            path.rename(target)
            print(f"Переименовано: {target.name}")
        else:
            print(f"Будет: {path.name} -> {target.name}")
        planned += 1

    mode = "переименовано" if args.apply else "запланировано"
    print(f"Итого {mode}: {planned}, пропущено: {skipped}")
    if not args.apply:
        print("Это предпросмотр. Для применения добавьте --apply.")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get media-rename-by-tags
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Медиатека

Плейлисты, метаданные, обложки, субтитры и порядок в коллекциях.