Видео

Точно обрезать видео по времени

Вырезает фрагмент с заданным началом и длительностью с полным перекодированием.

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

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

Скрипт проверяет длительность исходника, принимает время в секундах или формате ЧЧ:ММ:СС и вырезает ровно указанный участок. Перекодирование даёт точку старта по кадру, а не по ключевому кадру. Результат пишется в отдельную папку.

Запуск

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

python trim_video.py clip.mp4 --start 00:00:30 --duration 45

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

Примеры

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

  • python trim_video.py clip.mp4 --start 00:00:30 --duration 45
  • python trim_video.py talk.mkv --start 90 --end 150
  • python trim_video.py demo.mov --start 00:01:00 --duration 20 --crf 18
Зависимости

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

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
FFmpeg 6+ ffmpeg и ffprobe
Windows winget install Gyan.FFmpeg
macOS brew install ffmpeg
Linux sudo apt install ffmpeg
Исходник

trim_video.py

#!/usr/bin/env python3
"""Точная обрезка видео по времени."""
from __future__ import annotations

import argparse
import json
import shutil
import subprocess
from pathlib import Path


def parse_time(value: str) -> float:
    try:
        parts = value.split(":")
        if len(parts) == 1:
            seconds = float(parts[0])
        elif len(parts) == 2:
            seconds = int(parts[0]) * 60 + float(parts[1])
        elif len(parts) == 3:
            seconds = int(parts[0]) * 3600 + int(parts[1]) * 60 + float(parts[2])
        else:
            raise ValueError
    except ValueError as error:
        raise argparse.ArgumentTypeError(f"Неверное время: {value}") from error
    if seconds < 0:
        raise argparse.ArgumentTypeError("Время не может быть отрицательным")
    return seconds


def duration_of(path: Path) -> float:
    result = subprocess.run(
        [
            "ffprobe", "-v", "error", "-show_entries", "format=duration",
            "-of", "default=noprint_wrappers=1:nokey=1", str(path),
        ],
        capture_output=True,
        text=True,
        check=False,
    )
    if result.returncode != 0:
        raise SystemExit(f"ffprobe не смог прочитать {path}:\n{result.stderr.strip()}")
    return float(result.stdout.strip())


def main() -> int:
    parser = argparse.ArgumentParser(description="Точно обрезать видео")
    parser.add_argument("input", type=Path)
    parser.add_argument("--start", type=parse_time, required=True)
    span = parser.add_mutually_exclusive_group(required=True)
    span.add_argument("--duration", type=parse_time)
    span.add_argument("--end", type=parse_time)
    parser.add_argument("--output-dir", type=Path, default=Path("trimmed"))
    parser.add_argument("--crf", type=int, default=20)
    parser.add_argument("--overwrite", action="store_true")
    args = parser.parse_args()

    if shutil.which("ffmpeg") is None:
        raise SystemExit("Не найден ffmpeg. Установите FFmpeg.")
    source = args.input.expanduser()
    if not source.is_file():
        parser.error(f"Файл не найден: {source}")

    total = duration_of(source)
    start = args.start
    if start >= total:
        parser.error(f"Начало {start:.1f} с за пределами ролика ({total:.1f} с)")
    duration = args.duration if args.duration is not None else args.end - start
    if duration <= 0:
        parser.error("Длительность должна быть больше нуля")
    if start + duration > total:
        print(f"Конец выходит за границу, фрагмент будет короче: {total - start:.1f} с")
        duration = total - start

    args.output_dir.mkdir(parents=True, exist_ok=True)
    label = f"{int(start)}s_{int(duration)}s"
    target = args.output_dir / f"{source.stem}_{label}.mp4"
    if target.exists() and not args.overwrite:
        raise SystemExit(f"Файл уже существует: {target}. Добавьте --overwrite.")

    command = [
        "ffmpeg", "-hide_banner", "-nostdin",
        "-ss", f"{start:.3f}", "-i", str(source), "-t", f"{duration:.3f}",
        "-map", "0:v:0", "-map", "0:a?",
        "-c:v", "libx264", "-preset", "medium", "-crf", str(args.crf),
        "-pix_fmt", "yuv420p", "-c:a", "aac", "-b:a", "192k",
        "-movflags", "+faststart", "-n", str(target),
    ]
    print(f"Фрагмент: {start:.2f} - {start + duration:.2f} с")
    result = subprocess.run(command, check=False)
    if result.returncode != 0:
        raise SystemExit(f"ffmpeg завершился с кодом {result.returncode}")
    print(f"Готово: {target}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Видео

Монтаж, сжатие, субтитры, кадры и пакетная обработка видео.