Медиатека

Плейлисты для тренировки по BPM

Делит треки на разминку, кардио и пик по тегу BPM и сохраняет три M3U.

Python Windows macOS Linux Новичок
Скачать workout_playlists.py
Описание

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

Скрипт читает тег bpm через mutagen, распределяет композиции по диапазонам темпа и формирует отдельные плейлисты. Треки без BPM пропускаются и учитываются в отчёте. Без --apply показываются только количества, исходная музыка не меняется.

Запуск

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

python workout_playlists.py --dir ~/Music --out ./workout

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

Примеры

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

  • python workout_playlists.py --dir ~/Music --out ./workout
  • python workout_playlists.py --dir ~/Music --out ./workout --apply
  • python workout_playlists.py --dir D:\Music --out D:\Workout --apply --force
Зависимости

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

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
Исходник

workout_playlists.py

#!/usr/bin/env python3
"""Собирает плейлисты для тренировки по тегу BPM."""
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"}
BPM_IN_NAME = re.compile(r"(?i)(\d{2,3})\s*bpm")
RANGES = [
    ("warmup", 90, 120),
    ("cardio", 120, 150),
    ("peak", 150, 180),
]


def read_bpm(path: Path) -> int | None:
    try:
        audio = MutagenFile(path, easy=True)
    except Exception:
        audio = None
    if audio is not None and audio.tags:
        raw = audio.tags.get("bpm")
        if isinstance(raw, list):
            raw = raw[0] if raw else None
        if raw is not None:
            match = re.search(r"\d{2,3}", str(raw))
            if match:
                return int(match.group(0))
    match = BPM_IN_NAME.search(path.stem)
    if match:
        return int(match.group(1))
    return None


def main() -> int:
    parser = argparse.ArgumentParser(description="Плейлисты по BPM")
    parser.add_argument("--dir", type=Path, required=True, help="Папка с музыкой")
    parser.add_argument("--out", type=Path, default=Path("workout"), help="Папка для M3U")
    parser.add_argument("--apply", action="store_true", help="Записать плейлисты")
    parser.add_argument("--force", action="store_true", help="Перезаписать M3U")
    args = parser.parse_args()

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

    buckets: dict[str, list[tuple[Path, int]]] = {name: [] for name, _, _ in RANGES}
    without = 0
    outside = 0
    for path in sorted(root.rglob("*")):
        if not path.is_file() or path.suffix.lower() not in AUDIO_EXTENSIONS:
            continue
        bpm = read_bpm(path)
        if bpm is None:
            without += 1
            continue
        matched = False
        for name, low, high in RANGES:
            if name == "peak" and low <= bpm <= high:
                buckets[name].append((path, bpm))
                matched = True
                break
            if name != "peak" and low <= bpm < high:
                buckets[name].append((path, bpm))
                matched = True
                break
        if not matched:
            outside += 1

    for name, low, high in RANGES:
        print(f"{name}: {len(buckets[name])} треков ({low}-{high} BPM)")
    print(f"Без BPM: {without}, вне диапазонов: {outside}")

    if not args.apply:
        print("Это предпросмотр. Для записи добавьте --apply.")
        return 0

    output.mkdir(parents=True, exist_ok=True)
    for name, _, _ in RANGES:
        target = output / f"workout-{name}.m3u"
        if target.exists() and not args.force:
            print(f"Пропуск, файл существует: {target}")
            continue
        lines = ["#EXTM3U"]
        for path, bpm in buckets[name]:
            lines.append(f"#EXTINF:-1,{path.stem} [{bpm} BPM]")
            lines.append(str(path))
        target.write_text("\n".join(lines) + "\n", encoding="utf-8")
        print(f"Сохранено: {target}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Медиатека

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