Медиатека

Собрать M3U-плейлист из папки

Рекурсивно собирает медиафайлы в M3U с относительными путями и понятными названиями треков.

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

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

Скрипт обходит указанную папку, отбирает файлы по расширениям и формирует расширенный M3U с блоком EXTINF. Пути по умолчанию относительные, поэтому плейлист можно переносить вместе с музыкой. Без --output список печатается на экран, существующий файл не перезаписывается без --force.

Запуск

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

python media_m3u.py --dir ~/Music --output collection.m3u

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

Примеры

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

  • python media_m3u.py --dir ~/Music
  • python media_m3u.py --dir ~/Music --output collection.m3u
  • python media_m3u.py --dir D:\Media --ext .mp4 .mkv --absolute --output video.m3u
Зависимости

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

Python 3.10+ Интерпретатор и стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

media_m3u.py

#!/usr/bin/env python3
"""Собирает M3U-плейлист из медиафайлов папки."""
from __future__ import annotations

import argparse
import os
from pathlib import Path

MEDIA_EXTENSIONS = {
    ".mp3", ".flac", ".m4a", ".aac", ".ogg", ".opus", ".wav",
    ".mp4", ".mkv", ".avi", ".mov", ".webm",
}


def collect(root: Path, extensions: set[str]) -> list[Path]:
    files = []
    for path in root.rglob("*"):
        if path.is_file() and path.suffix.lower() in extensions:
            files.append(path)
    return sorted(files, key=lambda item: str(item).lower())


def make_line(path: Path, base: Path, absolute: bool) -> str:
    target = path if absolute else path.relative_to(base)
    return str(target).replace(os.sep, "/")


def main() -> int:
    parser = argparse.ArgumentParser(description="Создать M3U-плейлист")
    parser.add_argument("--dir", type=Path, required=True, help="Папка с медиафайлами")
    parser.add_argument("--output", type=Path, help="Файл .m3u; без него список печатается")
    parser.add_argument("--ext", nargs="+", help="Расширения, например .mp3 .flac")
    parser.add_argument("--absolute", action="store_true", help="Писать абсолютные пути")
    parser.add_argument("--force", action="store_true", help="Перезаписать существующий файл")
    args = parser.parse_args()

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

    extensions = {
        item.lower() if item.startswith(".") else "." + item.lower()
        for item in (args.ext or MEDIA_EXTENSIONS)
    }
    files = collect(root, extensions)
    if not files:
        print("Медиафайлы не найдены.")
        return 1

    lines = ["#EXTM3U"]
    for path in files:
        lines.append(f"#EXTINF:-1,{path.stem}")
        lines.append(make_line(path, root, args.absolute))
    text = "\n".join(lines) + "\n"

    if not args.output:
        print(text, end="")
        return 0

    output = args.output.expanduser()
    if output.exists() and not args.force:
        parser.error(f"Файл уже существует: {output}. Добавьте --force.")
    output.parent.mkdir(parents=True, exist_ok=True)
    output.write_text(text, encoding="utf-8")
    print(f"Записано файлов: {len(files)}")
    print(f"Плейлист: {output}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Медиатека

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