#!/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())