Видео

Наложить водяной знак на видео

Добавляет логотип в выбранный угол с настройкой прозрачности и размера.

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

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

Скрипт накладывает 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 br
  • python watermark_video.py demo.mov logo.png --opacity 0.35 --width 180
  • python watermark_video.py lesson.mkv logo.png --position tl --margin 32
Зависимости

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

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

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())

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

CLI 1.0.0

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

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

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

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

Категория

Видео

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