Переименовать аудио по тегам
Строит имена из исполнителя, альбома и названия, показывает план и переименовывает только с --apply.
Что делает скрипт
Скрипт читает теги mutagen, подставляет их в шаблон и очищает недопустимые символы. Конфликты имён и файлы без обязательных тегов попадают в отчёт и не меняются. По умолчанию выполняется только предпросмотр, оригиналы остаются на месте.
- Переименование меняет пути к файлам. Сначала проверьте предпросмотр.
Быстрый старт
python rename_by_tags.py --dir ~/Music --pattern "{artist} - {title}"
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python rename_by_tags.py --dir ~/Musicpython rename_by_tags.py --dir ~/Music --pattern "{track} - {artist} - {title}" --applypython rename_by_tags.py --dir ./album --pattern "{track} - {artist} - {title}" --apply
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install mutagen
python3 -m pip install mutagen
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.