Заменить звук в видео
Подставляет внешнюю аудиодорожку, сохраняя видеопоток без перекодирования.
Что делает скрипт
Скрипт берёт видео и отдельный аудиофайл, копирует видеопоток и кодирует новую дорожку в 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.mp4python replace_audio.py clip.mov music.mp3 --offset 0.5python replace_audio.py film.mkv dub.m4a --output dubbed.mkv
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
winget install Gyan.FFmpeg
brew install ffmpeg
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.