Наложить водяной знак на видео
Добавляет логотип в выбранный угол с настройкой прозрачности и размера.
Что делает скрипт
Скрипт накладывает PNG или JPEG поверх картинки через фильтр overlay. Положение, отступ, ширина и прозрачность задаются аргументами. Видео перекодируется, потому что водяной знак впечатывается в кадры, оригинал остаётся нетронутым.
- Водяной знак становится частью кадров, убрать его без повторной обработки нельзя.
Быстрый старт
python watermark_video.py clip.mp4 logo.png --position br
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python watermark_video.py clip.mp4 logo.png --position brpython watermark_video.py demo.mov logo.png --opacity 0.35 --width 180python watermark_video.py lesson.mkv logo.png --position tl --margin 32
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
winget install Gyan.FFmpeg
brew install ffmpeg
sudo apt install ffmpeg
watermark_video.py
#!/usr/bin/env python3
"""Наложение графического водяного знака."""
from __future__ import annotations
import argparse
import shutil
import subprocess
from pathlib import Path
def main() -> int:
parser = argparse.ArgumentParser(description="Наложить водяной знак на видео")
parser.add_argument("video", type=Path)
parser.add_argument("image", type=Path)
parser.add_argument("--output", "-o", type=Path)
parser.add_argument("--position", choices=("tl", "tr", "bl", "br", "center"), default="br")
parser.add_argument("--opacity", type=float, default=0.6)
parser.add_argument("--width", type=int, help="Ширина логотипа в пикселях")
parser.add_argument("--margin", 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.")
video = args.video.expanduser()
image = args.image.expanduser()
if not video.is_file():
parser.error(f"Видео не найдено: {video}")
if not image.is_file():
parser.error(f"Изображение не найдено: {image}")
if not 0.0 <= args.opacity <= 1.0:
parser.error("Прозрачность должна быть от 0 до 1")
if args.width is not None and args.width < 8:
parser.error("Ширина логотипа должна быть не меньше 8 пикселей")
if args.margin < 0:
parser.error("Отступ не может быть отрицательным")
target = args.output.expanduser() if args.output else Path("watermarked") / f"{video.stem}_wm.mp4"
if target.resolve() == video.resolve():
raise SystemExit("Результат не должен совпадать с исходным видео")
if target.exists() and not args.overwrite:
raise SystemExit(f"Файл уже существует: {target}. Добавьте --overwrite.")
target.parent.mkdir(parents=True, exist_ok=True)
positions = {
"tl": f"{args.margin}:{args.margin}",
"tr": f"W-w-{args.margin}:{args.margin}",
"bl": f"{args.margin}:H-h-{args.margin}",
"br": f"W-w-{args.margin}:H-h-{args.margin}",
"center": "(W-w)/2:(H-h)/2",
}
logo_filter = f"[1:v]format=rgba,colorchannelmixer=aa={args.opacity:.3f}"
if args.width:
logo_filter += f",scale={args.width}:-1"
filter_complex = f"{logo_filter}[wm];[0:v][wm]overlay={positions[args.position]}[v]"
command = [
"ffmpeg", "-hide_banner", "-nostdin",
"-i", str(video), "-loop", "1", "-i", str(image),
"-filter_complex", filter_complex,
"-map", "[v]", "-map", "0:a?", "-shortest",
"-c:v", "libx264", "-preset", "medium", "-crf", "20",
"-pix_fmt", "yuv420p", "-c:a", "aac", "-b:a", "192k",
"-movflags", "+faststart", "-y" if args.overwrite else "-n", str(target),
]
print(f"Позиция: {args.position}, прозрачность: {args.opacity}")
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.