Видео

Заменить звук в видео

Подставляет внешнюю аудиодорожку, сохраняя видеопоток без перекодирования.

Python Windows macOS Linux Средний
Скачать replace_audio.py
Описание

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

Скрипт берёт видео и отдельный аудиофайл, копирует видеопоток и кодирует новую дорожку в AAC. Можно задать сдвиг звука в секундах, если запись начинается позже картинки. Результат по умолчанию обрезается по короткой дорожке.

Запуск

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

python replace_audio.py video.mp4 voice.wav --output result.mp4

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

Примеры

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

  • python replace_audio.py video.mp4 voice.wav --output result.mp4
  • python replace_audio.py clip.mov music.mp3 --offset 0.5
  • python replace_audio.py film.mkv dub.m4a --output dubbed.mkv
Зависимости

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

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

replace_audio.py

#!/usr/bin/env python3
"""Замена звуковой дорожки в видео."""
from __future__ import annotations

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


def stream_types(path: Path) -> set[str]:
    result = subprocess.run(
        [
            "ffprobe", "-v", "error", "-show_entries", "stream=codec_type",
            "-of", "json", str(path),
        ],
        capture_output=True,
        text=True,
        check=False,
    )
    if result.returncode != 0:
        raise SystemExit(f"ffprobe не смог прочитать {path}:\n{result.stderr.strip()}")
    return {
        item.get("codec_type", "")
        for item in json.loads(result.stdout).get("streams", [])
    }


def main() -> int:
    parser = argparse.ArgumentParser(description="Заменить звук в видео")
    parser.add_argument("video", type=Path)
    parser.add_argument("audio", type=Path)
    parser.add_argument("--output", "-o", type=Path)
    parser.add_argument("--offset", type=float, default=0.0, help="Сдвиг звука в секундах")
    parser.add_argument("--overwrite", action="store_true")
    args = parser.parse_args()

    if shutil.which("ffmpeg") is None:
        raise SystemExit("Не найден ffmpeg. Установите FFmpeg.")
    video = args.video.expanduser()
    audio = args.audio.expanduser()
    if not video.is_file():
        parser.error(f"Видео не найдено: {video}")
    if not audio.is_file():
        parser.error(f"Аудио не найдено: {audio}")
    if "video" not in stream_types(video):
        raise SystemExit("В первом файле нет видеопотока")
    if "audio" not in stream_types(audio):
        raise SystemExit("Во втором файле нет звуковой дорожки")

    target = args.output.expanduser() if args.output else Path("replaced") / f"{video.stem}_newaudio.mp4"
    if target.resolve() == video.resolve() or target.resolve() == audio.resolve():
        raise SystemExit("Результат не должен совпадать с исходным файлом")
    if target.exists() and not args.overwrite:
        raise SystemExit(f"Файл уже существует: {target}. Добавьте --overwrite.")
    target.parent.mkdir(parents=True, exist_ok=True)

    codec = ["-c:a", "libopus", "-b:a", "160k"] if target.suffix.lower() == ".webm" else ["-c:a", "aac", "-b:a", "192k"]
    command = ["ffmpeg", "-hide_banner", "-nostdin", "-i", str(video)]
    if args.offset:
        command += ["-itsoffset", f"{args.offset:.3f}"]
    command += [
        "-i", str(audio), "-map", "0:v:0", "-map", "1:a:0",
        "-c:v", "copy", *codec, "-shortest",
        "-y" if args.overwrite else "-n", str(target),
    ]
    print(f"Замена звука, сдвиг {args.offset:.3f} с")
    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-replace-audio
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

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

Категория

Видео

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